🔗 MCP API

Metrics Tools

Reference for the Market Data MCP metrics tools, including classic metrics and V2 external metrics.

Market Data MCP Metrics Tools

The Market Data MCP server exposes two metric families:

Classic metrics (metrics_*) for exchange, symbol, and asset metrics
V2 metrics (metrics_v2_*) for external metrics such as TVL, fees, volumes, and stablecoin-related series

Classic metrics

Listing tools

Tool	Required arguments	Optional arguments	What it does
`metrics_list`	none	none	Lists all classic metric identifiers available in the system.
`metrics_get_current_for_exchange`	`exchange_id`	`metric_id`	Lists available classic metrics for one exchange.
`metrics_get_current_for_symbol`	none	`symbol_id`, `exchange_id`, `metric_id`	Lists available classic metrics for one symbol or symbol context.
`metrics_get_current_for_asset`	none	`asset_id`, `exchange_id`, `asset_id_external`, `metric_id`	Lists available classic metrics for one asset context.

Current values tools

Tool	Required arguments	Optional arguments	What it does
`metrics_get_values_for_exchange`	`exchange_id`	`metric_id`	Returns current metric values for one exchange.
`metrics_get_values_for_symbol`	none	`symbol_id`, `exchange_id`, `metric_id`	Returns current metric values for one symbol context.
`metrics_get_values_for_asset`	none	`asset_id`, `exchange_id`, `metric_id`	Returns current metric values for one asset context.

History tools

Tool	Required arguments	Optional arguments	What it does
`metrics_get_history_for_exchange`	`metric_id`, `exchange_id`	`time_start`, `time_end`, `period_id`, `limit`	Returns exchange metric history.
`metrics_get_history_for_symbol`	`metric_id`, `symbol_id`	`time_start`, `time_end`, `period_id`, `limit`	Returns symbol metric history.
`metrics_get_history_for_asset`	`metric_id`, `exchange_id`	`asset_id`, `asset_id_external`, `time_start`, `time_end`, `period_id`, `limit`	Returns asset metric history in exchange context.

Classic metrics notes

metrics_get_current_for_* tools describe what is available for a given entity.
metrics_get_values_for_* tools return actual current metric values.
History endpoints use period_id plus optional time_start and time_end.
Default limit is 100, with a maximum of 100000.

V2 metrics

Listing tools

Tool	Required arguments	Optional arguments	What it does
`metrics_v2_list`	none	none	Lists all V2 metrics, including external metrics.
`metrics_v2_get_for_exchange`	`exchange_id`	none	Lists V2 metrics available for one exchange.
`metrics_v2_get_for_asset`	`asset_id`	none	Lists V2 metrics available for one stablecoin asset such as `USDC`.
`metrics_v2_get_for_chain`	`chain_id`	none	Lists V2 metrics available for one blockchain such as `ETHEREUM`.

History tools

Tool	Required arguments	Optional arguments	What it does
`metrics_v2_get_history_for_exchange`	`metric_id`, `exchange_id`	`time_start`, `time_end`, `time_format`, `period_id`, `limit`	Returns exchange V2 metric history such as `TVL`, `FEES`, or `VOLUMES`.
`metrics_v2_get_history_for_asset`	`metric_id`, `asset_id`	`time_start`, `time_end`, `time_format`, `period_id`, `limit`	Returns stablecoin metric history such as circulating or bridged supply.
`metrics_v2_get_history_for_chain`	`metric_id`, `chain_id`	`time_start`, `time_end`, `time_format`, `period_id`, `limit`	Returns blockchain metric history such as TVL or stablecoin supply on chain.

V2 metrics notes

V2 metrics cover external or onchain-oriented series that do not fit the classic market-data metric model.
time_format can be omitted for ISO 8601 or set to unix_sec or unix_millisec.
Common V2 metric IDs include TVL, FEES, VOLUMES, STABLES_CIRCULATING_USD, and STABLES_BRIDGED_USD.

Which metrics tool should you use?

Need	Recommended tools
Discover available metric IDs globally	`metrics_list` or `metrics_v2_list`
See which metrics exist for a specific exchange	`metrics_get_current_for_exchange` or `metrics_v2_get_for_exchange`
Read current metric values now	`metrics_get_values_for_exchange`, `metrics_get_values_for_symbol`, or `metrics_get_values_for_asset`
Read historical metric series	`metrics_get_history_for_` or `metrics_v2_get_history_for_`
Work with TVL, fees, volumes, or stablecoin metrics	`metrics_v2_*`

Practical patterns

Explore metrics for one exchange

Call metrics_get_current_for_exchange or metrics_v2_get_for_exchange.
Pick a metric_id.
Call the matching history endpoint for time series analysis.

Analyze a stablecoin

Call metrics_v2_get_for_asset with USDC, USDT, or another supported asset.
Pick a V2 metric such as STABLES_CIRCULATING_USD.
Call metrics_v2_get_history_for_asset.

Compare onchain ecosystems

Call chains_list.
Use metrics_v2_get_for_chain for each chain of interest.
Pull metrics_v2_get_history_for_chain for trend analysis.

Service Status GitHub SDK

Market Data Tools

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

🔗 JSON-RPC API

JSON-RPC proxy for Market Data REST endpoints.

On this page

Market Data MCP Metrics Tools Classic metrics Listing tools Current values tools History tools Classic metrics notes V2 metrics Listing tools History tools V2 metrics notes Which metrics tool should you use?Practical patterns Explore metrics for one exchange Analyze a stablecoin Compare onchain ecosystems