Get global stats

These global statistics tell about the data available on coinranking.

GET /stats


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

Query parameters

Parameter Description
referenceCurrencyUuid (optional) String

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

Default value: yhjMzLPhuIDl

Example:
...stats/referenceCurrencyUuid=5k-_VTxqtCEI

Code 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

PropertyDescription
status String

Status of the request

Allowed values:
success
data Object
data.totalCoins Number

Total number of coins

data.totalMarkets Number

Total amount of markets used for price calculation

data.totalExchanges Number

Total amount of exchanges paired with Coinranking

data.totalMarketCap String

Market capitalization. Price times circulating supply

data.total24hVolume String

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

data.btcDominance Number

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

data.bestCoins Object[]

List of the three best performing coins in the selected timePeriod

data.bestCoins.uuid String

UUID of the coin

data.bestCoins.symbol String

Currency symbol

data.bestCoins.name String

Name of the coin

data.bestCoins.iconUrl String

Location of the icon

data.bestCoins.coinrankingUrl String

Where to find the coin on coinranking.com

data.newestCoins Object[]

List of the three newest coins

data.newestCoins.uuid String

UUID of the coin

data.newestCoins.symbol String

Currency symbol

data.newestCoins.name String

Name of the coin

data.newestCoins.iconUrl String

Location of the icon

data.newestCoins.coinrankingUrl String

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