API Documentation

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 exchanges

pro This endpoint requires the pro plan or higher

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

GET /exchanges

Query parameters

NameTypeDescription
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

Parameters examples

Response

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

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.statsObject
data.stats.24hVolumeString

Total 24h volume of exchanges in the reference currency

data.stats.totalNumber

Total number of exchanges

data.exchangesObject[]

List of exchanges

data.exchanges.uuidString

UUID of the exchange

data.exchanges.nameString

Name of the exchange

data.exchanges.iconUrlString

Location of the icon

data.exchanges.verifiedBoolean

DEPRECATED Exchanges that are verified to not participate in harmful practices such as wash trading are marked as verified.

data.exchanges.recommendedBoolean

Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges

data.exchanges.numberOfMarketsNumber

Number of markets of the exchange paired with Coinranking

data.exchanges.24hVolumeString

Total volume in 24 hours

data.exchanges.rankNumber

Rank of the exchange based on volume, taking into account exchange and currency filters

data.exchanges.marketShareString

Percentage of the total exchange volume reprented by this exchange.

data.exchanges.coinrankingUrlString

Where to find the exchange on coinranking.com

Error response

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

Error responses

Get exchange

pro This endpoint requires the pro plan or higher

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

GET /exchange/:uuid

Path parameters

NameTypeDescription
uuidString

UUID of the exchange you want to request

Query parameters

NameTypeDescription
referenceCurrencyUuid (optional)String

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

Default value: yhjMzLPhuIDl

Examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "exchange": {
      "numberOfMarkets": 3,
      "24hVolume": "776337030.2052088",
      "uuid": "-zdvbieRdZ",
      "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,
      "recommended": true,
      "lastTickerCreatedAt": 1546959293000,
      "rank": 1,
      "marketShare": "12.2209741947213",
      "coinrankingUrl": "https://coinranking.com/exchange/-zdvbieRdZ+binance"
    }
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.exchangeObject
data.exchange.uuidString

UUID of the exchange

data.exchange.nameString

Name of the exchange

data.exchange.descriptionString

Description of the exchange

data.exchange.iconUrlString

Location of the icon

data.exchange.websiteUrlString

Website URL to the exchange

data.exchange.verifiedBoolean

DEPRECATED A verified exchange is verified to not participate in harmful practices such as wash trading.

data.exchange.recommendedBoolean

Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges

data.exchange.numberOfMarketsNumber

Number of markets of the exchange paired with Coinranking

data.exchange.24hVolumeString

Total volume in 24 hours

data.exchange.lastTickerCreatedAtNumber

Timestamp of the latest ticker

data.exchange.rankNumber

Rank of the exchange based on volume, taking into account exchange and currency filters

data.exchange.marketShareString

Percentage of the total exchange volume reprented by this exchange.

data.exchange.coinrankingUrlString

Where to find the exchange on coinranking.com

Error response

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

Error responses

Get exchange coins

pro This endpoint requires the pro plan or higher

Find coins listed on a specific exchange.

GET /exchange/:uuid/coins

Path parameters

NameTypeDescription
uuidString

UUID of the exchange you want to request

Query parameters

NameTypeDescription
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
search (optional)String

Filter the results by searching for coin names or symbols.

Examples

Parameters examples

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"
      }
    ]
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.statsObject
data.stats.totalNumber

Total number of exchanges

data.coinsObject[]
data.coins.rankString

The rank for this coin in this exchange

data.coins.uuidString

UUID of the coin

data.coins.symbolString

Currency symbol

data.coins.nameString

Name of the coin

data.coins.iconUrlString

Location of the icon

data.coins.priceString

Price of the coin

data.coins.btcPriceString

Price of the coin expressed in Bitcoin.

data.coins.24hVolumeString

24h trade volume

data.coins.numberOfMarketsNumber

The amount of markets this coin is exchanged in on this exchange

data.coins.coinrankingUrlString

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

Get exchange markets

pro This endpoint requires the pro plan or higher

Find markets on a specific exchange.

GET /exchange/:uuid/markets

Path parameters

NameTypeDescription
uuidString

UUID of the exchange you want to request markets for

Query parameters

NameTypeDescription
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

Parameters examples

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",
        "recommended": true
      },
      {
        "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",
        recommended": true
      }
    ]
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.statsObject
data.stats.24hVolumeString

Total 24h volume of exchanges in the reference currency

data.stats.totalNumber

Total number of exchanges

data.marketsObject[]
data.markets.uuidString

UUID of the market

data.markets.activeNumber

If the market is enabled or not

data.markets.baseString

The coin on the left side of the pair, which price is calculated in units of the quote

data.markets.base.symbolString

Symbol of the baseCurrency of the market

data.markets.base.uuidString

UUID of the baseCurrency of the market

data.markets.quoteString

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.uuidString

UUID of the quoteCurrency of the market

data.markets.quote.symbolString

Symbol of the quoteCurrency of the market

data.markets.exchangeString

Exchange this market belongs to

data.markets.exchange.nameString

Name of the exchange

data.markets.exchange.uuidString

UUID of the exchange

data.markets.exchange.iconUrlString

Location of the icon

data.markets.24hVolumeString

24h volume of the latest ticker in the reference currency

data.markets.priceString

Price of the latest ticker in reference currency

data.markets.btcPriceString

Price of the latest ticker expressed in Bitcoin.

data.markets.rankNumber

Rank of the market based on volume, taking into account exchange and currency filters

data.markets.marketShareString

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

data.markets.recommendedBoolean

Whether the market is recommended based on the exchange it belongs to, see https://support.coinranking.com/article/82-recommended-exchanges

Error response

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

Error responses