Contracts & Expiries¶

These endpoints let you discover individual derivative contracts and the expiry dates they belong to — both currently trading and long expired — by querying on an underlying instead of downloading and filtering the whole Instruments Master CSV. The expired side is what makes historical options work: it tells you which strikes existed for an expiry that has already passed.

Shared Parameters¶

The five endpoints draw on a common set of parameters and enums.

All date values, in requests and in responses, are YYYY-MM-DD.

Search Contracts¶

Returns the individual contracts currently trading on an underlying — options, futures, or both.

Endpoint

GET /market/instruments/search

Query Parameters

Example Request

curl --location 'https://api.indstocks.com/market/instruments/search?underlying=NIFTY&segment=DERIVATIVE&instrument_type=FUTIDX' \
--header 'Authorization: YOUR_ACCESS_TOKEN'

Response Payload (Success)

{
  "status": "success",
  "data": {
    "count": 804,
    "page": 1,
    "page_size": 50,
    "instruments": [
      {
        "security_id": "58072",
        "trading_symbol": "NIFTY26AUG25FUT",
        "expiry": "2026-08-25",
        "strike_price": null,
        "option_type": null,
        "lot_size": 75
      }
    ]
  }
}

Response Fields

List Expiries¶

Returns the upcoming expiry dates available for an underlying — the values you feed into expiry elsewhere.

Endpoint

GET /market/instruments/expiries

Query Parameters

Example Request

curl --location 'https://api.indstocks.com/market/instruments/expiries?underlying=NIFTY&segment=DERIVATIVE' \
--header 'Authorization: YOUR_ACCESS_TOKEN'

Response Payload (Success)

data is a flat array of dates in ascending order, covering upcoming expiries only.

{
  "status": "success",
  "data": ["2026-08-25", "2026-09-01", "2026-09-08"]
}

Search Expired Contracts¶

The same search as Search Contracts, over contracts whose expiry has already passed.

Endpoint

GET /market/instruments/expired/search

Query Parameters

Every parameter from Search Contracts, plus a mandatory expiry window:

Example Request

curl --location 'https://api.indstocks.com/market/instruments/expired/search?underlying=NIFTY&segment=DERIVATIVE&instrument_type=OPTIDX&expiry_from=2024-08-19&expiry_to=2026-07-20&page=1&page_size=50' \
--header 'Authorization: YOUR_ACCESS_TOKEN'

Response Payload (Success)

Identical in shape to Search Contracts, with one difference: there is no security_id.

{
  "status": "success",
  "data": {
    "count": 804,
    "page": 1,
    "page_size": 50,
    "instruments": [
      {
        "trading_symbol": "NIFTY26JUL2825950CE",
        "expiry": "2026-07-28",
        "strike_price": 25950,
        "option_type": "CE",
        "lot_size": 75
      }
    ]
  }
}

Both expiry_from and expiry_to are mandatory, the window may not span more than 5 years, and an inverted window (expiry_from later than expiry_to) is rejected.

List Expired Expiries¶

Returns past expiry dates for an underlying within a window.

Endpoint

GET /market/instruments/expired/expiries

Query Parameters

Example Request

curl --location 'https://api.indstocks.com/market/instruments/expired/expiries?underlying=NIFTY&segment=DERIVATIVE&expiry_from=2025-10-23&expiry_to=2026-08-09' \
--header 'Authorization: YOUR_ACCESS_TOKEN'

Response Payload (Success)

data is a flat array of dates in descending order — newest expiry first, the opposite of List Expiries.

{
  "status": "success",
  "data": ["2026-08-04", "2026-07-28", "2026-07-21"]
}

Get Contracts for an Expired Expiry¶

Returns the full contract chain for one expiry that has already passed.

Endpoint

GET /market/instruments/expired/contracts

Query Parameters

Example Request

curl --location 'https://api.indstocks.com/market/instruments/expired/contracts?underlying=NIFTY&segment=DERIVATIVE&expiry=2026-07-28' \
--header 'Authorization: YOUR_ACCESS_TOKEN'

Response Payload (Success)

data is a flat array of contracts — not the paginated object the two search endpoints return.

{
  "status": "success",
  "data": [
    {
      "trading_symbol": "NIFTY26JUL2825950CE",
      "instrument_type": "OPTIDX",
      "strike_price": 25950,
      "option_type": "CE",
      "lot_size": 75,
      "expiry": "2026-07-28"
    }
  ]
}

Errors¶

Validation errors on these endpoints carry two fields: message with the error category, and debug_info with the specific detail.

{
  "debug_info": "segment=EQUITY is not yet supported on this endpoint; use segment=DERIVATIVE",
  "message": "Not Supported"
}

Surface debug_info in your logs — it identifies which parameter needs attention. See Error Bucket for the response shapes used across the API.

See Also¶

• Instruments Master — the full CSV dump, and the only place to look up cash-market instruments
• Historical Data — fetch candles for the contracts you find here
• Option Chain — live strike-by-strike quotes for a current expiry
• Error Bucket — error shapes and error_type values