Stats

Get global stats

These global statistics tell about the data available on coinranking.

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

Query parameters

NameTypeDescription
referenceCurrencyUuid (optional)String

UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar

Default value: yhjMzLPhuIDl

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "totalCoins": 3220,
    "totalMarkets": 27497,
    "totalExchanges": 190,
    "totalMarketCap": "425992114544",
    "total24hVolume": "23752040073",
    "btcDominance": 39.65
    "bestCoins": [
      {
        "uuid": "razxDUgYGNAdQ",
        "symbol": "ETH",
        "name": "Ethereum",
        "iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
        "coinrankingUrl": "https://coinranking.com/coin/razxDUgYGNAdQ+ethereum-eth"
      },
      {
        "uuid": "Qwsogvtv82FCd",
        "symbol": "BTC",
        "name": "Bitcoin",
        "iconUrl": "https://cdn.coinranking.com/Sy33Krudb/btc.svg",
        "coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc"
      },
      {
        "uuid": "HIVsRcGKkPFtW",
        "symbol": "USDT",
        "name": "Tether",
        "iconUrl": "https://cdn.coinranking.com/mgHqwlCLj/usdt.svg",
        "coinrankingUrl": "https://coinranking.com/coin/HIVsRcGKkPFtW+tetherusd-usdt"
      }
    ],
    "newestCoins": [
      {
        "uuid": "razxDUgYGNAdQ",
        "symbol": "ETH",
        "name": "Ethereum",
        "iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
        "coinrankingUrl": "https://coinranking.com/coin/razxDUgYGNAdQ+ethereum-eth"
      },
      {
        "uuid": "Qwsogvtv82FCd",
        "symbol": "BTC",
        "name": "Bitcoin",
        "iconUrl": "https://cdn.coinranking.com/Sy33Krudb/btc.svg",
        "coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc"
      },
      {
        "uuid": "HIVsRcGKkPFtW",
        "symbol": "USDT",
        "name": "Tether",
        "iconUrl": "https://cdn.coinranking.com/mgHqwlCLj/usdt.svg",
        "coinrankingUrl": "https://coinranking.com/coin/HIVsRcGKkPFtW+tetherusd-usdt"
      }
    ]
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.totalCoinsNumber

Total number of coins

data.totalMarketsNumber

Total amount of markets used for price calculation

data.totalExchangesNumber

Total amount of exchanges paired with Coinranking

data.totalMarketCapString

Market capitalization. Price times circulating supply

data.total24hVolumeString

Total trade volume in 24 hours, calculated in the reference currency

data.btcDominanceNumber

Current percentage of the total crypto market capitalization accounted for by Bitcoin

data.bestCoinsObject[]

List of the three best performing coins in the selected timePeriod

data.bestCoins.uuidString

UUID of the coin

data.bestCoins.symbolString

Currency symbol

data.bestCoins.nameString

Name of the coin

data.bestCoins.iconUrlString

Location of the icon

data.bestCoins.coinrankingUrlString

Where to find the coin on coinranking.com

data.newestCoinsObject[]

List of the three newest coins

data.newestCoins.uuidString

UUID of the coin

data.newestCoins.symbolString

Currency symbol

data.newestCoins.nameString

Name of the coin

data.newestCoins.iconUrlString

Location of the icon

data.newestCoins.coinrankingUrlString

Where to find the coin on coinranking.com

Error response

HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "REFERENCE_UNAVAILABLE",
  "message": "Reference currency not available"
}

Error responses

On this page