Documentation / New API reference / CoinMarketCap
Get Cmc Trades Market Pair
Reference
Last reviewed 2026-10-07
Recent (last 5 min) trades for a pair.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
market_pair | query | string | Yes | Market pair identifier, e.g. SN0_SN1 or TAO_SN1. Both spellings are accepted here; accepting TAO_SN deliberately differs from the OLD API (#1561). |
Responses
200 — Recent trades for the market pair
| Field | Type | Required | Description |
|---|---|---|---|
[].base_volume | string | Yes | Base (TAO) volume (decimal string). |
[].price | string | Yes | Trade price in TAO (decimal string) — the trade's average execution price, not the subnet pool's spot price (#984). |
[].quote_volume | string | Yes | Quote (alpha) volume (decimal string). |
[].timestamp | integer (int32) | Yes | Trade timestamp (unix seconds). |
[].trade_id | integer (int64) | Yes | Trade identifier (padded block number + event index). |
[].type | string | Yes | Trade side: "Buy" (stake) or "Sell" (unstake). |
400 — Invalid query parameter
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
500 — Internal server error
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.