Introduction
Use the CoinAPI Market Data API through a hosted MCP server with live metadata, quotes, trades, order books, OHLCV, exchange rates, and metrics tools.
Market Data API MCP
The CoinAPI Market Data API is available through a hosted Model Context Protocol (MCP) server. It exposes the API as self-describing tools that MCP-aware clients can inspect and call directly.
Why use MCP?
MCP puts JSON-Schema tool definitions in front of the underlying API so agent runtimes can:
- discover available operations automatically
- validate arguments before sending requests
- reuse your normal
X-CoinAPI-Keyauthentication - work with one hosted endpoint instead of a custom adapter
Server endpoint
https://mcp.md.coinapi.io/mcpUse your regular CoinAPI API key in the X-CoinAPI-Key header.
Only the
/mcpendpoint is supported for this service.
What is available through MCP?
The Market Data MCP server currently exposes 53 tools across these areas:
| Area | What you can do |
|---|---|
| Metadata | Discover assets, exchanges, symbols, chains, mappings, and icon catalogs. |
| Exchange rates | Get spot conversion rates, one-to-many rates, historical rate series, and supported periods. |
| Quotes and trades | Fetch current quotes, recent quote updates, latest trades, and historical executions. |
| Order books | Access L2 snapshots, aggregated depth, recent book history, and L3 order-book views where supported. |
| OHLCV | Retrieve candle history, latest bars, exchange-wide bars, and valid period definitions. |
| Options | Inspect current options chains by exchange. |
| Metrics | Query both classic metrics and V2 external metrics for assets, exchanges, symbols, and chains. |
Typical workflows
Market discovery
- Call
assets_listorexchanges_list. - Narrow down with
symbols_listorsymbols_get_by_exchange. - Use
symbols_get_mappingwhen you need exchange-native symbol IDs.
Realtime market monitoring
- Start from a known
symbol_idsuch asBITSTAMP_SPOT_BTC_USD. - Call
quotes_get_current_by_symbolfor the live bid/ask snapshot. - Call
trades_get_latest_by_symbolfor recent executions. - Call
orderbooks_get_currentororderbooks_get_depthfor liquidity.
Historical analysis
- Call
ohlcv_list_periodsorexchangerate_list_periods. - Use
ohlcv_get_history,quotes_get_history,trades_get_history, orexchangerate_get_history. - Add metrics history tools when you need derived time series.
Live-tested notes
assets_listreturns rich asset metadata including activity windows, volume, icon IDs, and chain addresses.symbols_listcan be filtered by exchange, asset, or symbol fragments to quickly locate validsymbol_idvalues.quotes_get_current_by_symbolreturns bid/ask plus nestedlast_tradedata in one call.ohlcv_get_historyreturns candles in ascending time order.trades_get_latest_by_symbolreturns the newest executions in descending order.exchangerate_get_rateis also available here, so agents can combine symbol-level and asset-level pricing from one MCP server.
Start here
Getting Started
Configure an MCP client, authenticate requests, and run your first live Market Data queries.
Metadata Tools
Reference for assets, exchanges, symbols, chains, mappings, and icon-related MCP tools.
Market Data Tools
Reference for exchange rates, quotes, trades, order books, OHLCV, and options tools.
Metrics Tools
Reference for classic metrics and V2 metrics across assets, exchanges, symbols, and chains.
Messages
All FIX messages are equipped with Standard Header and Trailer, below we will describe what is required in them in accordance with FIX 4.4, the standard that we use.
Getting Started
Connect your MCP client to the CoinAPI Market Data MCP server and run your first metadata, quote, trade, and OHLCV queries.