_Crypto Market Metrics_

# Crypto Market Metrics

Access cryptocurrency market metrics through REST APIs, retrieve current and historical metric values, and integrate metric retrieval into AI applications through the CoinAPI MCP Server.

CoinAPI provides standardized market metrics for exchanges, assets, symbols, and blockchain networks to support quantitative research, derivatives analytics, market monitoring, and on-chain analysis.

- [Explore the Docs](/docs)
- [Get Your API Key](https://console.apibricks.io/?link=/apikeys/create)

## What Are Crypto Market Metrics?

Market metrics transform raw market activity into measurable indicators that help explain how cryptocurrency markets behave over time.

Unlike trades, quotes, or order books, which represent individual market events, metrics summarize important characteristics such as derivatives activity, liquidity, trading volume, stablecoin supply, and chain-level analytics.

CoinAPI provides two complementary metrics frameworks. Metrics V1 focuses on exchange-, asset-, and symbol-level market metrics. Metrics V2 introduces a newer framework for asset-, chain-, and exchange-level analytics, including datasets suitable for on-chain and supply-style analysis where available.

Market metrics help reduce the complexity of raw crypto data by turning high-volume activity into easier-to-use signals. Instead of manually calculating liquidity, volume, open interest, funding behavior, or network-related indicators from separate datasets, developers can consume structured metrics that are already organized for analysis. This makes them useful when applications need trend detection, market comparisons, risk monitoring, or broader asset intelligence rather than individual event-level records.

Metrics are also helpful for identifying how market behavior changes across venues, assets, and time periods. For example, researchers can compare exchange activity, liquidity concentration, derivatives positioning, or supply-related trends to understand whether market movement is supported by real participation or driven by short-term noise. These indicators can support dashboards, scoring models, trading signals, due diligence workflows, and institutional reports.

This makes market metrics useful for quantitative research, derivatives monitoring, DeFi analytics, portfolio dashboards, market intelligence platforms, and AI-driven financial applications.

## What's Included in CoinAPI Market Metrics?

Depending on the endpoint and metric family, CoinAPI returns metric identifiers, timestamps, calculated values, and aggregation statistics.

| Field | What it means |
| --- | --- |
| metric_id | Identifier of the requested metric |
| exchange_id | Exchange associated with the metric |
| asset_id | CoinAPI asset identifier when applicable |
| symbol_id | CoinAPI symbol identifier when applicable |
| chain_id | Blockchain network associated with the metric |
| entry_time | Time when the metric entered the CoinAPI system |
| recv_time | Time when CoinAPI received the source data |
| value_decimal | Current metric value |
| time_period_start | Beginning of the aggregation period |
| time_period_end | End of the aggregation period |
| time_open | Timestamp of the first observation in the period |
| time_close | Timestamp of the last observation in the period |
| first_value | First recorded value during the aggregation period |
| last_value | Last recorded value during the aggregation period |
| min_value | Lowest value during the aggregation period |
| max_value | Highest value during the aggregation period |
| count_values | Number of observations included |
| sum_values | Sum of all observations during the aggregation period |

Together, these fields allow developers to analyze historical metric trends, compare exchanges and assets, monitor derivatives markets, evaluate blockchain activity, and build analytical dashboards using standardized CoinAPI identifiers.

## Available REST Endpoints

CoinAPI provides REST endpoints for discovering available metrics, retrieving current metric values, and querying historical metric series across exchanges, assets, symbols, and blockchain networks.

### Metrics Listing

Returns all metric definitions available within the selected Metrics API version.

**Response includes**

- metric identifiers
- metric descriptions

Available for both Metrics V1 and Metrics V2. Use this endpoint to discover supported metric identifiers before requesting metric values.

**Parameters:** None

### Available Metrics by Exchange, Asset, Symbol, or Chain

Returns the metrics available for a specific resource.

**Response includes**

- supported metric identifiers
- associated exchange, asset, symbol, or chain

Metrics V1 supports exchange and symbol listings. Metrics V2 supports exchange, asset, and chain listings.

**Parameters:** exchange_id • asset_id • symbol_id • chain_id

### Current Metrics

Returns the latest available metric values.

**Response includes**

- metric identifier
- timestamps
- current metric value
- associated exchange or asset

Current metric endpoints are available in Metrics V1. API key authentication is required.

**Parameters:** metric_id • exchange_id • asset_id • asset_id_external

### Historical Metrics

Returns aggregated historical metric values over a requested time range.

**Response includes**

- aggregation periods
- opening and closing values
- minimum and maximum values
- observation counts
- aggregated totals

Historical metrics support configurable aggregation periods, with Unix timestamp formats available through time_format. Historical requests support up to 100,000 returned records.

**Parameters:** metric_id • time_start • time_end • period_id • limit • exchange_id / asset_id / chain_id

### Index Snapshots

Returns complete index information at a specific point in time.

**Response includes**

- calculated value
- timestamp
- composition
- supporting metadata

Useful for auditing, reporting, and historical reconstruction.

**Parameters:** index_id • snapshot_time (where supported)

- [Browse Metrics by Exchange](/datasets/metric-id-per-exchange)

## Learn more

Documentation for each way to access this dataset.

- [REST V1](/products/market-data-api/docs/rest-api/metrics-v1/metrics/listing/get)
- [REST V2](/products/market-data-api/docs/rest-api/metrics-v2/marketdata_list_metrics_v2_listing)
- [Flat Files V2](/products/flat-files/docs/datasets/metrics-v2)

## CoinAPI Market Metrics Dataset Characteristics

- Available through the REST API with separate Metrics V1 and Metrics V2 frameworks
- Supports current and historical metric retrieval
- Metrics can be queried at the exchange, asset, symbol, or blockchain level depending on the API version
- Historical metrics support configurable aggregation periods using period_id
- ISO 8601 UTC timestamps
- Optional Unix timestamp output using the time_format parameter
- Standardized CoinAPI identifiers for exchanges, assets, symbols, and chains
- Metric discovery endpoints simplify integration by exposing available metrics before retrieval
- Metrics V1 focuses on classic exchange, asset, and symbol market metrics
- Metrics V2 introduces a newer framework centered around asset-, chain-, and exchange-level analytics, particularly for stablecoin and on-chain datasets

## Why Developers Use Metrics V1 and Metrics V2

CoinAPI provides two complementary metrics frameworks designed for different analytical needs.

Metrics V1 focuses on traditional market metrics collected from exchanges, trading symbols, and assets. Metrics V2 expands the platform with a newer structure designed around asset-, chain-, and exchange-level analytics, particularly for stablecoin and blockchain ecosystem metrics.

| If you need… | Use |
| --- | --- |
| Classic exchange metrics | Metrics V1 |
| Symbol-level market metrics | Metrics V1 |
| Asset-level market metrics | Metrics V1 |
| Derivatives market metrics | Metrics V1 |
| Stablecoin supply metrics | Metrics V2 |
| TVL and protocol metrics | Metrics V2 |
| Chain-level analytics | Metrics V2 |
| Modern on-chain metrics | Metrics V2 |

Many production systems combine both APIs. Developers frequently use Metrics V1 to monitor exchange activity and derivatives markets while using Metrics V2 to analyze blockchain ecosystems, stablecoin circulation, and protocol-level activity.

## Common CoinAPI Market Metrics Use Cases

- Monitor exchange activity
- Analyze derivatives markets
- Track stablecoin supply
- Build DeFi analytics dashboards
- Power AI financial applications
- Research blockchain ecosystems

## Who Uses Crypto Market Metrics?

- Quantitative funds
- Trading platforms
- Financial institutions
- Risk management teams
- DeFi analytics platforms
- AI and machine learning teams

_Crypto Market Metrics_

## Ready to Build with CoinAPI Market Metrics?

Explore the Market Metrics documentation to retrieve current values, historical metric series, exchange metrics, asset metrics, symbol metrics, blockchain metrics, and stablecoin analytics using standardized CoinAPI identifiers.

As your application evolves, combine Market Metrics with Trades, Quotes, Order Books, OHLCV, Exchange Rates, Indexes, Metadata, WebSocket streams, and the CoinAPI MCP Server to build a complete cryptocurrency market data platform on top of the CoinAPI ecosystem.

- [Explore the Market Metrics Documentation](/docs)
- [Get Your API Key](https://console.apibricks.io/?link=/apikeys/create)