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
Parameter | Description |
---|---|
uuid String | UUID of the coin you want to request exchanges for |
Parameter | Description |
---|---|
referenceCurrencyUuid (optional) String |
UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDlExample:
...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: 50Size range: 0-5000 Example:
...coin/Qwsogvtv82FCd/exchanges?limit=10
|
offset (optional) Number |
Offset. Used for pagination Default value: 0Example:
...coin/Qwsogvtv82FCd/exchanges?offset=50
|
orderBy (optional) String |
Index to order by. Default is 24h volume. Default value: 24hVolumeAllowed values: 24hVolume price Example:
...coin/Qwsogvtv82FCd/exchanges?orderBy=price
|
orderDirection (optional) String |
Order in ascending or descending order Default value: descAllowed 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
|
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"
}
]
}
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 | |
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 |
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}