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.

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 coin (either fiat or crypto), in which all the prices are calculated. 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/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
cursor (optional) String

Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information.

Example:
...coin/Qwsogvtv82FCd/exchanges?cursor=eyJ0IjoxLC...

Code examples

Response

json
HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "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"
      }
    ]
  },
  "pagination": {
    "limit": 50,
    "hasNextPage": true,
    "hasPreviousPage": false,
    "nextCursor": "eyJ0IjpudWxsLCJyIjoxNzkzOTY2MDI1Ljg4ODk0MDMsInUiOiI4SmxZZ1FNSyIsIm8iOiIyNGhWb2x1bWUiLCJkIjoiZGVzYyJ9",
    "previousCursor": null
  }
}

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

pagination Object

Pagination information. See Pagination for more details.

pagination.limit Number

The number of results per page

pagination.hasNextPage Boolean

Whether there are more results available after the current page

pagination.hasPreviousPage Boolean

Whether there are results available before the current page

pagination.nextCursor String/null

Cursor to use for the next page, or null if there are no more results

pagination.previousCursor String/null

Cursor to use for the previous page, or null if on the first page

Error response

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

Error responses

Previous

Coin gains and losses

 Next

Coin market listings

On this page