🔗 MCP API

Metadata Tools

Reference for the Market Data MCP tools used to discover assets, exchanges, symbols, chains, and icon catalogs.

Market Data MCP Metadata Tools

Use these tools to discover valid identifiers before calling symbol-level or metric endpoints.

Tool groups

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.

Assets

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.

Notes

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.

Exchanges

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.

Notes

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.

Symbols

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.

Notes

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.

Chains

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`.

Notes

filter_chain_id accepts comma- or semicolon-delimited lists such as ETHEREUM;ARBITRUM.
Chain identifiers are also used by the V2 metrics tools.

Common discovery patterns

Find a valid symbol

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.

Build selectors or watchlists

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.

Reconcile internal and venue IDs

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.

Service Status GitHub SDK

Getting Started

Connect your MCP client to the CoinAPI Market Data MCP server and run your first metadata, quote, trade, and OHLCV queries.

Market Data Tools

Reference for the Market Data MCP tools that expose exchange rates, OHLCV, quotes, trades, order books, and options data.

On this page

Market Data MCP Metadata Tools Tool groups Assets Notes Exchanges Notes Symbols Notes Chains Notes Common discovery patterns Find a valid symbol Build selectors or watchlists Reconcile internal and venue IDs