{
  "name": "mtf.trading public API",
  "version": "v1",
  "description": "Read-only JSON over NSE + BSE Margin Trading Facility data. Money is in ₹ lakh unless a *_crore / *_lakh_crore field says otherwise.",
  "asOf": "2026-11-12",
  "endpoints": {
    "/api/v1/summary": "Headline MTF book · combined, NSE and BSE, with human strings.",
    "/api/v1/brokers": "Top brokers by latest disclosed MTF book (share of the disclosed book).",
    "/api/v1/global": "Stock margin debt by country in ₹ lakh crore (India vs the world).",
    "/api/v1/bhavcopy": "Raw daily equity bhavcopy (all columns) for NSE + BSE + MSE · filter by date, exchange, symbol, series; JSON or CSV.",
    "/api/v1/pr": "NSE's daily PR (Price/Reports) archive · 14 member files (52-week highs/lows, gainers/losers, market caps, board meetings, announcements, corporate actions, price data); pass date + file; JSON, CSV or raw.",
    "/api/v1/mcx": "MCX daily bhavcopy · commodity & index futures and options (FUTCOM/OPTFUT/FUTIDX/OPTIDX); filter by date, symbol, instrument, option type; JSON or CSV.",
    "/api/v1/export": "Bulk historical exports · daily totals, flow, flushes, turnover, broker history, stock universe, surveillance, pledge · as JSON or CSV. Gzipped bundles at /exports/, or everything as one zip.",
    "/api/v1/events": "MTF alert events · book milestones, record highs, margin flushes, funded-stock surveillance entries, pledge-and-book build-ups, broker records. Subscribe the Atom feed at /events.xml."
  },
  "feeds": {
    "/feed.xml": "Atom · the daily MTF book (combined, with record-high and flush notes).",
    "/events.xml": "Atom · threshold alerts; subscribe in a reader or via Zapier/IFTTT/Make for webhooks."
  },
  "badges": {
    "/badge/mtf-book.svg": "Embeddable SVG · combined MTF book.",
    "/badge/mtf-nse.svg": "Embeddable SVG · NSE MTF book.",
    "/badge/mtf-bse.svg": "Embeddable SVG · BSE MTF book."
  },
  "docs": "https://mtf.trading/data",
  "terms": "Free for any use with attribution to mtf.trading. Data is sourced from NSE/BSE official archives; provided as-is, no warranty.",
  "updated": "2026-11-15T11:23:14.678401+00:00"
}