Get list of markets

professional This endpoint requires the professional 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.

On Coinranking, we use this endpoint on our market ranking page.

GET /markets


https://api.coinranking.com/v2/markets

Query parameters

Parameter Description
referenceCurrencyUuid (optional) String

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

Default value: yhjMzLPhuIDl

Example:
...markets?referenceCurrencyUuid=5k-_VTxqtCEI
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).

Example:
...markets?currencyUuid=razxDUgYGNAdQ
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.

Example:
...markets?toCurrencyUuid=razxDUgYGNAdQ
baseCurrencyUuid (optional) String

Filter markets with specific currency as base

Example:
...markets?baseCurrencyUuid=razxDUgYGNAdQ
quoteCurrencyUuid (optional) String

Filter markets with specific currency as quote

Example:
...markets?quoteCurrencyUuid=razxDUgYGNAdQ
limit (optional) Number

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

Default value: 50
Size range: 0-5000

Example:
...markets?limit=10
offset (optional) Number

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

Default value: 0

Example:
...markets?offset=50
orderBy (optional) String

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

Default value: 24hVolume
Allowed values:
24hVolume price

Example:
...markets?orderBy=price
orderDirection (optional) String

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

Default value: desc
Allowed values:
desc asc

Example:
...markets?orderDirection=asc
search (optional) String

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

Example:
...markets?search=asc

Code 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,
        "filters": []
      },
      {
        "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,
        "filters": []
      }
    ]
  }
}

Response fields

PropertyDescription
status String

Status of the request

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

Total 24h volume of markets in the reference currency

data.stats.total Number

Total number of markets

data.markets Object[]

List of markets

data.markets.uuid String

UUID of the market

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.uuid String

UUID of the baseCurrency of the market

data.markets.base.symbol String

Symbol 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

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.price String

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.btcPrice String

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

data.markets.recommended Boolean

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

data.markets.filters String[]

An array of filters that are applied to the market. Most of the filters will cause the market to not be included in the price calculation of the coins.

Allowed values:
PREV_FACTOR EXTERNAL_ZSCORE GEO OUTSIDE_TOP_20

Error response

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

Error responses

On this page