{
  "name": "mtf.trading MCX (Multi Commodity Exchange) bhavcopy API",
  "endpoint": "/api/v1/mcx",
  "description": "MCX's daily bhavcopy · commodity & index FUTURES and OPTIONS (FUTCOM/OPTFUT/FUTIDX/OPTIDX) exposed per trading day, JSON or CSV. 100% static, pre-deployed.",
  "params": {
    "date": "YYYY-MM-DD (or YYYYMMDD). Required to return rows.",
    "symbol": "filter by Symbol (exact, case-insensitive), e.g. GOLD, CRUDEOIL",
    "instr": "filter by InstrumentName (FUTCOM | OPTFUT | FUTIDX | OPTIDX)",
    "option": "filter by OptionType (CE | PE)",
    "expiry": "filter by ExpiryDate (exact, e.g. 30SEP2026)",
    "fields": "comma-separated column subset",
    "format": "json (default) | csv",
    "limit": "default 500, max 100000",
    "offset": "row offset for paging"
  },
  "coverage": {
    "first": "2022-01-03",
    "last": "2026-09-22",
    "trading_days": 1213
  },
  "last_updated": "2026-09-23",
  "capture_note": "MCX is behind Akamai bot protection, so this data is captured via a local browser (not the CI pipeline). It refreshes when that local capture runs · check `last_updated` for the most recent captured day. Commodity data is a different asset class from the equity /api/v1/bhavcopy.",
  "columns": [
    "Date",
    "Symbol",
    "InstrumentName",
    "ExpiryDate",
    "OptionType",
    "StrikePrice",
    "Open",
    "High",
    "Low",
    "Close",
    "PreviousClose",
    "Volume",
    "Value",
    "OpenInterest"
  ],
  "columns_glossary": {
    "Date": "Trading session date (YYYY-MM-DD).",
    "Symbol": "Commodity / index symbol (e.g. GOLD, SILVER, CRUDEOIL, ALUMINI, NATURALGAS).",
    "InstrumentName": "Instrument type · FUTCOM (commodity future), OPTFUT (option on a commodity future), FUTIDX (index future), OPTIDX (index option).",
    "ExpiryDate": "Contract expiry (e.g. 30SEP2026).",
    "OptionType": "CE / PE for options; blank for futures.",
    "StrikePrice": "Strike price (options only; 0 for futures).",
    "Open": "Open price (₹).",
    "High": "High price (₹).",
    "Low": "Low price (₹).",
    "Close": "Close price (₹).",
    "PreviousClose": "Previous close (₹).",
    "Volume": "Traded volume (in the contract's trading unit / lots).",
    "Value": "Traded value (₹ lakh, as MCX reports it).",
    "OpenInterest": "Open interest (open contracts)."
  },
  "examples": [
    "/api/v1/mcx?date=2026-09-22",
    "/api/v1/mcx?date=2026-09-22&symbol=GOLD&instr=FUTCOM",
    "/api/v1/mcx?date=2026-09-22&instr=FUTCOM&format=csv&limit=100000"
  ],
  "dates_index": "/mcx/index.json",
  "docs": "https://mtf.trading/data"
}