Skip to main content

Market_Connect

Option Chain

The Option Chain APIs allow you to access the complete list of option scrip codes for a specific underlying instrument. With this scrip code, you can subscribe to real-time data via websocket.

Method: POST​

https://connect-go.thefirstock.tech/api/V5/optionChain

Request details

API Parameters
Parameter Value Type Mandatory
userId NP2997 String Yes
jKey abc123 String Yes
exchange NFO String Yes
symbol NIFTY String Yes
spot 23165.7 String Yes
count 5 Integer Yes
expiry 03-APR-2025 String Yes

Libraries and SDKs

Tabbed Interface 
curl --location 'https://connect-go.thefirstock.tech/api/V5/optionChain' \
--header 'Content-Type: application/json' \
--data '{
    "userId": "NP2997",
    "jKey": "211b250616fe25067a3b71b24451d1dfd389faabe338770ada62d81fd20b4bda",
    "exchange": "NFO",
    "symbol": "NIFTY",
    "expiry": "03-APR-2025",
    "count": 5,
    "spot": 23165.7
}'

Success Response Details

API Parameters
Parameter Description Example
status
String		 Market watch success or failure
indication		 success
values
String		 Array of JSON objects
(object fields below)		 ["exchange": "NFO", "token": "51909",
"tradingSymbol": "NIFTY19JAN23C20050",
"optionType": "CE", "pricePrecision": "2",
"lotSize": "50", "tickSize": "0.05",
"strikePrice": "20050.00"]

Response Details: Array of Object Values in JSON Fields.

API Parameters
Parameter Description Example
data.requestTime
String		 The exact time when the API response was generated and sent, providing a timestamp for the operation. 13:25:51
24-08-2022
values.exchange
String		 Indicates the financial exchange where trading activities are conducted. For example, 'NFO' refers to the Futures and Options segment of a particular exchange. NFO
values.tradingSymbol
String		 The unique code or symbol assigned to a particular security or derivative contract for trading on the exchange. URL encoding should be used for symbols with special characters. BANKNIFTY28APR22C37400
values.token
String		 A specific code or token assigned to the trading instrument for identification within the trading system. 37400
values.strikePrice
String		 The specified price at which an option contract can be exercised, key in determining its value and potential profitability. 35500.00
values.pricePrecision
String		 The number of decimal places to which the price of the instrument is calculated, defining the smallest price movement. 2
values.tickSize
String		 The smallest increment by which the price of a security or contract can move in the market. 0.05
values.lotSize
String		 The standard number of units in one trading lot for the security, representing the minimum tradable quantity. 25
API Parameters 
{
    "status": "success",
    "message": "Option chain fetched successfully",
    "data": [
        {
            "atp": "31483",
            "bbo1": "1",
            "bbo2": "3",
            "bbo3": "1",
            "bbo4": "4",
            "bbo5": "1",
            "bbp1": "31375",
            "bbp2": "31370",
            "bbp3": "31365",
            "bbp4": "31360",
            "bbp5": "31355",
            "bbq1": "150",
            "bbq2": "375",
            "bbq3": "75",
            "bbq4": "525",
            "bbq5": "75",
            "bso1": "1",
            "bso2": "1",
            "bso3": "3",
            "bso4": "3",
            "bso5": "3",
            "bsp1": "31450",
            "bsp2": "31455",
            "bsp3": "31460",
            "bsp4": "31465",
            "bsp5": "31470",
            "bsq1": "75",
            "bsq2": "75",
            "bsq3": "225",
            "bsq4": "300",
            "bsq5": "525",
            "buy_depth_size": "5",
            "company_name": "NIFTY 03 25APR 22950 C",
            "cp": "28920",
            "delta": "0.7284763103352669",
            "exch": "NFO",
            "exchft": "02-Apr-2025 10:15:36",
            "expiry": "03-APR-2025",
            "expiry_type": "Weekly",
            "freeze_qty": "1800",
            "ft": "1743569136",
            "gamma": "1.1946833209164977e-05",
            "has_depth": "True",
            "has_fundamentals": "False",
            "has_futures": "True",
            "has_options": "True",
            "hp": "37845",
            "inst": "OPTIDX",
            "is_tradable": "True",
            "lcl": "5",
            "lp": "27180",
            "ls": "75",
            "ltp": "31460",
            "ltq": "75",
            "ltt": "1743569131",
            "mkt_type": "Options",
            "nci": "45",
            "npcfromcp": "4294966721",
            "oi": "80700",
            "op": "29505",
            "option_type": "CE",
            "parent_token": "26000",
            "price": "2213815.45533",
            "reps_name": "NIFTY 3rd APR 22950 CE",
            "rho": "0.482595078328606",
            "sell_depth_size": "5",
            "sharply_id": "",
            "ssboe": "1743569136036380642",
            "strike": "22950",
            "strike_difference": "50",
            "strike_price": "22950",
            "symbol": "NIFTY",
            "tbq": "172950",
            "theta": "-1672.0951774550904",
            "token": "54636",
            "trading_symb": "NIFTY03APR25C22950",
            "ts": "0.05",
            "tsq": "28800",
            "ttv": "21019624950",
            "ucl": "94200",
            "usecs": "36380642",
            "vega": "6.692833496176445",
            "vtt": "669600"
        },
}

Failure response details

API Parameters
Parameter Description Example
status
String		 Indicates the result status of the
API operation		 failed
code
String		 HTTP status code associated with the error 401
name
String		 Type of error encountered INVALID_COUNT
error.field
String		 Field in the request that triggered
the error		 Count
error.message
String		 Detailed message describing the error Count parameter is invalid 
{
  "status": "failed",
  "code": "401",
  "name": "INVALID_COUNT",
  "error": {
      "field": "Count",
      "message": "Count parameter is invalid"
  }
}