Skip to main content

Market Connect

Get Security Info

The Get SecurityInfo APIs provide comprehensive information about various instruments.

Method: POST​

https://connect.thefirstock.com/api/V4/securityInfo

Request details

API Parameters
Parameter Description Example
userId
string		 Identifier for the user upon login, unique to each user in the system. AA0013
exchange
string		 Exchange on which the order is placed
(e.g., NSE, BSE, NFO, BFO) 		BSE
tradingSymbol
string		 Encoded trading symbol of the security ITC-EQ
jKey
string		 Authentication token obtained from the login API d4180daa72ea70885ab0d

Libraries and SDKs

Tabbed Interface 
from thefirstock import thefirstock

getSecurityInfo = thefirstock.firstock_getSecurityInfo(
    exchange="NSE",
    tradingSymbol="ACC-EQ",
    userId="{{userId}}"
)
curl --location --request POST 'https://connect.thefirstock.com/api/V4/securityInfo' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userId": "{{userID}}",
    "exchange": "NSE",
    "tradingSymbol": "Nifty 50",
    "jKey": "{{jKey}}"
}'
cconst Firstock = require("thefirstock");

const firstock = new Firstock();

firstock.getSecurityInfo(
  {
    userId: {{userId}},
    exchange: "NSE",
    token: "22",
  },
  (err, result) => {
    console.log("Error, ", err);
    console.log("Result: ", result);
  }
);

using thefirstock;

class Program
{
    public static void Main()
    {
        Firstock firstock = new Firstock();
        var result = firstock.getSecurityInfo(userId: {{userId}},exchange: "NSE", token: "22");
    }
}

Success response details

API Parameters 
 {
  "status": "success",
  "data": {
      "exchange": "NSE",
      "tradingSymbol": "ACC-EQ",
      "symbolName": "ACC",
      "companyName": "ACC LIMITED",
      "instrumentName": "EQ",
      "segment": "EQT",
      "pricePrecision": "2",
      "lotSize": "1",
      "tickSize": "0.05",
      "mult": "1",
      "prcftr_d": "(1 / 1 ) * (1 / 1)",
      "token": "22"
  }
}

Failure response details

API Parameters
Parameter Description Example
status
String		 success success
data.exchange
String		 Exchange on which the order is placed
(e.g., NSE, BSE, NFO, BFO) 		NSE
data.tradingSymbol
String		 Encoded trading symbol of the
security		 ACC-EQ
data.companyName
String		 The full legal name of the
company associated with the trading
symbol.		 ACC LIMITED
data.symbolName
String		 he symbol or contract identifier
for the traded asset.		 ACC
data.segment
String		 Segment EQT
data.instrumentName
String		 Instrument Name EQ
data.tickSize
String		 The minimum price movement
in the trading instrument. 		0.05
data.lotSize
String		 The standard number of
units in one lot.		 1
data.pricePrecision
String		 The level of precision
used in pricing.		 2
data.mult
String		 TMultiplier 1
data.token
String		 A unique identifier or token
for the contract.		 22
data.prcftr_d
String		 ((GN / GD) * (PN/PD)) (1 / 1 ) * (1 / 1)
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		 Specifies the type or category of
the error encountered		 INVALID_USERID
error.field
String		 Field in the request that triggered
the error		 userid
error.message
String		 Detailed message describing the error userid parameter is invalid 
{
  "status": "failed",
  "code": "401",
  "name": "INVALID_USERID",
  "error": {
      "field": "userid",
      "message": "userid parameter is invalid"
  }
}