Instruments
This guide explains how to download and use instrument data with the Groww API.
Instruments are the financial assets that can be traded on exchanges through the Groww API. These include stocks, futures, options, indices and other tradable securities. The Instruments API provides essential data about these trading instruments that you'll need for many operations in the Groww API. You can download the instruments csv file from here.
Download Instrument CSV
Use the download instrument url
to retrieve a comma-separated CSV file with instrument details.
CSV Format
The full CSV file contains instrument details in the following format. Each individual column is explained below.
All prices in rupees.
Instrument CSV Columns
The CSV contains the following columns (separated by commas):
Name | Type | Description |
---|---|---|
exchange | string | The Exchange where the instrument is traded |
exchange_token | string | The unique token assigned to the instrument by the exchange |
trading_symbol | string | The trading symbol of the instrument to place orders with |
groww_symbol | string | The symbol used by Groww to identify the instrument |
name | string | The name of the instrument |
instrument_type | string | The type of the instrument |
segment | string | Segment of the instrument such as CASH, FNO etc. |
series | string | The series of the instrument (e.g., EQ, A, B, etc.) |
isin | string | The ISIN (International Securities Identification number) of the instrument |
underlying_symbol | string | The symbol of the underlying asset (for derivatives). Empty for stocks and indices |
underlying_exchange_token | string | The exchange token of the underlying asset |
lot_size | integer | The minimum lot size for trading the instrument |
expiry_date | string | The expiry date of the instrument (for Derivatives) |
strike_price | integer | The strike price of the instrument (for Options) |
tick_size | decimal | The minimum price movement for the instrument |
freeze_quantity | integer | The quantity that is frozen for trading |
is_reserved | boolean | Whether the instrument is reserved for trading |
buy_allowed | boolean | Whether buying the instrument is allowed |
sell_allowed | boolean | Whether selling the instrument is allowed |