API Documentation

Markets

Markets are trading pairs on exchanges, which are places where to trade between two specific cryptocurrencies. E.g. a market with a trading pair of BTC/USDT is a place where people can buy or sell Bitcoins with Tether. The trade activity on these markets is summarized every minute (depending on the exchange) tickers, which includes the exchange rate for those two assets during that minute. This exchange rate is used by coinranking to calculate the price for all listed coins.

Get markets

pro This endpoint requires the pro plan or higher

Get a list of markets. Markets are ranked by their volume over the last 24 hours. Use our filters to get a subset of the markets.

GET /markets

Query parameters

NameTypeDescription
referenceCurrencyUuid (optional)String

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

Default value: yhjMzLPhuIDl
currencyUuid (optional)String

Filter markets with specific currency as either base or quote. Specifying a currencyUuid will also alter how prices are shown: By default all the markets will show the price of the base in the reference currency (e.g. an ETH/BTC market will show the price of ETH). By specifying a currencyUuid the prices of this currency will always be shown, disregarding whether or not this currency represents the base or the quote in the market (e.g. by specifying BTC as currency, both ETH/BTC as BTC/USD markets will show prices of BTC)

toCurrencyUuid (optional)String

Filter markets with specific currency as either base or quote. The toCurrencyUuid will not alter how the prices will be shown, but will keep the base price. This can be combined with the currencyUuid variable to get specific markets.

baseCurrencyUuid (optional)String

Filter markets with specific currency as base

quoteCurrencyUuid (optional)String

Filter markets with specific currency as quote

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

Sort by either 24h volume or price. Only usable when no filters are applied

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

Sort in ascending or descending order. Only usable when no filters are applied.

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

Filter the results by searching for coin names, symbols or exchange names.

Examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "24hVolume": "6554685985.623574",
      "total": 27521
    },
    "markets": [
      {
        "uuid": "xk9M2LuHuID5",
        "base": {
          "uuid": "Qwsogvtv82FCd",
          "symbol": "BTC",
        },
        "quote": {
          "uuid": "yhjMzLPhuIDl",
          "symbol": "USD",
        },
        "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",
        "base": {
          "uuid": "Qwsogvtv82FCd",
          "symbol": "BTC",
        },
        "quote": {
          "uuid": "HIVsRcGKkPFtW",
          "symbol": "USDT",
        },
        "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 markets in the reference currency

data.stats.totalNumber

Total number of markets

data.marketsObject[]

List of markets

data.markets.uuidString

UUID of the market

data.markets.baseString

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

data.markets.base.uuidString

UUID of the baseCurrency of the market

data.markets.base.symbolString

Symbol 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

The 24 hour volume of the base currency in the reference currency which defaults to US Dollar. For example in an ETH/BTC market the volume would be Ethereum in US Dollar.

data.markets.priceString

The latest price of the base currency in the reference currency which defaults to US Dollar. For example in an ETH/BTC market the price would be Ethereum in US Dollar.

data.markets.btcPriceString

The latest price of the base currency 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

Get market

pro This endpoint requires the pro plan or higher

Find information on a specific market listed on coinranking.

GET /market/:uuid

Path parameters

NameTypeDescription
uuidUuid

Uuid of the market you want to request

Query parameters

NameTypeDescription
referenceCurrencyUuid (optional)String

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

Default value: yhjMzLPhuIDl

Examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "market": {
      "uuid": "MP77r-vKf4",
      "rank": 7,
      "base": {
        "uuid": "Qwsogvtv82FCd",
        "symbol": "BTC",
        "name": "Bitcoin",
        "type": "coin",
      },
      "quote": {
        "symbol": "USDT",
        "uuid": "HIVsRcGKkPFtW",
        "name": "Tether",
        "type": "coin",
      },
      "exchange": {
        "name": "Binance",
        "uuid": "-zdvbieRdZ",
        "iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
        "websiteUrl": "https://www.binance.com",
      },
      "latestTicker": {
        "createdAt": 1594808541,
        "close": "10190.495525500779",
        "base24hVolume": "34878",
        "quote24hVolume": "354103375",
      },
      "marketShare": "1.23",
      "price": "9488.518829659914",
      "btcPrice": "1",
      "24hVolume": "353383358.2006244",
      "recommended": true
    }
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.marketObject
data.market.uuidString

Uuid of the market

data.markets.baseString

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

data.market.base.uuidString

Uuid of the baseCurrency of the market

data.market.base.symbolString

Symbol of the baseCurrency of the market

data.market.base.typeString

Indicates if the base of the market is a coin or if it is fiat

Allowed values:
coin fiat
data.market.base.nameString

Name 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.market.quote.uuidString

Uuid of the quoteCurrency of the market

data.market.quote.symbolString

Symbol of the quoteCurrency of the market

data.market.quote.nameString

Name of the quoteCurrency of the market

data.market.quote.typeString

Indicates if the quote of the market is a coin or if it is fiat

Allowed values:
coin fiat
data.markets.exchangeString

Exchange this market belongs to

data.market.exchange.nameString

Name of the exchange

data.market.exchange.uuidString

Uuid of the exchange

data.market.exchange.iconUrlString

Location of the icon

data.market.exchange.websiteUrlString

Url that points to the website of the exchange

data.market.latestTicker.createdAtString

An Epoch timestamp in seconds when the latest ticker was received

data.market.latestTicker.closeString

The last price received from the market

data.market.latestTicker.base24hVolumeString

Moving average of the base volume of the market in the last 24 hours. For example in a BTC/USD market it would be the Bitcoins traded within a 24 hour timespan.

data.market.latestTicker.quote24hVolumeString

Moving average of the quote volume of the market in the last 24 hours. For example in a BTC/USD market it would be the US dollars traded within a 24 hour timespan.

data.market.24hVolumeString

The 24 hour volume of the base currency in the reference currency which defaults to US Dollar. For example in an ETH/BTC market the volume would be Ethereum in US Dollar.

data.market.priceString

The latest price of the base currency in the reference currency which defaults to US Dollar. For example in an ETH/BTC market the price would be Ethereum in US Dollar.

data.market.btcPriceString

The latest price of the base currency in Bitcoin.

data.market.rankNumber

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

data.market.marketShareString

Percentage of the total market volume reprented by this market

data.market.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