For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/market-data/get-market-cap-history.md.

Get reported market-cap history

GET
/v1/defi/market/market-data/market-cap/history

Returns an asset's reported market capitalisation in USD over a configurable lookback window, sampled at a configurable resolution.

Each point is the figure the data provider reported at that timestamp. The snapshot is written on the provider's ingest cadence, which is coarser than a minute, so a resolution of at least 1h is what the series can actually fill. Buckets with no snapshot behind them are absent rather than zero.

See the Time Window & Resolution section for the format of window and resolution.

Query Parameters

asset_id?string

Backend asset ID. Mutually exclusive with symbol: exactly one of the two is required, and naming both is a 400.

Formatuuid
symbol?stringDeprecated

Asset symbol to fetch market cap for (e.g. SOL, BTC).

window?string

Lookback period (e.g. 1h, 4h, 1d, 7d, 1M).

Default"1h"
resolution?string

Bucket size (e.g. 5m, 1h, 1d). Must be at least 1h for windows over 1d.

Default"5s"

Response Body

Reported market-cap series for the requested asset

application/json
  1. response
asset_id?string

Backend asset ID

Formatuuid
symbol?string

The asset symbol

window?string

The time window used for the query

resolution?string

The time resolution used for the query

points?array<>

Reported market-cap buckets, oldest first

Example Request
curl -X GET 'https://api.truemarkets.co/v1/defi/market/market-data/market-cap/history'
Example Response
{  "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",  "symbol": "string",  "window": "string",  "resolution": "string",  "points": [    {      "t": "2019-08-24T14:15:22Z",      "market_cap": "string"    }  ]}