Get coin exchange listings

professional This endpoint requires the professional plan or higher

Get a list of exchanges where a specific coin can be traded. On Coinranking, we use this endpoint on our coin exchange listings page.

GET /coin/:uuid/exchanges


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

Path parameters

ParameterDescription
uuid StringUUID of the coin you want to request exchanges for

Query parameters

Parameter Description
referenceCurrencyUuid (optional) String

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

Default value: yhjMzLPhuIDl

Example:
...coin/Qwsogvtv82FCd/exchanges?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/exchanges?limit=10
offset (optional) Number

Offset. Used for pagination

Default value: 0

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

Index to order by. Default is 24h volume.

Default value: 24hVolume
Allowed values:
24hVolume price

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

Order in ascending or descending order

Default value: desc
Allowed values:
desc asc

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

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

Example:
...coin/Qwsogvtv82FCd/exchanges?search=binance

Code examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "stats": {
    "24hVolume": "27739840257.811882",
    "total": 278
  },
  "exchanges": [
    {
      "coinrankingUrl": "https://coinranking.com/exchange/Z7wAB_T0o+coinsbit",
      "rank": 1,
      "uuid": "Z7wAB_T0o",
      "verified": false,
      "recommended": false,
      "numberOfMarkets": 22,
      "name": "Coinsbit",
      "iconUrl": "https://cdn.coinranking.com/Xx7PRnP31/coinsbit.svg",
      "24hVolume": "2092377039.0491314",
      "price": "6954.329554998793",
      "btcPrice": "1"
    },
    {
      "coinrankingUrl": "https://coinranking.com/exchange/8JlYgQMK+bkex",
      "rank": 2,
      "uuid": "8JlYgQMK",
      "verified": false,
      "recommended": false,
      "numberOfMarkets": 14,
      "name": "BKEX",
      "iconUrl": "https://cdn.coinranking.com/uNp-AXDRf/BKEX.svg",
      "24hVolume": "1793966025.8889403",
      "price": "6952.4065930949655",
      "btcPrice": "1"
    }
  ]
}

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.exchanges Object
data.exchanges.coinrankingUrl Number

The url to the page on Coinranking for this exchange

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

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

data.exchanges.recommended Boolean

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

data.exchanges.numberOfMarkets Number

Number of markets of the exchange paired with Coinranking

data.exchanges.rank Number

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

data.exchanges.24hVolume String

Total volume in 24 hours

data.exchanges.price String

Price of the chosen coin on this exchange

data.exchanges.btcPrice String

Price of the chosen coin expressed in Bitcoin

Error response

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

Error responses

On this page