Get coin rank history

professional This endpoint requires the professional plan or higher

With the coin ranks endpoint you can check out how a coin was ranked throughout its existence. We have different rankings available for coins; by market cap (which is also the default ranking on coinranking.com), but also by 24 hour volume moving sum, by their sheer price in USD or in the fully diluted market cap. 

https://api.coinranking.com/v2/coin/:uuid/rank-history

Path parameters

ParameterDescription
uuid String

UUID of the coin you want to request the rank 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 rank item is determined.

Default value: day
Allowed values:
hour day week month

Example:
...coin/Qwsogvtv82FCd/rank-history?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: 50
Size range: 0-5000

Example:
...coin/Qwsogvtv82FCd/rank-history?limit=10

Code examples

Response

json
HTTP/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

PropertyDescription
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

json
HTTP/1.1 404 Not Found
{
  "status": "fail",
  "type": "COIN_NOT_FOUND",
  "message": "Coin not found"
}

Error responses

Previous

Coin market cap history

 Next

Coin supply history

On this page