Symbol Master
Downloadable symbol master files for every exchange segment — the reference list of tradable instruments, tokens, and contract details used to resolve symbols before placing orders.
Overview
Symbol master files are periodically updated .zip archives containing a plain-text list of all tradable instruments for a given exchange segment — trading symbol, token, lot size, tick size, expiry, strike, and other contract metadata. Download and parse the relevant file(s) for the segments you trade on, and refresh them regularly (at minimum daily, and always after a expiry/contract rollover) since tokens and available contracts change over time.
All files are served from the API root: https://api.shoonya.com
Usage notes
- Each archive extracts to a pipe/comma-delimited
.txt file — check the header row of the extracted file for the exact column order per segment, as it can vary slightly between segments.
- Cache the parsed symbol master locally (e.g. in a local DB or in-memory map keyed by token) rather than re-downloading on every request.
- Re-download at the start of each trading day, and additionally whenever you hit an unknown-token or invalid-symbol error mid-session.
- Only download the segment(s) you actually trade — the derivatives files (NFO/BFO/CDS) are significantly larger than the cash-market files.
Overview
Symbol master files are periodically updated
.ziparchives containing a plain-text list of all tradable instruments for a given exchange segment — trading symbol, token, lot size, tick size, expiry, strike, and other contract metadata. Download and parse the relevant file(s) for the segments you trade on, and refresh them regularly (at minimum daily, and always after a expiry/contract rollover) since tokens and available contracts change over time.All files are served from the API root:
https://api.shoonya.comAvailable symbol masters
Usage notes
.txtfile — check the header row of the extracted file for the exact column order per segment, as it can vary slightly between segments.