Get Expiry Dates

This API allows you to get the futures and options expiry dates for an underlying symbol within a date range.

USE CASE

Find the expiry dates that existed for an underlying before you look up its expired contracts.

Details

The Get Expiry Dates API gives the available Futures and Options expiry dates for an underlying symbol within a specified date range.
Futures and Options expiry dates are returned separately.
Use this API when the underlying symbol is known but the expiry date is not. Once you select an expiry date, use the underlying symbol and expiry date with the Get Expired Contracts API to get the available expired contract symbols.
You can request up to 366 days at a time.
Use an underlying symbol such as NSE:NIFTY50-INDEX, NSE:SBIN-EQ or BSE:SENSEX-INDEX.
Dates in range_from and range_to are epoch values when date_format is 0, or yyyy-mm-dd when it is 1.
Futures expiries are returned in data.expiry_dates.futures and options expiries in data.expiry_dates.options.
Pass a returned expiry date to Get Expired Contracts as expiry_date.
Expiry data is available from different dates for each exchange.
Rate limits differ between the Standard and Prime plans. See Plans & rate limits.

Data Availability

Exchange	Data Available From
`NSE`	10 October 2018
`BSE`	07 August 2023
`MCX`	11 October 2018

Request Attributes

Attribute	Data Type	Description
`symbol`*	string	Underlying symbol for which the expiry dates are required. Eg: NSE:NIFTY50-INDEX, NSE:SBIN-EQ, BSE:SENSEX-INDEX
`range_from`*	string	Indicating the start date of records. Accepts epoch value if date_format flag is set to 0. Accepts yyyy-mm-dd format if date_format flag is set to 1.
`range_to`*	string	Indicating the end date of records. Accepts epoch value if date_format flag is set to 0. Accepts yyyy-mm-dd format if date_format flag is set to 1.
`date_format`*	int	date_format is a boolean flag. 0 to enter the epoch value. 1 to enter the date format as yyyy-mm-dd.

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 expiry dates are returned
`data.from_date`	string	Start of the requested range
`data.to_date`	string	End of the requested range
`data.expiry_dates.futures`	array	Futures expiry dates available within the requested range
`data.expiry_dates.options`	array	Options expiry dates available within the requested range

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",
    "range_from": "2025-01-01",
    "range_to": "2025-03-31",
    "date_format": "1"
}

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

{
    "code": 200,
    "data": {
        "symbol": "SBIN",
        "from_date": "2025-01-01",
        "to_date": "2025-03-31",
        "expiry_dates": {
            "futures": ["2025-01-30", "2025-02-27", "2025-03-27"],
            "options": ["2025-01-30", "2025-02-27", "2025-03-27"]
        }
    },
    "message": "",
    "s": "ok"
}