General provisions

SYMBOL

IBM,

SPX

Commonly used for: US equities, indices, and ETFs.

Used for both consolidated and direct US exchange feeds, depending on dxFeed data sources (e.g., GOOG from NBASIC). Applicable when data is available in both consolidated and regional formats, or when only one of them is present (e.g., certain US indices)

SYMBOL&EXCHANGE_CODE

AAPL&Q

Commonly used for: US equities.

Used to request data from consolidated feeds or specific exchange sub-feeds by appending an exchange code to the symbol. See the full list of Market Identifier Codes

SYMBOL:NAMESPACE

/ES:XCME, BTC/USD:CXBITS,

1SXPd:BATE, KCN:CHIA,

BXY:DXI, HAU:DXI, DXBTC:MIAXDX

Commonly used for: US futures, crypto, CFDs, forex, dxFeed indices, and EU/APAC equities.

Adds a namespace with colons to specify the market or exchange. This is the most typical format used for these instruments in dxFeed services.For crypto pairs, formats like BTC/USD:CXBITS are also used.

Most namespaces in our symbols include market identifier codes (MICs). See the full list of Market Identifier Codes

$SYMBOL

$DJI, $NDX

Commonly used for: indices and market indicators.

The $ prefix indicates index instruments and is required in most cases. Check the IPF web service for the final format

. + OPTION ROOT + VERSION + EXPIRATION DATE + OPTION TYPE + STRIKE: NAMESPACE

.NVDX250314P140:XEUR,

.UNU25C80:XEUE

Commonly used for: equity options, index options, and currency options.

Starts with the . prefix. Includes option root symbol of the underlying instrument, optional version, expiration date (YYMMDD), option type (C/P), strike price, and namespace. Version is an optional field and can be left blank if there is only one version.

Note that this format is also used for OPRA options, but without a namespace

/SYMBOL:NAMESPACE

/FCE:XMON,

/XU030:TR,

/ES:XCME,

/CL:XNYM

Commonly used for: futures products.

Starts with the / prefix. Includes a product code and namespace

/SYMBOL + EXPIRATION (Future contract month code): NAMESPACE

/ESM25:XCME

Commonly used for: futures contracts.

Starts with the / prefix. Includes a product code with expiration code and namespace

./ + FUTURES OPTION ROOT + VERSION + EXPIRATION (Future contract month code) + OPTION TYPE + STRIKE: NAMESPACE

./OG4G25P2965:XCEC,

./EWM25P4850:XCME,

./LOM31P99:XNYM

Commonly used for: futures options.

Starts with the ./ prefix for futures options, including option root, expiration date, option type, strike price, and namespace.

Version is an optional field and can be left blank if there is only one version

BASE CURRENCY/QUOTE CURRENCY: NAMESPACE

EUR/USD:FXCM

Commonly used for: forex, crypto.

Forex currency pairs are typically formatted using the / to separate the base and quote currencies, with a namespace added to specify the provider or market

=/SYMBOL1-/SYMBOL2

=/CLM24 - /CLZ24

Commonly used for: future spreads.

Symbol that defines a futures spread as the difference between two futures contracts with different expiration dates for the same underlying

SYMBOL.ADDITIONAL ATTRIBUTE

AAPL{p=mark, =h},

AAPL{tho=true},

AAPL{=2m,pl=0.2}

Commonly used for: aggregated (chart) data across all asset classes.

Some instruments may have additional attributes that are specified with {} when using API for data requests.

These attributes allow requesting specific types of candlesticks, such as aggregation periods for charting data or custom date ranges. See the candle types page for more details