pocketful logo light
pocketful logo light

Search Scrip

In Search Scrip, detailes of all the related named instruments will be returned in response with attributes like: token, exchange, company name, display name etc.

Endpoint: api/v1/search
Method-Type: GET

Query Params

{
  "key": "<trading_symbol>"
}

Parameters

Field NameData TypeDescription
Instrument NameStringName of the instrument whose information needs to be fetched.

Example

data = pocket.searchScrip('Bank Nifty')

Response

{
  "error": {
    "code": 0,
    "message": ""
  },
  "result": [
    {
      "token": "26009",
      "exchange": "NSE",
      "company": "Nifty Bank",
      "symbol": "Nifty Bank",
      "trading_symbol": "Nifty Bank",
      "display_name": "Nifty Bank",
      "score": 0.24,
      "close_price": "",
      "is_tradable": false,
      "segment": "Indices",
      "tag": "",
      "expiry": "",
      "alternate": {}
    },
    {
      "token": "7361",
      "exchange": "NSE",
      "company": "SBI-ETF NIFTY BANK",
      "symbol": "SETFNIFBK",
      "trading_symbol": "SETFNIFBK-EQ",
      "display_name": "SETFNIFBK",
      "score": 0.210088,
      "isin": "INF200KA1580",
      "close_price": "477.73",
      "is_tradable": true,
      "segment": "Equity",
      "tag": "ETF",
      "expiry": "",
      "alternate": {
        "token": "199116",
        "exchange": "BSE",
        "company": "INAV SBI-ETF NIFTY BANK",
        "symbol": "SETFNIFINAV",
        "trading_symbol": "SETFNIFINAV-B",
        "display_name": "SETFNIFINAV",
        "isin": "INF200KA1580",
        "segment": "Equity"
      }
    },
    {
      "token": "199116",
      "exchange": "BSE",
      "company": "INAV SBI-ETF NIFTY BANK",
      "symbol": "SETFNIFINAV",
      "trading_symbol": "SETFNIFINAV-B",
      "display_name": "SETFNIFINAV",
      "score": 0.190087,
      "isin": "INF200KA1580",
      "close_price": "",
      "is_tradable": true,
      "segment": "Equity",
      "tag": "",
      "expiry": "",
      "alternate": {
        "token": "7361",
        "exchange": "NSE",
        "company": "SBI-ETF NIFTY BANK",
        "symbol": "SETFNIFBK",
        "trading_symbol": "SETFNIFBK-EQ",
        "display_name": "SETFNIFBK",
        "isin": "INF200KA1580",
        "close_price": "477.73",
        "segment": "Equity"
      }
    },
    {
      "token": "26025",
      "exchange": "NSE",
      "company": "Nifty PSU Bank",
      "symbol": "Nifty PSU Bank",
      "trading_symbol": "Nifty PSU Bank",
      "display_name": "Nifty PSU Bank",
      "score": 0,
      "close_price": "",
      "is_tradable": false,
      "segment": "Indices",
      "tag": "",
      "expiry": "",
      "alternate": {}
    },
    {
      "token": "26047",
      "exchange": "NSE",
      "company": "Nifty Pvt Bank",
      "symbol": "Nifty Pvt Bank",
      "trading_symbol": "Nifty Pvt Bank",
      "display_name": "Nifty Pvt Bank",
      "score": 0,
      "close_price": "",
      "is_tradable": false,
      "segment": "Indices",
      "tag": "",
      "expiry": "",
      "alternate": {}
    }
  ]
}
KeyDescription
errorContains error details, if any, encountered during the API request.
codeThe error code.
messageThe error message.
resultContains an array of objects representing information about stocks or assets.
tokenThe unique identifier/token of the stock.
exchangeThe exchange where the stock is traded.
companyThe name of the company associated with the stock.
symbolThe symbol of the stock.
trading_symbolThe trading symbol of the stock.
display_nameThe display name of the stock.
scoreThe score associated with the stock.
isinThe ISIN (International Securities Identification Number) of the stock.
close_priceThe closing price of the stock.
is_tradableIndicates if the stock is tradable.
segmentThe segment to which the stock belongs (e.g., Equity).
tagAny additional tag or label associated with the stock.
expiryThe expiry date of the stock, if applicable.
alternateContains information about an alternate trading option for the stock, such as trading on a different exchange.

Error Response

{
    "error":{
        "code": 0,
        "message": ""
    },
    "result":{
    }
}