Skip to main content

What market symbol types are supported by CoinAPI?

TypeNameDescription
SPOTFX SpotAgreement to exchange one asset for another one (e.g. Buy BTC for USD)
FUTURESFutures contractFX Spot derivative contract where traders agree to trade fx spot at predetermined future time
OPTIONOption contractFX Spot derivative contract where traders agree to trade right to require buy or sell of fx spot at agreed price on exercise date
PERPETUALPerpetual contractFX Spot derivative contract where traders agree to trade fx spot continously without predetermined future delivery time
INDEXIndexStatistical composite that measures changes in the economy or markets.
CREDITCredit/FundingMargin funding contract. Order book displays lending offers and borrow bids. Price represents the daily rate.
CONTRACTContractRepresents other types of financial instruments(e.g. spreads, interest rate swap)

Our symbols identifiers are created using a pattern that depends on the symbol type:

Typesymbol_id pattern
SPOT{exchange_id}_SPOT_{asset_id_base}_{asset_id_quote}
FUTURES{exchange_id}_FTS_{asset_id_base}_{asset_id_quote}_{YYMMDD of future_delivery_time}
OPTION{exchange_id}_OPT_{asset_id_base}_{asset_id_quote}_{YYMMDD of option_expiration_time}_{option_strike_price}_{option_type_is_call as C/P}
PERPETUAL{exchange_id}_PERP_{asset_id_base}_{asset_id_quote}
INDEX{exchange_id}_IDX_{index_id}
CREDIT{exchange_id}_CRE_{asset_id_base}
CONTRACT{exchange_id}_COT_{contract_id}

To get a list of all symbols, you can use this request: https://rest.coinapi.io/v1/symbols 

To see a list of symbols related to a specific exchange, market, or asset, please see this article: https://docs.coinapi.io/faq/api/How-can-I-see-a-list-of-symbols-related-to-a-specific-exchange-market-or-asset

For more information, please see our documentation: https://docs.coinapi.io/market-data/rest-api/metadata#symbol-identifier