derivatives

Derivative contracts

Listed futures and option contracts for one underlying from 2001 onward (NSE) and 2024 onward (BSE), including expired contracts. Defaults to contracts expiring from today onward. Filter by expiry (exact) or from_expiry/to_expiry (historical windows at most 2 years apart). Pages by expiry, instrument, strike, option type.

get/v1/derivatives/contracts

Request

Base URL: https://api.tapetide.com
URL: https://api.tapetide.com/v1/derivatives/contracts
Auth: HTTP bearer

Query parameters

underlyingstring required

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

expirystring

Exact expiry date.

from_expirystring

Earliest expiry (inclusive). Default today, or to_expiry minus 2 years.

to_expirystring

Latest expiry (inclusive). Default: open-ended for upcoming windows, from_expiry plus 2 years for historical ones.

instrument'future' | 'option'

Restrict to futures or options.

exchange'NSE' | 'BSE'

Restrict to one exchange. Many stock underlyings trade on both, with different expiry dates.

limitinteger

Items per page (default 200, 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": [
    {
      "underlying": "NIFTY",
      "exchange": "NSE",
      "kind": "index",
      "instrument": "option",
      "expiry": "2026-10-27",
      "strike": 22600,
      "option_type": "CE",
      "lot_size": 65,
      "trading_symbol": "NIFTY-Oct2026-22600-CE"
    }
  ]
}

Changes

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