Get stats for selection of coins

Get stats for a selection of coins.

GET /stats/coins


https://api.coinranking.com/v2/stats/coins

Query parameters

Parameter Description
referenceCurrencyUuid (optional) String

UUID of reference currency. This is the currency the price is shown in, which defaults to US Dollar.

Default value: yhjMzLPhuIDl

Example:
...stats/coins?referenceCurrencyUuid=5k-_VTxqtCEI
timePeriod (optional) String

Negative changes, positive changes and the change in market cap are influenced by the time period.

Default value: 24h
Allowed values:
1h 3h 12h 24h 7d 30d 3m 1y 3y 5y

Example:
...stats/coins?timePeriod=1y
uuids (optional) Array

UUIDs to filter the list on. If you know the UUIDs of the coins you want to fetch, you can use this filter to get the specific coins. Uuids does not work in combination with tags. If you use both filters, the tag filter takes precedence.

Example:
...stats/coins?uuids[]=razxDUgYGNAdQ&uuids[]=Qwsogvtv82FCd
tags (optional) String

Tags to filter the list on. If you provide a tag, this takes precedence over the uuids filter.

Allowed values:
defi stablecoin nft dex exchange staking dao meme privacy metaverse gaming wrapped layer-1 layer-2 fan-token football-club web3 social

Example:
...stats/coins?tags=defi

Code examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "positiveChanges": 3118,
      "negativeChanges": 3725,
      "numberOfCoins": 31110,
      "volume": "226221134262.99506",
      "volumeShare": "100",
      "marketCap": "1278354560622",
      "marketCapChange": "0.06",
      "marketCapShare": "100",
      "topCurrencySymbol": "BTC",
      "topCurrencyMarketCap": "668081784272",
      "topCurrencyDominance": "52.26"
    }
  }
}

Response fields

PropertyDescription
status String

Status of the request

Allowed values:
success
data Object
data.stats Object
data.stats.positiveChanges Number

The amount of coins within the group that now have a higher price than at the beginning of the selected timeperiod.

data.stats.negativeChanges Number

The amount of coins within the group that now have a lower price than at the beginning of the selected timeperiod.

data.stats.numberOfCoins Number

The amount of coins selected for these stats based on the filters provided. See either the tag or uuids filter for more information about filtering these stats.

data.stats.volume String

The trading volume in US Dollar of the coins within the group, within the time period.

data.stats.volumeShare String

The percentage of trading volume compared to coins outside of the selection. E.g. if you have used the tag filter to only get DeFi coins, this is the percentage of trading volume of DeFi coins compared to all other coins.

data.stats.marketCap String

The market cap in US Dollars of the selected coins.

data.stats.marketCapChange String

The change in market cap in US Dollars of the selected coins, as compared to the beginning of the selected time period.

data.stats.marketCapShare String

Similar to volumeShare, this compares the selection of coins against all other coins, but for market cap.

data.stats.topCurrencySymbol String

The symbol of the currency that currently holds the highest market cap within the selection.

data.stats.topCurrencyMarketCap String

The market cap in US Dollars of the currency that currently holds the highest market cap

data.stats.topCurrencyDominance String

A percentage that tells you how big the biggest coin in the selection is compared to the rest of the selection, measured in market cap.

Error response

HTTP/1.1 404 Not Found
{
  "status": "fail",
  "type": "TAG_NOT_FOUND",
  "message": "Tag not found"
}

Error responses

On this page