derivatives

Market-wide position limit utilisation

Daily market-wide position limit, open interest, utilisation and next-session ban flag for one F&O stock, from 2010-02-01. Utilisation needs future-equivalent OI, published from 2025-10-01. Index underlyings have no market-wide limit (404). Window defaults to the last 90 days (max 5 years). Pages by date, newest first by default.

get/v1/derivatives/{underlying}/position-limits

Request

Base URL: https://api.tapetide.com
URL: https://api.tapetide.com/v1/derivatives/{underlying}/position-limits
Auth: HTTP bearer

Path parameters

underlyingstring required

Underlying symbol as listed for derivatives, e.g. "NIFTY", "BANKNIFTY", "SENSEX", "RELIANCE". Percent-encode "&" (M%26M).

Query parameters

fromstring

First session (inclusive).

tostring

Last session (inclusive). Default today.

order'asc' | 'desc'

Sort direction by date.

limitinteger

Items per page (default 100, max 1000). Values over the max are rejected, never clamped.

cursorstring

Opaque cursor from meta.next_cursor of the previous page.

Response

OK. Costs one request unit.

Example response

{
  "data": [
    {
      "date": "2026-10-15",
      "symbol": "RELIANCE",
      "isin": "INE002A01018",
      "market_wide_limit_units": 658757301,
      "open_interest_units": 344116500,
      "future_equivalent_open_interest_units": 179202892,
      "utilisation_pct": 27.2,
      "headroom_next_session_units": 446616544,
      "ban_next_session": false,
      "applies_to_session": "2026-10-16",
      "applies_to_session_basis": "calendar"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.