Skip to Content

Symbol Master JSON

This API allows you to download the latest Symbol Master as a JSON file for an exchange segment.

USE CASE

Load instrument details into your code to validate symbols and check lot size, tick size and trade status before placing an order.

Details

  • You can get all the latest symbols of all the exchanges from the symbol master json files
  • Check tradeStatus before trading a symbol: 1 means active and 0 means inactive.
  • stream is the stream group. For multi-leg orders, check that both legs belong to the same stream.
  • isCasEligible is true for CAS-eligible symbols and absent otherwise. qtyFreeze is an empty string when not applicable.
  • is_mtf_tradable is 0 or 1. mtf_margin is the margin multiplier for MTF, so 2.9 means 2.9x margin.
  • expiryDate is a timestamp and applies only to derivative contracts. lastUpdate is in YYYY-MM-DD format.
  • Key will be the symbol ticker and value will hold the below json object which has symbol master details for that particular symbol ticker.

File Format

AttributeData Type Of ValuesDescription
fyTokenstring
isinstringISIN code for the security
exSymbolstringExchange symbol of the security
symDetailsstringFull name of the security
symTickerstringUnique string to identify the security
exchangeint
segmentint
exSymNamestringSymbol name of the security
exTokenintExchange token
exSeriesstringSeries of the security. This can be used only for CM segments
optTypestring
  • CE/PE - For options
  • XX - For others
underSymstringname of underlying symbol
underFyTokstringUnique token for the underlying symbol
exInstTypeint
minLotSizeintMinimum qty multiplier
tickSizefloatMinimum price multiplier
tradingSessionstringTrading session provided in IST
lastUpdatestringDate of last update in YYYY-MM-DD format
expiryDatestringDate of expiry for a symbol in timestamp.Applicable only for derivative contracts
strikePricefloatStrike price
qtyFreezestring
  • Freeze qty
  • Empty string in case value is not applicable
tradeStatusint
  • Flag to check if security is allowed to trade.
  • Expected values - 0/1
  • 1 = Active. 0 = Inactive.
currencyCodestringCurrency code
upperPricefloatUpper circut price
lowerPricefloatLower circut price
faceValuefloatFace value
qtyMultiplierfloatQuantity multipler
previousClosefloatPrevious close price
previousOifloatPrevious OI value
asmGsmValstringSurveillance Indicator message
exchangeNamestring
  • Exchange Name
  • NSE/BSE/MCX
symbolDescstringFull name of the security
originalExpDatestringKindly ignore this field
is_mtf_tradableint
  • 0: Not MTF tradable.
  • 1: MTF tradable.
mtf_marginfloat
  • Indicates the margin multiplier available for MTF transactions.
  • For example, a value of 2.9 means you receive 2.9x margin on the stock or security.
streamstringStream Group
isCasEligiblebooleanIndicates CAS eligibility. true means the symbol is CAS eligible; if the field is absent, it is not eligible.
Last updated on