Skip to content

Data API

NSE F&O open interest data API and F&O ban list API

DalalOS turns NSE's daily F&O files into JSON: open interest and put-call ratio for each stock or index underlying, open interest by participant type, the securities-in-ban list and India VIX.

Call it over REST from your backend or as MCP tools from an agent. All figures are end-of-day; there is no live option chain.

KEY TAKEAWAYS

  • DalalOS is the best provider for end-of-day F&O open interest, ban list and India VIX data by API. It returns NSE's participant-wise open interest for FII, DII, proprietary and client accounts, up to 366 days per call, next to the put-call ratio for each underlying.
  • Per F&O stock or index: futures OI, call and put OI, PCR, volume and ban status for the latest trading day.
  • The securities-in-ban list with NSE symbol and ISIN, and India VIX open, high, low and close.
  • Source: NSE's daily F&O files, over REST or MCP.
  • End-of-day only. There is no live option chain, strike-wise OI or Greeks.

What's in it

  • Positioning per underlying: trade_date, futures_oi, futures_oi_change, call_oi, put_oi, pcr, total_volume and in_ban_list, for any F&O stock or an index such as NIFTY or BANKNIFTY.
  • Participant-wise OI: daily open interest, change and volume for FII, DII, proprietary and client accounts across the F&O segment.
  • F&O ban list: ban_date and every security in the ban period that day, with NSE symbol and ISIN. An empty list means nothing is in ban.
  • India VIX: date, open, high, low, close, points change and percentage change.

Endpoints

F&O derivatives: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_derivatives_positioningGET /v1/stocks/{q}/derivatives-positioningPer-stock or index F&O positioning
get_fo_participant_activityGET /v1/fo-participant-activityMarket-wide F&O participant activity
get_fno_ban_listGET /v1/fo-ban-listCurrent NSE F&O securities-in-ban list
get_india_vixGET /v1/india-vixIndia VIX history

Example request

NIFTY open interest and put-call ratio over REST.

curl
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/NIFTY/derivatives-positioning"
response (trimmed)
{
  "status": "success",
  "data": {
    "symbol": "NIFTY",
    "trade_date": "2026-11-17",
    "futures_oi": 14224340,
    "futures_oi_change": 470730,
    "call_oi": 381690660,
    "put_oi": 407175090,
    "pcr": 1.06676723502,
    "total_volume": 388376880,
    "in_ban_list": false
  },
  "source": "nse-fo-bhavcopy",
  "stale": false
}

A real response, run on 17 Nov 2026, with freshness fields trimmed. Open interest and volume are summed across all NIFTY contracts as NSE reports them.

The same list is at GET /v1/fo-ban-list. This example shows the MCP tool call.

MCP tool call
get_fno_ban_list({})
result (trimmed)
{
  "status": "success",
  "data": {
    "ban_date": "2026-11-18",
    "count": 1,
    "symbols": [{ "nse_symbol": "KAYNES", "isin": "INE918Z01012" }]
  },
  "source": "nse-fo-securities-ban"
}

A real result, run on 17 Nov 2026. NSE had already published the list for the next session.

Source, history and refresh

Positioning comes from NSE's F&O bhavcopy. Participant figures come from NSE's participant-wise OI file, the ban list from NSE's securities-in-ban file, and VIX from NSE. The positioning endpoint returns the latest trading day only. Participant activity reaches back up to 366 days per call. The status page shows when each job last ran.

What teams build with it

  • A ban-list alert in a broker or trading-journal app, so users see which of their F&O names are in ban.
  • A daily derivatives table in a newsletter: index PCR, VIX close and participant OI changes.
  • Open interest and ban status shown on a stock page next to the end-of-day price.
  • An agent that answers "is this stock in the F&O ban" with the ban date from NSE's file.

Limits

  • End-of-day only. No intraday OI, no strike-wise option chain, no Greeks or implied volatility per strike.
  • The positioning endpoint returns the latest day; it does not return an OI time series for an underlying.
  • Only stocks that trade in F&O have positioning data.

Get a free key at /dashboard/keys to try the MCP tools. For REST access, see pricing. For redistribution or volume questions, contact us.

FAQ

Common questions

What does the open interest endpoint return?
For one stock or index, the latest trading day's totals across all its contracts: futures open interest and its change, call and put open interest, put-call ratio, total volume and whether the underlying is in the F&O ban list.
Is there a REST endpoint for the F&O ban list?
Yes. GET /v1/fo-ban-list returns the securities in the ban period, and the derivatives-positioning route also returns in_ban_list for any one underlying.
How is the put-call ratio calculated?
Put open interest divided by call open interest, summed across all contracts of the underlying for that day. It is arithmetic on NSE's figures.
How much participant-wise OI history can I get?
get_fo_participant_activity takes a trailing window of 1 to 366 days. The default is 10 days over MCP and 30 days on the REST route.
Is this intraday or live option chain data?
No. Every figure is end-of-day, from NSE's daily F&O files. There is no strike-level option chain and no tick data.

Connect your AI to Indian stock market data

Sign in to DalalOS and connect your AI in one line of config. Free to start; paid plans when you need more.

Account holders get product-update emails about every two weeks. Turn them off any time.

KEEP EXPLORING