Skip to main content

US Stocks Instruments

The US instruments file lists every US stock and ETF available on Upstox. Use it to find the instrument_key for the US Stocks APIs, and to check whether a stock can be traded and bought in fractions.

US instruments are not included in the Indian BOD files. The US Stocks APIs accept only instrument keys from this file, and return UDAPI1300 for any other key.

JSON file​

The file is gzipped JSON and is refreshed daily, in the same way as the Indian BOD files.

Sample JSON object​

{
"instrument_key": "US_EQ|AAPL",
"segment": "US_EQ",
"exchange": "US",
"foreign_exchange": "NASDAQ",
"trading_symbol": "AAPL",
"name": "Apple Inc.",
"lot_size": 1,
"tick_size": 5.0,
"fractionable": true,
"tradable": true,
"status": "active",
"is_etf": false
}

Fields​

FieldTypeDescription
instrument_keystringUnique key of the stock, in the format US_EQ|<SYMBOL>. Use it in every US Stocks API call.
segmentstringAlways US_EQ.
exchangestringAlways US.
foreign_exchangestringUS exchange where the stock is listed, for example NASDAQ.
trading_symbolstringTicker symbol of the stock.
namestringCompany or fund name.
lot_sizenumberAlways 1.
tick_sizenumberKept for parity with the Indian BOD files. For US order prices, follow the price precision rules instead.
fractionablebooleantrue when the stock can be bought in fractional quantities or by USD amount.
tradablebooleanfalse when the stock is listed but cannot currently be traded. Orders for it return UDAPI1301.
statusstringListing status of the stock, for example active.
is_etfbooleantrue for an exchange-traded fund.

Only stocks with fractionable: true accept a fractional quantity or an amount. For other stocks, send a whole-share quantity, or the order is rejected with UDAPI1304 or UDAPI1306.