Futures Chain

This API allows you to get the currently available futures contracts for an underlying symbol.

USE CASE

Find the futures contracts trading now for an underlying and compare their prices.

Details

The Futures Chain API gives the list of currently available futures contracts for an underlying symbol, along with the last traded price and the change for each contract.
The response contains the underlying symbol followed by its available futures contracts. The underlying entry is returned with an empty expiry.
Pass the underlying symbol, for example NSE:NIFTY50-INDEX, NSE:SBIN-EQ, BSE:SENSEX-INDEX or MCX:CRUDEOIL26SEPFUT.
Each entry in data returns symbol, fyToken, lp, ch, chp, expiry (epoch value) and volume.
A missing or invalid symbol returns an error. Check symbols against Symbol Master first.
Only currently available contracts are listed. For expired contracts, start with Get Expiry Dates.
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 futures chain is required. Eg: NSE:NIFTY50-INDEX, NSE:SBIN-EQ, BSE:SENSEX-INDEX, MCX:CRUDEOIL26SEPFUT

Response Attributes

Attribute	Data Type	Description
`s`	string	ok / error
`code`	int	Response code
`message`	string	Message returned with the response
`data`	array	List of the underlying symbol and its available futures contracts
`data[].symbol`	string	Symbol name of the underlying or the futures contract
`data[].fyToken`	string	Fyers token for the symbol
`data[].lp`	float	Last traded price
`data[].ch`	float	Change value
`data[].chp`	float	Percentage of change between the current value and the previous day's market close
`data[].expiry`	string	Expiry of the futures contract as an epoch value. Empty for the underlying symbol.
`data[].volume`	int	Volume traded

Note: The API returns an error if an invalid symbol is provided, or if the symbol parameter is missing.

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:NIFTY50-INDEX"
}

response = fyers.futures_chain(data)
print(response)
for contract in response["data"]:
    print(contract["symbol"], contract["lp"], contract["expiry"])

{
    "code": 200,
    "data": [
        {
            "ch": 24.25,
            "chp": 0.1,
            "expiry": "",
            "fyToken": "101000000026000",
            "lp": 23897.7,
            "symbol": "NSE:NIFTY50-INDEX",
            "volume": 0
        },
        {
            "ch": 47.9,
            "chp": 0.2,
            "expiry": "1790676600",
            "fyToken": "101126092968407",
            "lp": 24048,
            "symbol": "NSE:NIFTY26SEPFUT",
            "volume": 1836380
        },
        {
            "ch": 46.4,
            "chp": 0.19,
            "expiry": "1793095800",
            "fyToken": "101126102748704",
            "lp": 24150,
            "symbol": "NSE:NIFTY26OCTFUT",
            "volume": 154440
        }
    ],
    "message": "",
    "s": "ok"
}