Coins

curl https://api.coinranking.com/v2/coins \
  -H 'x-access-token: your-api-key' \
  -G

const request = require('request');

const options = {
  method: 'GET',
  url: 'https://api.coinranking.com/v2/coins',
  headers: {
    'x-access-token': 'your-api-key'
  }
};

request(options, (error, response) => {
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/coins",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
      "x-access-token: your-api-key"
    ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

# By default the coins are shown in US Dollar. In this example, the coins use Bitcoin as a
# reference
curl https://api.coinranking.com/v2/coins?referenceCurrencyUuid=Qwsogvtv82FCda \
  -H 'x-access-token: your-api-key' \
  -G

# this example the timePeriod is set to 7 days, so the change will compare the current price
with the price seven days ago. The sparkline will show averages of the data for the last seven
days
curl https://api.coinranking.com/v2/coins?timePeriod=7d \
  -H 'x-access-token: your-api-key' \
  -G

# In this example the coins are filtered on the symbols of Bitcoin, Ethereum and Ripple. Do
# note that symbols are not unique, and coins other than Bitcoin that also use BTC as symbol
# might show up in the results at some point.
curl 'https://api.coinranking.com/v2/coins?symbols[]=BTC&symbols[]=ETH&symbols=XRP'
  -H 'x-access-token: your-api-key' \
  -G

# this example the list is filtered to only fetch Ethereum (razxDUgYGNAdQ) and Bitcoin
# (Qwsogvtv82FCd)
curl 'https://api.coinranking.com/v2/coins?uuids[]=razxDUgYGNAdQ&uuids[]=Qwsogvtv82FCd'
  -H 'x-access-token: your-api-key' \
  -G

# this example the list is filtered to only return coins in tier 1 and 3
curl 'https://api.coinranking.com/v2/coins?tiers[]=1&tiers[]=2'
  -H 'x-access-token: your-api-key' \
  -G

# this example the list is filtered to only return coins with the tag 'DeFi'
curl 'https://api.coinranking.com/v2/coins?tags[]=defi'
  -H 'x-access-token: your-api-key' \
  -G

# In this example the coins are ordered by price, whereas the default is the marketCap
curl 'https://api.coinranking.com/v2/coins?orderBy=price'
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coins?search=bitcoin \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coins?scopeId=24hVolume&scopeLimit=100 \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coins?scopeLimit=250&scopeId=marketCap \
  -H 'x-access-token: your-api-key' \
  -G

# Sorts the coins in ascending order. If you use this query in combination with orderBy
# you might for example sort all the coins from the lowest price to the highest
curl 'https://api.coinranking.com/v2/coins?orderDirection=asc'
  -H 'x-access-token: your-api-key' \
  -G

curl 'https://api.coinranking.com/v2/coins?limit=10'
  -H 'x-access-token: your-api-key' \
  -G

curl 'https://api.coinranking.com/v2/coins?offset=50'
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd \
  -H 'x-access-token: your-api-key' \
  -G

const request = require('request');

const options = {
  method: 'GET',
  url: 'https://api.coinranking.com/v2/coin/Qwsogvtv82FCd',
  headers: {
    'x-access-token': 'your-api-key'
  }
};

request(options, (error, response) => {
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/coin/Qwsogvtv82FCd",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
      "x-access-token: your-api-key"
    ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd?referenceCurrencyUuid=5k-_VTxqtCEI \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd?timePeriod=1y \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/price \
  -H 'x-access-token: your-api-key' \
  -G

const request = require('request');

const options = {
  method: 'GET',
  url: 'https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/price',
  headers: {
    'x-access-token': 'your-api-key'
  }
};

request(options, (error, response) => {
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php

  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/price",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
      "x-access-token: your-api-key"
    ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

# By default the price is shown in US Dollar. In this example EURO (5k-_VTxqtCEI) is used as a
# reference
curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/price?referenceCurrencyUuid=5k-_VTxqtCEI \
  -H 'x-access-token: your-api-key' \
  -G

# In this example the price for Bitcoin is returned on May 1, 2020. Withouth the timestamp
# parameter the current price would be returned
curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/price?timestamp=1588349307 \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/history \
  -H 'x-access-token: your-api-key' \
  -G

const request = require('request');

const options = {
  method: 'GET',
  url: 'https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/history',
  headers: {
    'x-access-token': 'your-api-key'
  }
};

request(options, (error, response) => {
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/history",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
      CURLOPT_HTTPHEADER => array(
        "x-access-token: your-api-key"
      ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/history?timePeriod=1y \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/history?referenceCurrencyUuid=5k-_VTxqtCEI \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/ohlc \
  -H 'x-access-token: your-api-key' \
  -G

const request = require('request');

const options = {
  method: 'GET',
  url: 'https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/ohlc',
  headers: {
    'x-access-token': 'your-api-key'
  }
};

request(options, (error, response) => {
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/ohlc",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
      CURLOPT_HTTPHEADER => array(
        "x-access-token: your-api-key"
      ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/ohlc?interval=hour \
  -H 'x-access-token: your-api-key' \
  -G

curl 'https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/ohlc?limit=10 \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/ohlc?referenceCurrencyUuid=5k-_VTxqtCEI \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/exchanges \
  -H 'x-access-token: your-api-key' \
  -G

const request = require('request');

const options = {
  method: 'GET',
  url: 'https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/exchanges',
  headers: {
    'x-access-token': 'your-api-key'
  }
};

request(options, (error, response) => {
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/exchanges",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
      "x-access-token: your-api-key"
    ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

# By default the prices and volume for exchanges are shown in US Dollar. In this example,
# EURO (5k-_VTxqtCEI) is used as a reference
curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/exchanges?referenceCurrencyUuid=5k-_VTxqtCEI \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/exchanges/Qwsogvtv82FCd?limit=10 \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/exchanges?offset=50 \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/exchanges?orderBy=price \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/exchanges?orderDirection=asc \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/exchanges?search=binance \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/markets
  -H 'x-access-token: your-api-key' \
  -G

const request = require('request');

const options = {
  method: 'GET',
  url: 'https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/markets',
  headers: {
    'x-access-token': 'your-api-key'
  }
};

request(options, (error, response) => {
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/markets",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
      "x-access-token: your-api-key"
    ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/markets?referenceCurrencyUuid=5k-_VTxqtCEI \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/markets?limit=10 \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/markets?offset=50 \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/markets?orderBy=price \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/markets?orderDirection=asc \
  -H 'x-access-token: your-api-key' \
  -G

# The query parameter can be used to find only markets that have token in the exchange name,
# or in the symbol or name of the assets. E.g. Basic Attention Token or Tokens.net
curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/markets?search=token \
  -H 'x-access-token: your-api-key' \
  -G

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/supply

curl https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/supply

curl https://api.coinranking.com/v2/coin/cVaOmQWainv7g/issuance-blockchains

curl https://api.coinranking.com/v2/coin/cVaOmQWainv7g/issuance-blockchains

curl https://api.coinranking.com/v2/coin/cVaOmQWainv7g/issuance-blockchains?limit=10

curl https://api.coinranking.com/v2/coin/cVaOmQWainv7g/issuance-blockchains?offset=50

curl https://api.coinranking.com/v2/coin/cVaOmQWainv7g/modifiers

curl https://api.coinranking.com/v2/coin/cVaOmQWainv7g/modifiers

curl https://api.coinranking.com/v2/coin/cVaOmQWainv7g/modifiers?limit=10

curl https://api.coinranking.com/v2/coin/cVaOmQWainv7g/modifiers?offset=50

# In this example the coins are ordered by amount, whereas the default is the createdAt
curl 'https://api.coinranking.com/v2/coins/cVaOmQWainv7g?orderBy=amount'
  -H 'x-access-token: your-api-key' \
  -G

# Sorts the modifiers in ascending order. If you use this query in combination with orderBy
# you might for example sort all the modifiers from the lowest amount to the highest
curl 'https://api.coinranking.com/v2/coins/cVaOmQWainv7g?orderBy=amount&orderDirection=asc'
  -H 'x-access-token: your-api-key' \
  -G