Get global stats

These global statistics tell about the data available on coinranking.

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

Query parameters

Parameter Description
referenceCurrencyUuid (optional) String

UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint

Default value: yhjMzLPhuIDl

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

Code examples

Response

json
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

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

Error responses

Previous

Introduction

 Next

Stats for selection of coins

On this page