Instrument Token List
Downloadable master files mapping every tradable instrument to its token, exchange, and contract details.
Overview
Rather than looking up instruments one at a time via Search Scrip, Shoonya publishes a full instrument master as a downloadable file per exchange segment. Use these for local caching, symbol-to-token mapping, and bulk lookups — polling Search Scrip in a loop for a large symbol universe will run into the limits described in Rate Limits.
Each master file is a compressed, delimited text file — one row per instrument — refreshed daily before market open to reflect new listings, expiries, and corporate actions. Typical columns include:
| Column | Description |
|---|
Exchange | Segment code — see Exchange Segment Codes. |
Token | Unique numeric instrument identifier, used in WebSocket subscriptions in place of the trading symbol. |
Symbol / TradingSymbol | Human-readable symbol used in order and quote payloads (tsym). |
Instrument | Instrument type — equity, futures, options, index. |
Expiry | Contract expiry date, for derivatives only. |
StrikePrice | Option strike, for options only. |
LotSize | Minimum tradable quantity for derivatives contracts. |
TickSize | Minimum price increment for the instrument. |
Best practices
- Re-download the master file at the start of each trading day — tokens can be reassigned across expiries, especially for weekly options.
- Build a local symbol-to-token index at startup rather than re-parsing the file on every lookup.
- Always subscribe to market data using
Token, not Symbol — the WebSocket feed keys off the numeric token.
- Cross-check
LotSize from the master file rather than hardcoding it, since exchange-mandated lot sizes change periodically for F&O contracts.
See Search Scrip for on-demand single-instrument lookups, and Subscribe to Market Feed for how tokens are used once resolved.
Overview
Rather than looking up instruments one at a time via Search Scrip, Shoonya publishes a full instrument master as a downloadable file per exchange segment. Use these for local caching, symbol-to-token mapping, and bulk lookups — polling Search Scrip in a loop for a large symbol universe will run into the limits described in Rate Limits.
File format
Each master file is a compressed, delimited text file — one row per instrument — refreshed daily before market open to reflect new listings, expiries, and corporate actions. Typical columns include:
ExchangeTokenSymbol/TradingSymboltsym).InstrumentExpiryStrikePriceLotSizeTickSizeBest practices
Token, notSymbol— the WebSocket feed keys off the numeric token.LotSizefrom the master file rather than hardcoding it, since exchange-mandated lot sizes change periodically for F&O contracts.Related
See Search Scrip for on-demand single-instrument lookups, and Subscribe to Market Feed for how tokens are used once resolved.