Search Scrips
The Search scrips APIs provide you with the ability to efficiently search for instruments by utilizing relevant keywords.
Method: post
https://connect-go.thefirstock.tech/api/V5/searchScrips
Request details
| Parameter | Type | Mandatory | Example |
|---|---|---|---|
| userId | String | Yes | NP2997 |
| jKey | String | Yes | abc123 |
| stext | String | Yes | ITC |
Libraries and SDKs
curl --location 'https://connect-go.thefirstock.tech/api/V5
/searchScrips' \
--header 'Content-Type: application/json' \
--data '{
"userId": "NP2997",
"jKey": "1478b9b71707210d8851258599b23a6a73d31b19809ac5068560f38dad493d35",
"stext": "ITC"
}'
Success response details
| Parameter | Description | Example |
|---|---|---|
| values String |
Describes the status within the data portion of the response |
{
"exchange": "", "tradingSymbol": "", "token": "23650", "companyName": " ", "instrumentName": "", "pricePrecision": "", "lotSize": "", "tickSize": "" } |
| status String (array) |
Indicates the result status of the API operation |
success |
Response Details: Json Fields of object in values Array
| Parameter | Description | Example |
|---|---|---|
| exchange String |
The financial exchange where the security is listed and traded, like the National Stock Exchange (NSE) or Bombay Stock Exchange (BSE). |
NSE |
| tradingSymbol String |
The unique symbol or identifier for the stock or financial instrument being traded on the exchange. |
MUTHOOTFIN-EQ |
| token String |
A specific code or token assigned to the trading instrument for identification within the trading system. |
23650 |
| pricePrecision String |
The number of decimal places to which the price of the instrument is calculated, defining the smallest price movement. |
2 |
| tickSize String |
The minimum price movement of the instrument on the exchange, representing the smallest price change. |
0.05 |
| lotSize String |
The standard number of units of the instrument that make up a single trading lot, representing the minimum tradable quantity. |
1 |
| companyName String |
The full legal name of the company associated with the trading symbol. |
MUTHOOT FINANCE LTD |
| instrumentName String |
The type of financial instrument being traded, such as equity (EQ), futures, options, etc. |
EQ |
{
"status": "success",
"values": [
{
"companyName": "ITC HOTELS LIMITED",
"exchange": "NSE",
"instrumentName": "EQ",
"lotSize": "1",
"pricePrecision": "2",
"tickSize": "0.01",
"token": "29251",
"tradingSymbol": "ITCHOTELS-EQ"
},
{
"companyName": "ITC LTD",
"exchange": "NSE",
"instrumentName": "EQ",
"lotSize": "1",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "1660",
"tradingSymbol": "ITC-EQ"
},
{
"companyName": "ITC Hotels Limited",
"exchange": "BSE",
"instrumentName": "B",
"lotSize": "1",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "544325",
"tradingSymbol": "ITCHOTELS"
},
{
"companyName": "ITCONS E-Solutions Limited",
"exchange": "BSE",
"instrumentName": "MT",
"lotSize": "200",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "543806",
"tradingSymbol": "ITCONS"
},
{
"companyName": "ITC LTD.",
"exchange": "BSE",
"instrumentName": "A",
"lotSize": "1",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "500875",
"tradingSymbol": "ITC"
},
{
"exchange": "NFO",
"instrumentName": "FUTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "41029",
"tradingSymbol": "ITC27MAR25F"
},
{
"exchange": "NFO",
"instrumentName": "FUTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "73464",
"tradingSymbol": "ITC24APR25F"
},
{
"exchange": "NFO",
"instrumentName": "FUTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "57351",
"tradingSymbol": "ITC29MAY25F"
},
{
"exchange": "BFO",
"instrumentName": "FUTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "844288",
"tradingSymbol": "ITC25MARFUT"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "40894",
"tradingSymbol": "ITC27MAR25P180"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "40893",
"tradingSymbol": "ITC27MAR25C180"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "55093",
"tradingSymbol": "ITC27MAR25P190"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "55092",
"tradingSymbol": "ITC27MAR25C190"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "49582",
"tradingSymbol": "ITC27MAR25P200"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "49581",
"tradingSymbol": "ITC27MAR25C200"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "48220",
"tradingSymbol": "ITC27MAR25P210"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "48219",
"tradingSymbol": "ITC27MAR25C210"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "45312",
"tradingSymbol": "ITC27MAR25P220"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "45311",
"tradingSymbol": "ITC27MAR25C220"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "46198",
"tradingSymbol": "ITC27MAR25P230"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "46197",
"tradingSymbol": "ITC27MAR25C230"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "122587",
"tradingSymbol": "ITC27MAR25P240"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "122586",
"tradingSymbol": "ITC27MAR25C240"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "123642",
"tradingSymbol": "ITC27MAR25P250"
},
{
"exchange": "NFO",
"instrumentName": "OPTSTK",
"lotSize": "1600",
"pricePrecision": "2",
"tickSize": "0.05",
"token": "123641",
"tradingSymbol": "ITC27MAR25C250"
}
]
}
Failure response details
| Parameter | Description | Example |
|---|---|---|
| status String |
Indicates the result status of the API operation |
failed |
| code String |
HTTP status code associated with the error |
400 |
| name String |
Specifies the type or category of the error encountered |
BAD_REQUEST |
| error.field String |
Field in the request that triggered the error |
stext |
| error.message String |
Detailed message describing the error |
stext cannot be undefined or NULL |
{
"status": "failed",
"code": "400",
"name": "BAD_REQUEST",
"error": {
"field": "stext",
"message": "stext cannot be undefined or NULL"
}
}