Exchanges

Exchanges are a list of hubs where cryptocurrencies are traded. Coinranking calculates the prices of coins based on the trading tickers from these exchanges.

Get exchange

Find information on a specific exchange listed on coinranking. An exchange is a place where cryptocurrencies are traded.

GET /exchange/:uuid

Path parameters

Name Type Description
uuid String

UUID of the exchange you want to request

Query parameters

Name Type Description
referenceCurrencyUuid (optional) String

UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar

Default value: yhjMzLPhuIDl

Examples

Example: cURL

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

Example: NodeJs

const request = require('request');

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

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

Example: PHP

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/exchange/xfAXqClCw2",
    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;

Parameters examples

bash - referenceCurrencyUuid

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

Success response

Name Type Description
status String

Status of the request

Allowed values:
success
data Object
data.exchange Object
data.exchange.uuid String

UUID of the exchange
data.exchange.name String

Name of the exchange
data.exchange.description String

Description of the exchange
data.exchange.iconUrl String

Location of the icon
data.exchange.websiteUrl String

Website URL to the exchange
data.exchange.verified Boolean

A verified exchange is verified to not participate in harmful practices such as wash trading.
data.exchange.numberOfMarkets Number

Number of markets of the exchange paired with Coinranking
data.exchange.24hVolume String

Total volume in 24 hours
data.exchange.lastTickerCreatedAt Number

Timestamp of the latest ticker
data.exchange.rank Number

Rank of the exchange based on volume, taking into account exchange and currency filters
data.exchange.marketShare String

Percentage of the total exchange volume reprented by this exchange.
data.exchange.coinrankingUrl String

Where to find the exchange on coinranking.com

Success response example - Response:

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "exchange": {
      "numberOfMarkets": 3,
      "24hVolume": "776337030.2052088",
      "uuid": "xfAXqClCw2",
      "name": "Binance",
      "description": "Binance is a blockchain ecosystem cryptocurrency exchange.",
      "iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
      "websiteUrl": "https://www.binance.com/",
      "verified": true,
      "lastTickerCreatedAt": 1546959293000,
      "rank": 1,
      "marketShare": "12.2209741947213",
      "coinrankingUrl": "https://coinranking.com/exchange/-zdvbieRdZ+binance"
    }
  }
}

Error response

Error response - 404

Name Type Description
EXCHANGE_NOT_FOUND Object

The exchange could not be found. Try another UUID

Error response - 422

Name Type Description
VALIDATION_ERROR Object

The request could not be validated. The response should provide more details.
REFERENCE_UNAVAILABLE Object

The reference currency used in the request is not available. Choose another UUID.

Error response example - Response:

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

Get exchange coins

Find coins listed on a specific exchange.

GET /exchange/:uuid/coins

Path parameters

Name Type Description
uuid String

UUID of the exchange you want to request

Query parameters

Name Type Description
referenceCurrencyUuid (optional) String

UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar

Default value: yhjMzLPhuIDl
limit (optional) Number

Limit. Used for pagination

Default value: 50
Size range: 0-100
offset (optional) Number

Offset. Used for pagination

Default value: 0
orderBy (optional) String

Index to sort on. Default is 24h volume

Default value: 24hVolume
Allowed values:
24hVolume price numberOfMarkets
orderDirection (optional) String

order in ascending or descending order

Default value: desc
Allowed values:
asc desc

Examples

Example: cURL

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

Example: NodeJs

const request = require('request');

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

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

Example: PHP

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/exchange/xfAXqClCw2/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;

Parameters examples

bash - referenceCurrencyUuid

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

bash - limit

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

bash - offset

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

bash - orderBy

curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/coins?orderBy=asc \
  -H 'x-access-token: your-api-key' \
  -G

bash - orderDirection

curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/coins?orderDirection=asc \
  -H 'x-access-token: your-api-key' \
  -G

Success response

Name Type Description
status String

Status of the request

Allowed values:
success
data Object
data.stats Object
data.stats.total Number

Total number of exchanges
data.coins Object[]
data.coins.rank String

The rank for this coin in this exchange
data.coins.uuid String

UUID of the coin
data.coins.symbol String

Currency symbol
data.coins.name String

Name of the coin
data.coins.iconUrl String

Location of the icon
data.coins.price String

Price of the coin
data.coins.btcPrice String

Price of the coin expressed in Bitcoin.
data.coins.24hVolume String

24h trade volume
data.coins.numberOfMarkets Number

The amount of markets this coin is exchanged in on this exchange
data.coins.coinrankingUrl String

Where to find the coin on coinranking.com

Success response example - Response:

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "total": 3
    },
    "coins": [
      {
        "rank": 3,
        "uuid": "ETHxDUgYGNAdQ",
        "symbol": "ETH",
        "name": "Ethereum",
        "iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
        "price": "203",
        "btcPrice": "0.3",
        "24hVolume": "380",
        "numberOfMarkets": 2,
        "coinrankingUrl": "https://coinranking.com/coin/razxDUgYGNAdQ+ethereum-eth"
      },
      {
        "rank": 2,
        "uuid": "USDxDUgYGNAdQ",
        "symbol": "USDT",
        "name": "Tether",
        "iconUrl": "https://cdn.coinranking.com/SJs1nH_OZ/usdt.svg",
        "price": "1",
        "btcPrice": "0.0055573924999568905",
        "24hVolume": "2795542.586905519",
        "numberOfMarkets": 2,
        "coinrankingUrl": "https://coinranking.com/coin/HIVsRcGKkPFtW+tether-usdt"
      }
    ]
  }
}

Error response

Error response - 404

Name Type Description
EXCHANGE_NOT_FOUND Object

The exchange could not be found. Try another UUID

Error response - 422

Name Type Description
VALIDATION_ERROR Object

The request could not be validated. The response should provide more details.
REFERENCE_UNAVAILABLE Object

The reference currency used in the request is not available. Choose another UUID.

Error response example - Response:

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

Get exchange markets

Find markets on a specific exchange.

GET /exchange/:uuid/markets

Path parameters

Name Type Description
uuid String

UUID of the exchange you want to request markets for

Query parameters

Name Type Description
referenceCurrencyUuid (optional) String

UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar

Default value: yhjMzLPhuIDl
limit (optional) Number

Limit. Used for pagination

Default value: 50
Size range: 0-100
offset (optional) Number

Offset. Used for pagination

Default value: 0
orderBy (optional) String

Index to sort on. Default is 24h volume.

Default value: 24hVolume
Allowed values:
24hVolume price
orderDirection (optional) String

Order in ascending or descending order

Default value: desc
Allowed values:
desc asc
search (optional) String

Value to search for within results, e.g. exchange names, currency names, or currency symbols

Examples

Example: cURL

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

Example: NodeJs

const request = require('request');

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

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

Example: PHP

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/exchange/xfAXqClCw2/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;

Parameters examples

bash - referenceCurrencyUuid

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

bash - limit

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

bash - offset

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

bash - orderBy

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

bash - orderDirection

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

bash - search

curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/markets?search=ethereum \
  -H 'x-access-token: your-api-key' \
  -G

Success response

Name Type Description
status String

Status of the request

Allowed values:
success
data Object
data.stats Object
data.stats.24hVolume String

Total 24h volume of exchanges in the reference currency
data.stats.total Number

Total number of exchanges
data.markets Object[]
data.markets.uuid String

UUID of the market
data.markets.active Number

If the market is enabled or not
data.markets.base String

The coin on the left side of the pair, which price is calculated in units of the quote
data.markets.base.symbol String

Symbol of the baseCurrency of the market
data.markets.base.uuid String

UUID of the baseCurrency of the market
data.markets.quote String

The coin on the right side of the pair. The amount in tickers are how much quote you get for one unit of base. E.g. BTC/USD 10.000 means 1 BTC is traded for 10.000 USD.
data.markets.quote.uuid String

UUID of the quoteCurrency of the market
data.markets.quote.symbol String

Symbol of the quoteCurrency of the market
data.markets.exchange String

Exchange this market belongs to
data.markets.exchange.name String

Name of the exchange
data.markets.exchange.uuid String

UUID of the exchange
data.markets.exchange.iconUrl String

Location of the icon
data.markets.24hVolume String

24h volume of the latest ticker in the reference currency
data.markets.price String

Price of the latest ticker in reference currency
data.markets.btcPrice String

Price of the latest ticker expressed in Bitcoin.
data.markets.rank Number

Rank of the market based on volume, taking into account exchange and currency filters
data.markets.marketShare String

Percentage of the total market volume reprented by this market, taking into account exchange and currency filters

Success response example - Response:

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "24hVolume": "2795922.586905519",
      "total": 3
    },
    "markets": [
      {
        "uuid": "xk9M2LuHuID5",
        "active": 1,
        "base": {
          "uuid": "Qwsogvtv82FCd",
          "symbol": "BTC",
        },
        "quote": {
          "symbol": "USD",
          "uuid": "yhjMzLPhuIDl",
        },
        "exchange": {
          "name": "Binance",
          "uuid": "-zdvbieRdZ",
          "iconUrl": "https://cdn.coinranking.com/d6w2Hj3z0/BitMEX.svg",
        },
        "24hVolume": "771875964.9750752",
        "price": "3842.9444791178726",
        "btcPrice": "1",
        "rank": 1,
        "marketShare": "30.48"
      },
      {
        "uuid": "bn7nTLHHuIq2",
        "active": 1,
        "base": {
          "uuid": "Qwsogvtv82FCd",
          "symbol": "BTC",
        },
        "quote": {
          "symbol": "USDT",
          "uuid": "HIVsRcGKkPFtW",
        },
        "exchange": {
          "name": "Coinbase Pro",
          "uuid": "qn5ZJmPFP",
          "iconUrl": "https://cdn.coinranking.com/Ama6htyHL/coinbase.svg",
        },
        "24hVolume": "311344830.86823833",
        "price": "3869.146354559396",
        "btcPrice": "1",
        "rank": 2,
        "marketShare": "12.35"
      }
    ]
  }
}

Error response

Error response - 404

Name Type Description
EXCHANGE_NOT_FOUND Object

The exchange could not be found. Try another UUID

Error response - 422

Name Type Description
VALIDATION_ERROR Object

The request could not be validated. The response should provide more details.
REFERENCE_UNAVAILABLE Object

The reference currency used in the request is not available. Choose another UUID.

Error response example - Response:

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

Get exchanges

Get a list of exchanges. Exchanges are ranked based on their trading volume in the last 24 hours.

GET /exchanges

Query parameters

Name Type Description
referenceCurrencyUuid (optional) String

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

Default value: yhjMzLPhuIDl
limit (optional) Number

Limit. Used for pagination. Only usable when no filters are applied

Default value: 50
Size range: 0-100
offset (optional) Number

Offset. Used for pagination. Only usable when no filters are applied

Default value: 0
orderBy (optional) String

Order by either 24h volume, number of markets or latest ticker. Ordering can only be done when no filters are applied

Default value: 24hVolume
Allowed values:
24hVolume numberOfMarkets lastTickerCreatedAt
orderDirection (optional) String

Applies direction to the orderBy query, which can be in ascending or descending order. Only usable when no filters are applied

Default value: desc
Allowed values:
desc asc
uuids (optional) Array

Exchange UUIDs to filter the exchanges on
search (optional) String

Value to search for within results, e.g. exchange names.

Examples

Example: cURL

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

Example: NodeJs

const request = require('request');

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

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

Example: PHP

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/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;

Parameters examples

bash - referenceCurrencyUuid

# By default the 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/exchanges?referenceCurrencyUuid=5k-_VTxqtCEI \
  -H 'x-access-token: your-api-key' \
  -G

bash - limit

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

bash - offset

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

bash - orderBy

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

bash - orderDirection

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

bash - uuids

curl https://api.coinranking.com/v2/exchanges?uuids[]=-zdvbieRdZ&uuids[]=8FXHCkosV \
  -H 'x-access-token: your-api-key' \
  -G

bash - search

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

Success response

Name Type Description
status String

Status of the request

Allowed values:
success
data Object
data.stats Object
data.stats.24hVolume String

Total 24h volume of exchanges in the reference currency
data.stats.total Number

Total number of exchanges
data.exchanges Object[]

List of exchanges
data.exchanges.uuid String

UUID of the exchange
data.exchanges.name String

Name of the exchange
data.exchanges.iconUrl String

Location of the icon
data.exchanges.verified Boolean

Exchanges that are verified to not participate in harmful practices such as wash trading are marked as verified.
data.exchanges.numberOfMarkets Number

Number of markets of the exchange paired with Coinranking
data.exchanges.24hVolume String

Total volume in 24 hours
data.exchanges.rank Number

Rank of the exchange based on volume, taking into account exchange and currency filters
data.exchanges.marketShare String

Percentage of the total exchange volume reprented by this exchange.
data.exchanges.coinrankingUrl String

Where to find the exchange on coinranking.com

Success response example - Response:

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "24hVolume": "6554685985.623574",
      "total": 198
    },
    "exchanges": [
      {
        "coinrankingUrl": "https://coinranking.com/exchange/-zdvbieRdZ+binance",
        "uuid": "xfAXqClCw2",
        "name": "Binance",
        "iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
        "numberOfMarkets": 3,
        "24hVolume": "776337030.2052088",
        "rank": 1,
        "marketShare": "12.22",
        "verified": true
      },
      {
        "coinrankingUrl": "https://coinranking.com/exchange/XHp8eCjIDc+zb",
        "uuid": "fN6bbDs2uGw",
        "name": "ZB",
        "iconUrl": null,
        "lastTickerCreatedAt": 1546960123000,
        "numberOfMarkets": 128,
        "24hVolume": "693976176.906341",
        "rank": 2,
        "marketShare": "10.92",
        "verified": false
      }
    ]
  }
}

Error response

Error response - 422

Name Type Description
VALIDATION_ERROR Object

The request could not be validated. The response should provide more details.
REFERENCE_UNAVAILABLE Object

The reference currency used in the request is not available. Choose another UUID.

Error response example - Response:

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