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"
  }
}