GET
/
tokens
/
rankings
Token Rankings Latest
curl --request GET \
  --url https://api.amberdata.com/blockchains/tokens/rankings \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "data": [
      {
        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "icon": "https://amberdata.io/digital-assets/tetherusd_usdt.png",
        "changeInPrice": "-0.00074688",
        "changeInPriceHourly": "0.00000000",
        "changeInPriceDaily": "-0.00074688",
        "changeInPriceWeekly": "0.00130082",
        "currentPrice": "1.00076667",
        "decimals": "6",
        "isERC20": true,
        "isERC721": false,
        "isERC777": false,
        "isERC884": false,
        "isERC998": false,
        "marketCap": "17716572000.04991444",
        "liquidMarketCap": "17716572000.04991444",
        "name": "Tether USD",
        "rank": "1",
        "symbol": "USDT",
        "circulatingSupply": "17702999700.27970000",
        "totalSupply": "10166574840.00000000",
        "maxSupply": "0.00000000",
        "tokenVelocity": "0.000023795919845901611442",
        "transactionVolume": "18386",
        "uniqueAddresses": "92070",
        "tradeVolume": "40404622.93326587"
      }
    ]
  }
}

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).

​
timeInterval
string
default:days

The time interval to return the historical data in: by day (days) or by hour (hours).

​
type
string

The type(s) of tokens to include in the rankings (erc20, erc721, erc777, erc884, erc998)

​
page
integer
default:0

The page number to return.

​
size
integer
default:100

Number of records per page. (max 1000)

​
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.