Get coin market listings

professional This endpoint requires the professional plan or higher

Get markets on different exchanges that trade a specific coin. On Coinranking, we use this endpoint on our coin market listings page.

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

Path parameters

ParameterDescription
uuid StringUUID of the coin you want to request markets for.

Query parameters

Parameter Description
referenceCurrencyUuid (optional) String

UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint

UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint

Default value: yhjMzLPhuIDl

Example:
...coin/Qwsogvtv82FCd/markets?referenceCurrencyUuid=5k-_VTxqtCEI
limit (optional) Number

Limit. Used for pagination. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan.

Default value: 50
Size range: 0-5000

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

Offset. Used for pagination

Default value: 0

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

Index to sort on. Default is 24h volume.

Default value: 24hVolume
Allowed values:
24hVolume price

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

Order in ascending or descending order

Default value: desc
Allowed values:
desc asc

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

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

Example:
...coin/Qwsogvtv82FCd/markets?search=bitc

Code examples

Response

json
HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "24hVolume": "2795922.586905519",
      "total": 3
    },
    "markets": [
      {
        "uuid": "xk9M2LuHuID5",
        "base": {
          "uuid": "Qwsogvtv82FCd",
          "symbol": "BTC"
        },
        "quote": {
          "uuid": "yhjMzLPhuIDl",
          "symbol": "USD"
        },
        "exchange": {
          "uuid": "-zdvbieRdZ",
          "name": "Binance",
          "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": {
          "uuid": "qn5ZJmPFP",
          "name": "Coinbase Pro",
          "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 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.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.symbol String

Symbol of the quoteCurrency of the market

data.markets.quote.uuid String

UUID 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

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

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

Error responses

Previous

Coin exchange listings

 Next

Coin blockchains

On this page