Get Expired Contracts

This API allows you to get the expired futures and options contract symbols for an underlying symbol and expiry date.

USE CASE

Find the exact symbol of an expired futures contract or option strike for a given expiry.

Details

The Get Expired Contracts API gives the expired Futures and Options contract symbols available for a specified underlying symbol and expiry date.
Futures and Options contract symbols are returned separately.
If the expiry date is not known, use the Get Expiry Dates API first.
Once you find the required expired contract symbol, use it with the Get Expired F&O Data API to get historical data.
Send expiry_date in yyyy-mm-dd format, using a date returned by Get Expiry Dates.
Futures symbols are returned in data.contracts.futures and options symbols in data.contracts.options.
Copy a contract symbol exactly as returned into Get Expired F&O Data.
Rate limits differ between the Standard and Prime plans. See Plans & rate limits.

Request Attributes

Attribute	Data Type	Description
`symbol`*	string	Underlying symbol for which the expired contracts are required. Eg: NSE:NIFTY50-INDEX, NSE:SBIN-EQ, BSE:SENSEX-INDEX
`expiry_date`*	string	Expiry date of the contracts in yyyy-mm-dd format. Use an expiry date returned by the Get Expiry Dates API.

Response Attributes

Attribute	Data Type	Description
`s`	string	ok / error
`code`	int	Response code
`message`	string	Message returned with the response
`data.symbol`	string	Underlying symbol for which the contracts are returned
`data.expiry_date`	string	Expiry date of the returned contracts
`data.contracts.futures`	array	Expired Futures contract symbols for the requested expiry
`data.contracts.options`	array	Expired Options contract symbols for the requested expiry

Request

from fyers_apiv3 import fyersModel

client_id = "XC4XXXXM-100"
access_token = "eyJ0eXXXXXXXX2c5-Y3RgS8wR14g"

fyers = fyersModel.FyersModel(client_id=client_id, is_async=False, token=access_token, log_path="")

data = {
    "symbol": "NSE:SBIN-EQ",
    "expiry_date": "2025-03-27"
}

response = fyers.history_underlying_symbols(data)
print(response)
print(response["data"]["contracts"]["futures"])
print(response["data"]["contracts"]["options"])

{
    "code": 200,
    "data": {
        "symbol": "SBIN",
        "expiry_date": "2025-03-27",
        "contracts": {
            "futures": ["NSE:SBIN25MARFUT"],
            "options": ["NSE:SBIN25MAR320PE", "NSE:SBIN25MAR320CE", "NSE:SBIN25MAR340PE", "NSE:SBIN25MAR340CE"]
        }
    },
    "message": "",
    "s": "ok"
}