Get coin supply history
With the coin supplies endpoint you can check out a coin's historical amount of supplies. You can read more about supplies in our FAQ.
https://api.coinranking.com/v2/coin/:uuid/supply-history
Path parameters
| Parameter | Description |
|---|---|
uuid String | UUID of the coin you want to request the supply data for. A UUID is our unique identifier for each coin. You can find them in all our coin endpoints, or look them up in the find UUID page. |
Query parameters
| Parameter | Description |
|---|---|
interval (optional) String |
The interval determines the time period over which each supply item is determined. Default value: dayAllowed values: hour day week month Example:
...coin/Qwsogvtv82FCd/supply-history?interval=hour
|
limit (optional) Number |
Limit. Limit the amount of time periods for which the supplies 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:
...coin/Qwsogvtv82FCd/supply-history?limit=10
|
Code examples
Response
jsonHTTP/1.1 200 OK
{
"status": "success",
"data": {
"history": [
{
"timestamp": 1698624000,
"circulating": "19527731",
"total": "19527731"
},
{
"timestamp": 1698537600,
"circulating": "19526875",
"total": "19526875"
},
{
"timestamp": 1698451200,
"circulating": "19525868",
"total": "19525868"
}
]
}
}
Response fields
| Parameter | Description |
|---|---|
status String | Status of the request Allowed values:success |
data Object | |
data.history Object[] | List of supply items |
data.history.timestamp Number | An Epoch timestamp in seconds |
data.history.circulating String/null | the circulating supply in US Dollars |
data.history.total String/null | the total supply in US Dollars |
Error response
jsonHTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Previous
Next