{
  "openapi": "3.0.3",
  "info": {
    "title": "PSX News Pulse REST API",
    "description": "Machine-readable API for Pakistan Stock Exchange (PSX) Equity Analytics, MUFAP Mutual Funds, Macroeconomic Indicators, and Real-Time Financial Feeds.",
    "version": "2.4.0",
    "contact": {
      "name": "PSX News Pulse Financial Intelligence Desk",
      "url": "https://psxnews.online"
    }
  },
  "servers": [
    {
      "url": "https://psxnews.online",
      "description": "Production Server"
    },
    {
      "url": "http://localhost:5000",
      "description": "Local Development Server"
    }
  ],
  "paths": {
    "/api/quant/summary": {
      "get": {
        "summary": "Get KSE-100 Quantitative Intelligence & 12 Macro Blocks",
        "responses": {
          "200": {
            "description": "Successful quantitative market analysis payload"
          }
        }
      }
    },
    "/api/stocks": {
      "get": {
        "summary": "Get 721+ PSX Listed Equities with Valuations & Shariah Status",
        "responses": {
          "200": {
            "description": "List of all 721+ PSX equities with fundamental ratios"
          }
        }
      }
    },
    "/api/funds": {
      "get": {
        "summary": "Get 395+ MUFAP Mutual Funds Intelligence & Multi-Period Returns",
        "responses": {
          "200": {
            "description": "Mutual fund database across 23 MUFAP categories"
          }
        }
      }
    },
    "/api/news": {
      "get": {
        "summary": "Get Financial News Articles & Scraped Feeds",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter by date (YYYY-MM-DD)"
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "en",
                "ur"
              ]
            },
            "description": "Language (English or Urdu)"
          }
        ],
        "responses": {
          "200": {
            "description": "Array of financial news articles"
          }
        }
      }
    },
    "/api/market/ticker": {
      "get": {
        "summary": "Get Live Ticker Tape Commodities, KSE-100, and Blue Chips",
        "responses": {
          "200": {
            "description": "Live ticker tape payload"
          }
        }
      }
    },
    "/api/stats": {
      "get": {
        "summary": "Get Platform Article, Feed, and Sentiment Statistics",
        "responses": {
          "200": {
            "description": "Real-time statistics breakdown"
          }
        }
      }
    }
  }
}