Global Instruments Support

Effective 11 May 2026

We are pleased to announce the availability of the Global Instruments file — a dedicated JSON file that provides instrument keys for global stock market indices and economic indicators. Use these keys with the existing Upstox market data APIs to retrieve live quotes and historical candle data for benchmarks such as GIFT NIFTY, Dow Jones, S&P 500, and more.

What's Included

A new instruments file is now available:

Global Instruments

The file covers two segment types:

Segment	Description	Examples
`GLOBAL_INDEX`	Major global stock market indices	HANG SENG, DOW JONES, FTSE 100, S&P, GIFT NIFTY, DAX, US Tech 100, CAC 40, NIKKEI 225, US 30
`GLOBAL_INDICATOR`	Economic and commodity indicators	USD INR, Oil (Brent), Oil (WTI)

Sample JSON Objects

Global Index — GIFT NIFTY

{
  "weekly": false,
  "segment": "GLOBAL_INDEX",
  "name": "GIFT NIFTY",
  "exchange": "GLOBAL",
  "country": "India",
  "latency": "120 Seconds",
  "instrument_key": "GLOBAL_INDEX|SGX NIFTY",
  "trading_symbol": "GIFT NIFTY",
  "start_time": "6.30AM Monday",
  "end_time": "2.45AM Saturday",
  "week_days": "Mon-Fri",
  "mtf_enabled": false
}

Global Indicator — Oil (Brent)

{
  "weekly": false,
  "segment": "GLOBAL_INDICATOR",
  "name": "Oil (Brent)",
  "exchange": "GLOBAL",
  "country": "",
  "latency": "20 Seconds",
  "instrument_key": "GLOBAL_INDICATOR|BZUSD",
  "trading_symbol": "BZUSD",
  "start_time": "3.30AM Sunday",
  "end_time": "2.35AM Saturday",
  "week_days": "Sun-Fri",
  "mtf_enabled": false
}

Field Description

Field	Type	Description
segment	string	Market segment. Possible values: `GLOBAL_INDEX`, `GLOBAL_INDICATOR`
name	string	Display name of the instrument (e.g., `GIFT NIFTY`, `Oil (Brent)`).
exchange	string	Exchange identifier. Value: `GLOBAL`
country	string	Country of origin for the index (e.g., `India`, `America`, `UK`). Empty for indicators.
latency	string	Data refresh interval — how frequently the price data is updated. Possible values: `20 Seconds`, `120 Seconds`, `900 Seconds`.
instrument_key	string	Unique identifier used across Upstox APIs. Format: `<segment>\\|<trading_symbol>`
trading_symbol	string	Trading symbol of the instrument (e.g., `SGX NIFTY`, `^DJI`, `BZUSD`).
start_time	string	Market open time in IST (e.g., `6.30AM Monday`).
end_time	string	Market close time in IST (e.g., `2.45AM Saturday`).
week_days	string	Active trading days (e.g., `Mon-Fri`, `Sun-Fri`).
mtf_enabled	boolean	MTF is not applicable for global instruments. Always `false`.

How to Use Global Instrument Keys

Use the instrument_key from the Global Instruments file with the following Upstox market data APIs:

Full Market Quote — Retrieve the live quote including LTP, OHLC, and volume data for a global index or indicator.
LTP V3 — Fetch only the last traded price for one or more global instruments in a lightweight response.
Historical Candle Data V3 — Query OHLCV candle data for global instruments across daily, weekly, or monthly intervals.
Intraday Candle Data V3 — Retrieve intraday candle data for global instruments at minute-level granularity.

Engage with Us

We welcome your feedback and questions. Join the discussion on our Developer Community to share suggestions, report issues, or explore how other developers are using the Global Instruments file.