GET
/
tokens
/
rankings
/
historical
Token Rankings Historical
curl --request GET \
  --url https://api.amberdata.com/blockchains/tokens/rankings/historical \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "metadata": {
      "startDate": 1567371953898,
      "endDate": 1569963953898
    },
    "data": [
      {
        "timestamp": 1567296000000,
        "snapshot": [
          {
            "timestamp": 1567296000000,
            "address": "0x6f259637dcd74c767781e37bc6133cd6a68aa161",
            "changeInPrice": 6.141841602673805,
            "changeInPriceHourly": 6.792411896430253,
            "changeInPriceDaily": 6.141841602673805,
            "changeInPriceWeekly": -14.556832887253165,
            "currentPrice": 4.1209589196,
            "decimals": 18,
            "id": "2502",
            "isERC20": true,
            "isERC721": false,
            "isERC777": false,
            "isERC884": false,
            "isERC998": false,
            "marketCap": 2060479459.8,
            "liquidMarketCap": 1970175964.1730235,
            "name": "HuobiToken",
            "platform": "ethereum",
            "rank": 1,
            "ranking": 1,
            "symbol": "HT",
            "tradeVolume": 2985965.4700927003,
            "circulatingSupply": 478086776.0662507,
            "totalSupply": 500000000,
            "maxSupply": null,
            "tokenVelocity": 0.00002384,
            "transactionVolume": 9798,
            "uniqueAddresses": 2757
          }
        ]
      }
    ]
  }
}

Authorizations

​
x-api-key
string
header
required

Headers

​
x-amberdata-blockchain-id
string

The id of the blockchain

Query Parameters

​
direction
string
default:descending

The sort order in which tokens are ranked (ascending or descending).

​
sortType
string
default:marketCap

The metric used to rank the tokens (changeInPrice, currentPrice, marketCap, tokenVelocity, transactionVolume & uniqueAddresses).

​
topN
string
default:5

Number denominating top ranking tokens to return. Example: If given "5", results with return top 5 token rankings for past timeframe, where there are 5 results per day.

​
startDate
string<date-time>

Returns data after this date (expressed as milliseconds, for example 1590969600000).

​
endDate
string<date-time>

Returns data before this date (expressed as milliseconds, for example 1593561600000).

​
curatedAssets
boolean
default:false

[Optional] Exclude Low marketcap assets from returning. Occasionally, low marketcap assets return in the rankings due to price volatility on DEXes. Change to TRUE to include a curated list of assets.

Response

200
application/json

OK

The response is of type object.