Get coin rank history
With the coin ranks endpoint you can check out how a coin was ranked throughout its existence
https://api.coinranking.com/v2/coin/:uuid/ranks
Path parameters
| Parameter | Description |
|---|---|
uuid String | UUID of the coin you want to request the rank data for. |
Query parameters
| Parameter | Description |
|---|---|
interval (optional) String |
The interval determines the time period over which each rank item is determined. Default value: dayAllowed values: hour day week month Example:
...coin/Qwsogvtv82FCd/ranks?interval=hour
|
limit (optional) Number |
Limit. Limit the amount of time periods for which the ranks 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/ranks?limit=10
|
Code examples
Response
jsonHTTP/1.1 200 OK
{
"status": "success",
"data": {
"history": [
{
"startingAt": 1698310800,
"tier": "1",
"marketCapRank": "1",
"fullyDilutedMarketCapRank": "1",
"volumeRank": "2",
"priceRank": "2"
},
{
"startingAt": 1698307200,
"tier": "1",
"marketCapRank": "1",
"fullyDilutedMarketCapRank": "1",
"volumeRank": "2",
"priceRank": "2"
}
]
}
}
Response fields
| Property | Description |
|---|---|
status String | Status of the request Allowed values:success |
data Object | |
data.history Object[] | List of rank items |
data.history.startingAt Number | An Epoch timestamp in seconds marking the start of the time period on which the rank values are based. |
data.history.tier String/null | Tier of the coin. We have three distinct tiers. |
data.history.marketCapRank String/null | The rank of the coin based on market cap. This is the rank we use on our website by default. time period |
data.history.fullyDilutedMarketCapRank String/null | The rank of the coin based on fully diluted market cap. Fully diluted market cap is a coin's price multiplied by its max supply. Or total supply if the max supply is not known. |
data.history.volumeRank String/null | Market cap based on its trading volume in the past 24 hours. |
data.history.priceRank String/null | The rank of the coin based on how much US Dollars just one unit of the coin is worth. This metric greatly favors coins with a low supply. |
Error response
jsonHTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Previous
Next