Market Data

Get Coins

Get a list of coins. Coins are by default ordered by their rank, which - somewhat simplified - means that they are ordered on marketcap. The response not only returns a list of coins, but also statistics regarding the requested list, such as the volume in the last 24 hours.

GET /v1/utils/coins

Query Parameters

Name	Type	Description
referenceCurrencyUuid	String	UUID of reference currency, in which all the prices are calculated. This includes the price, the change and the sparkline. Defaults to US Dollar
timePeriod	String	By setting the timePeriod the change percentage and sparkline in the response will be calculated accordingly. Allowed values: 1h, 3h, 12h, 24h, 7d, 30d, 3m, 1y, 3y, 5y
symbols	Array	Symbols to filter the list on.
uuids	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.
orderBy	String	Index to order by. All sortings excluding listedAt still take our different tiers of coins into account. Default value: marketCap Allowed values: price, marketCap 24hVolume, change, listedAt
search	String	Filter the results by searching for coin names or symbols.
limit	Number	Limit. Used for pagination. Default value: 50 Size range: 0-100
offset	Number	Offset. Used for pagination.

200: OK

{
  "status": "success",
  "data": {
    "stats": {
      "total": 3,
      "totalCoins": 10000,
      "totalMarkets": 35000,
      "totalExchanges": 300,
      "totalMarketCap": "239393904304",
      "total24hVolume": "503104376.06373006"
    },
    "coins": [
      {
        "uuid": "Qwsogvtv82FCd",
        "symbol": "BTC",
        "name": "Bitcoin",
        "color": "#f7931A",
        "iconUrl": "https://cdn.coinranking.com/Sy33Krudb/btc.svg",
        "marketCap": "159393904304",
        "price": "9370.9993109108",
        "btcPrice": "1",
        "listedAt": 1483228800,
        "change": "-0.52",
        "rank": 1,
        "sparkline": [
          "9515.0454185372",
          "9540.1812284677",
          "9554.2212643043",
          "9593.571539283",
          "9592.8596962985",
          "9562.5310295967",
          "9556.7860427046",
          "9388.823394515",
          "9335.3004209165",
          "9329.4331700521",
          "9370.9993109108"
        ],
        "coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc",
        "24hVolume": "6818750000"
      }
    ]
  }
}

Get Coin

Find information about a specific coin.

GET /v1/utils/coin/{uuid}

Query Parameters

Name	Type	Description
referenceCurrencyUuid	String	UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar.
timePeriod	String	A time period where the change and sparkline are based on Default value: 24h Allowed values: 1h, 3h, 12h, 24h, 7d, 30d, 3m, 1y, 3y, 5y

200: OK

{
  "status": "success",
  "data": {
    "coin": {
      "uuid": "Qwsogvtv82FCd",
      "symbol": "BTC",
      "name": "Bitcoin",
      "description": "Bitcoin is the first decentralized digital currency.",
      "color": "#f7931A",
      "iconUrl": "https://cdn.coinranking.com/Sy33Krudb/btc.svg",
      "websiteUrl": "https://bitcoin.org",
      "links": [
        {
          "name": "Bitcoin",
          "url": "https://www.reddit.com/r/Bitcoin/",
          "type": "reddit"
        }
      ],
      "supply": {
        "confirmed": true,
        "sypplyAt": 1640757180,
        "circulating": "17009275",
        "total": "17009275",
        "max": "21000000"
      },
      "24hVolume": "6818750000",
      "marketCap": "159393904304",
      "fullyDilutedMarketCap": "196790985529",
      "price": "9370.9993109108",
      "btcPrice": "1",
      "priceAt": 1640757180,
      "change": "-0.52",
      "rank": 1,
      "numberOfMarkets": 9800,
      "numberOfExchanges": 190,
      "listedAt": 1483228800,
      "sparkline": [
        "9515.0454185372",
        "9540.1812284677",
        "9554.2212643043",
        "9593.571539283",
        "9592.8596962985",
        "9562.5310295967",
        "9556.7860427046",
        "9388.823394515",
        "9335.3004209165",
        "9329.4331700521",
        "9370.9993109108"
      ],
      "allTimeHigh": {
        "price": "19500.471361532",
        "timestamp": 1513555200
      },
      "coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc"
    }
  }
}

*All the market data are provided by coinranking.com