Get historical crypto market cap
This endpoint requires the professional plan or higher
With the crypto market-caps endpoint you can explore historical cryptocurrency market cap data
https://api.coinranking.com/v2/historical/market-caps
Query parameters
| Parameter | Description |
|---|---|
interval (optional) String |
The interval determines the time period over which each market cap item is determined. Default value: dayAllowed values: hour day week month Example:
...historical/marketCaps?interval=hour
|
limit (optional) Number |
Limit. Limit the amount of time periods for which the marketCaps are retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50Size range: 0-5000 Example:
...historical/marketCaps?limit=10
|
Code examples
Response
jsonHTTP/1.1 200 OK
{
"status": "success",
"data": {
"history": [
{
"timestamp": 1735603200,
"marketCap": "3360031406518"
},
{
"timestamp": 1735516800,
"marketCap": "3373890720402"
},
{
"timestamp": 1735430400,
"marketCap": "3450131619321"
},
]
}
}
Response fields
| Property | Description |
|---|---|
status String | Status of the request Allowed values:success |
data Object | |
data.history Object[] | List of market cap items |
data.history.timestamp Number | An Epoch timestamp in seconds |
data.history.marketCap String/null | the market cap in US Dollars |
Error response
jsonHTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "VALIDATION_ERROR",
"message": "limit must be at least 1 and most 5000"
}
Previous
Next