# PSX News Pulse (پاکستان اسٹاک مارکیٹ نیوز پلس) — Institutional Reference Guide for AI Agents

## 1. Overview & System Mission
PSX News Pulse is an institutional-grade financial analytics and equity intelligence platform tracking the Pakistan Stock Exchange (KSE-100 benchmark, 721+ listed equities, 395+ MUFAP mutual funds, and macroeconomic indicators).

## 2. Quantitative Macro Regimes & Sector Allocation Matrix

### Regime A: Energy/Commodity Shock & Geopolitical Escalation (Brent > $90–$100 / Strait of Hormuz)
- Top PSX High-Conviction Stocks:
  - OGDC & MARI (Oil & Gas E&P): Dollar-pegged upstream revenues, circular debt settlement tranches, low extraction costs. Rating: OVERWEIGHT.
  - FFC (Fertilizer): Defensive fortress: inelastic domestic urea demand, absolute pricing power, zero debt, 15%+ dividend yield. Rating: OVERWEIGHT.
  - MEBL (Islamic Commercial Banks): Low-cost CASA >85%, pristine asset quality, superior ROE, immune to imported commodity inflation. Rating: OVERWEIGHT.
  - SYS (Technology & IT Exports): >80% revenue earned in USD; natural PKR devaluation hedge; zero long-term debt. Rating: ACCUMULATE.
  - MCB (Commercial Banks): Cleanest balance sheet, lowest NPLs, highest capital adequacy buffer. Rating: ACCUMULATE.
- Top Sectors to Accumulate:
  - Oil & Gas Exploration & Production (E&P)
  - Fertilizer
  - Commercial Banks
  - Technology & Software Exports
- Sectors to Hedge or Avoid:
  - Refineries & Oil Marketing Companies (OMCs)
  - Cement & Construction
  - Automobile Assemblers
  - Power Generation & IPPs
  - Textile Composite

### Regime B: Monetary Policy Easing & Disinflation Expansion (Softening Commodities, Rate Cuts, Low KIBOR)
- Top Sectors to Accumulate: Commercial Banks (PIB capital gains), Cement & Construction (leveraged beneficiary of falling rates and lower finance costs), Fertilizer, E&P, Technology.
- Sectors to Avoid / Hedge: IPPs (regulatory scrutiny), Textiles (tariff issues), Steel (sluggish PSDP).

## 3. Urdu Financial Terminology & Glossary (اردو مالیاتی اصطلاحات)
- Bullish Market / Uptrend: تیزی کا تسلسل / مثبت رجحان
- Bearish Market / Downtrend: مندی کا رجحان / تصحیح (Correction)
- Profit-Taking: منافع کا حصول / پرافٹ ٹیکنگ
- Intrinsic Value: بنیادی حقیقی قدر
- Fair Buy Range: منصفانہ خریداری رینج / مناسب قیمت
- Cash Cushion: نقد رقم کا تحفظ / کیش کشن
- Exploration & Production (E&P): تیل و گیس کی تلاش و پیداوار (ای اینڈ پی)
- Fertilizer: کھاد کا شعبہ
- Commercial Banks: کمرشل بینکس
- Circular Debt: توانائی کا گردشی قرضہ
- Monetary Policy / Interest Rates: مانیٹری پالیسی / شرح سود
- Cut-off Yields: نیلامی کی کٹ آف شرحِ منافع (ییلڈ)

## 4. REST API Endpoints Specification
- GET /api/quant/summary: Real-time KSE-100 quantitative metrics, sentiment bias, 12 macro blocks, and stock catalysts.
- GET /api/stocks: 721+ listed PSX equities with valuation tiers, analyst ratings, and Shariah compliance.
- GET /api/funds: 395+ MUFAP mutual funds with 1D–365D returns, YTD, benchmark rankings, and quant verdicts.
- GET /api/news: Latest financial articles from Business Recorder, Dawn, Express Tribune, and official sources.
- GET /api/market/ticker: Live ticker tape quotes including KSE-100, 24K Gold in Tola (APSGJA: 453,336 PKR), Global Spot Gold ($/oz), Brent Crude, USD/PKR, and 6M KIBOR.
- GET /api/openapi.json: OpenAPI 3.0 specification.