Get global market cap history
This endpoint requires the professional plan or higher
With the global market caps history endpoint, you can retrieve historical cryptocurrency market capitalization data, enabling you to analyze trends and track market performance over time.
On Coinranking, we use this endpoint on our global market cap chart.
https://api.coinranking.com/v2/stats/global-market-caps
Query parameters
| Parameter | Description |
|---|---|
referenceCurrencyUuid (optional) String |
UUID of coin (either fiat or crypto), in which all the market caps are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDlExample:
...stats/global-market-caps?referenceCurrencyUuid=5k-_VTxqtCEI
|
timePeriod (optional) String |
Timeperiod where the marketCap are based on Default value: 24hAllowed values: 1h 3h 12h 24h 7d 30d 3m 1y 3y 5y Example:
...stats/global-market-caps?timePeriod=1y
|
Code examples
Response
jsonHTTP/1.1 200 OK
{
"status": "success",
"data": [
{
"timestamp": 1743053100,
"marketCap": "2929340825269"
},
{
"timestamp": 1743053400,
"marketCap": "2930113691065"
},
{
"timestamp": 1743053700,
"marketCap": "2926999657324"
}
]
}
Response fields
| Property | Description |
|---|---|
status String |
Status of the request Allowed values:success |
data Object |
|
data.timestamp Number |
An Epoch timestamp in seconds |
data.marketCap Number/null |
The market cap in the reference currency |
Error response
jsonHTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Previous
Next