Get list of exchanges

professional This endpoint requires the professional plan or higher

Get a list of exchanges. Exchanges are ranked based on their trading volume in the last 24 hours.

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

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

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:
...exchanges?referenceCurrencyUuid=5k-_VTxqtCEI
limit (optional) Number

Limit. Used for pagination. Only usable when no filters are applied. 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:
...exchanges?limit=10
offset (optional) Number

Offset. Used for pagination.

Default value: 0

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

Order by either 24h volume, number of markets or latest ticker. Ordering can only be done when no filters are applied.

Default value: 24hVolume
Allowed values:
24hVolume numberOfMarkets lastTickerCreatedAt

Example:
...exchanges?orderBy=24hVolume
orderDirection (optional) String

Applies direction to the orderBy query, which can be in ascending or descending order. Only usable when no filters are applied.

Default value: desc
Allowed values:
desc asc

Example:
...exchanges?orderDirection=asc
uuids (optional) Array

Exchange UUIDs to filter the exchanges on.

Example:
...exchanges?uuids[]=-zdvbieRdZ&uuids[]=kKbFzL8Tp70u
search (optional) String

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

Example:
...exchanges?search=binance

Code examples

Response

json
HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "24hVolume": "6554685985.623574",
      "total": 198
    },
    "exchanges": [
      {
        "coinrankingUrl": "https://coinranking.com/exchange/-zdvbieRdZ+binance",
        "uuid": "-zdvbieRdZ",
        "name": "Binance",
        "iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
        "numberOfMarkets": 3,
        "24hVolume": "776337030.2052088",
        "rank": 1,
        "marketShare": "12.22",
        "verified": true,
        "recommended": true
      },
      {
        "coinrankingUrl": "https://coinranking.com/exchange/XHp8eCjIDc+zb",
        "uuid": "XHp8eCjIDc",
        "name": "ZB",
        "iconUrl": null,
        "lastTickerCreatedAt": 1546960123000,
        "numberOfMarkets": 128,
        "24hVolume": "693976176.906341",
        "rank": 2,
        "marketShare": "10.92",
        "verified": false,
        "recommended": false
      }
    ]
  }
}

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[]

List of exchanges

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.24hVolume String

Total volume in 24 hours

data.exchanges.rank Number

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

data.exchanges.marketShare String

Percentage of the total exchange volume reprented by this exchange.

data.exchanges.coinrankingUrl String

Where to find the exchange on coinranking.com

Error response

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

Error responses

Previous

Introduction

 Next

Exchange details

On this page