🔗 MCP API
Metadata Tools
Reference for the Market Data MCP tools used to discover assets, exchanges, symbols, chains, and icon catalogs.
Use these tools to discover valid identifiers before calling symbol-level or metric endpoints.
| Group | Tools | Purpose |
|---|
| Assets | assets_list, assets_get_by_id, assets_get_icons | Discover supported assets, inspect one asset, and fetch icon URLs. |
| Exchanges | exchanges_list, exchanges_get_by_id, exchanges_get_icons | Browse supported venues and exchange icon catalogs. |
| Symbols | symbols_list, symbols_get_by_exchange, symbols_get_active, symbols_get_history, symbols_get_mapping | Find valid trading pairs, active listings, delisted listings, and exchange-native symbol mappings. |
| Chains | chains_list, chains_get_by_id | Discover supported blockchain networks and inspect one chain. |
| Tool | Required arguments | Optional arguments | What it returns |
|---|
assets_list | none | filter_asset_id | Aggregated asset catalog across the Market Data universe. |
assets_get_by_id | asset_id | none | Detailed metadata for one asset such as BTC, ETH, or USD. |
assets_get_icons | size | none | Icon URLs for all assets at the requested size. |
filter_asset_id accepts comma- or semicolon-delimited lists such as BTC;ETH;USD.assets_list returns broad metadata including name, crypto flag, activity windows, icon ID, volume fields, and sometimes chain addresses.assets_get_icons supports sizes 16, 32, 48, 64, 128, 256, and 512.
| Tool | Required arguments | Optional arguments | What it returns |
|---|
exchanges_list | none | filter_exchange_id | Aggregated exchange catalog. |
exchanges_get_by_id | exchange_id | none | Detailed metadata for one exchange. |
exchanges_get_icons | size | none | Icon URLs for all exchanges at the requested size. |
filter_exchange_id accepts comma- or semicolon-delimited lists such as BINANCE;COINBASE.- Exchange responses typically include website, name, data availability ranges, symbol counts, and recent volume summaries.
exchanges_get_icons supports the same size set as assets_get_icons.
| Tool | Required arguments | Optional arguments | What it returns |
|---|
symbols_list | none | filter_exchange_id, filter_symbol_id, filter_asset_id | Global symbol catalog across exchanges and product types. |
symbols_get_by_exchange | exchange_id | filter_symbol_id, filter_asset_id | Trading symbols for one exchange. |
symbols_get_active | exchange_id | filter_symbol_id, filter_asset_id | Currently active listings for one exchange. |
symbols_get_history | exchange_id | page, limit | Historical or delisted symbols for one exchange. |
symbols_get_mapping | exchange_id | none | Mapping between CoinAPI symbol_id values and exchange-native symbol identifiers. |
symbol_id values such as BITSTAMP_SPOT_BTC_USD are the key inputs for quotes, trades, order books, and OHLCV tools.filter_symbol_id matches fragments like BTC_USD.filter_asset_id is useful for finding all markets related to one asset.symbols_get_history is paginated with page starting at 1.
| Tool | Required arguments | Optional arguments | What it returns |
|---|
chains_list | none | filter_chain_id | Supported blockchain networks. |
chains_get_by_id | chain_id | none | Detailed metadata for one chain such as ETHEREUM or ARBITRUM. |
filter_chain_id accepts comma- or semicolon-delimited lists such as ETHEREUM;ARBITRUM.- Chain identifiers are also used by the V2 metrics tools.
- Call
exchanges_list or exchanges_get_by_id.
- Call
symbols_get_by_exchange or symbols_list.
- Reuse the returned
symbol_id in quote, trade, order-book, or OHLCV tools.
- Call
assets_list for labels and asset IDs.
- Call
assets_get_icons or exchanges_get_icons for images.
- Cache those responses because metadata changes less often than market snapshots.
- Use
symbols_get_mapping with a specific exchange_id.
- Store both CoinAPI
symbol_id and symbol_id_exchange if you also interact with native exchange systems.
