Get list of exchanges
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 Centralized 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: yhjMzLPhuIDlExample:
...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: 50Size range: 0-5000 Example:
...exchanges?limit=10
|
offset (optional) Number |
Offset. Used for pagination. Default value: 0Example:
...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: 24hVolumeAllowed 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: descAllowed 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
|
cursor (optional) String |
Cursor for pagination. Use the
...exchanges?cursor=eyJ0IjoxLC...
|
countries (optional) Array |
Filter exchanges by supported countries using ISO 3166-1 alpha-2 country codes. Returns only exchanges that support trading in at least one of the specified countries. See the country codes reference for a full list of supported codes. Example:
...exchanges?countries[]=US&countries[]=GB
|
fiatCurrencyUuids (optional) Array |
Filter exchanges by fiat currencies they support for trading pairs, using each currency's UUID. Returns only exchanges that support at least one of the specified fiat currencies. You can find fiat currency UUIDs in the reference currencies endpoint using
...exchanges?fiatCurrencyUuids[]=yhjMzLPhuIDl
Multiple values example:
...exchanges?fiatCurrencyUuids[]=yhjMzLPhuIDl&fiatCurrencyUuids[]=5k-_VTxqtCEI
|
Code examples
Response
jsonHTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"24hVolume": "262456688815",
"total": 99
},
"exchanges": [
{
"uuid": "-zdvbieRdZ",
"rank": 3,
"name": "Binance",
"iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
"verified": false,
"recommended": true,
"numberOfMarkets": 1566,
"numberOfCoins": 433,
"marketShare": "5.15",
"coinrankingUrl": "https://coinranking.com/exchange/-zdvbieRdZ+binance",
"24hVolume": "19403991893"
},
{
"uuid": "-4x6SL_Cv",
"rank": 5,
"name": "KuCoin",
"iconUrl": "https://cdn.coinranking.com/A-hAjR-hN/kucoin.png",
"verified": false,
"recommended": true,
"numberOfMarkets": 2399,
"numberOfCoins": 983,
"marketShare": "3.7",
"coinrankingUrl": "https://coinranking.com/exchange/-4x6SL_Cv+kucoin",
"24hVolume": "13922027316"
}
]
},
"pagination": {
"limit": 50,
"hasNextPage": true,
"hasPreviousPage": false,
"nextCursor": "eyJ0IjoxLCJyIjo2OTM5NzYxNzYuOTA2MzQxLCJ1IjoiWEhwOGVDaklEYyIsIm8iOiIyNGhWb2x1bWUiLCJkIjoiZGVzYyJ9",
"previousCursor": null
}
}
Response fields
| Property | Description |
|---|---|
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.numberOfCoins Number | Number of coins 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 |
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
jsonHTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Previous
Next