Get exchange details
Find information on a specific exchange listed on coinranking. An exchange is a place where cryptocurrencies are traded.
On Coinranking, we use this endpoint on our exchange detail page.
https://api.coinranking.com/v2/exchange/:uuid
Path parameters
| Parameter | Description |
|---|---|
uuid String | UUID of the exchange you want to request. |
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:
...exchange/-zdvbieRdZ?referenceCurrencyUuid=5k-_VTxqtCEI
|
Code examples
Response
jsonHTTP/1.1 200 OK
{
"status": "success",
"data": {
"exchange": {
"numberOfMarkets": 3,
"numberOfCoins": 59,
"24hVolume": "776337030.2052088",
"uuid": "-zdvbieRdZ",
"name": "Binance",
"description": "Binance is a blockchain ecosystem cryptocurrency exchange.",
"iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
"websiteUrl": "https://www.binance.com/",
"verified": true,
"recommended": true,
"lastTickerCreatedAt": 1546959293000,
"links": [
{
"name": "binance.com",
"url": "https://www.binance.com/en/register?ref=35424440",
"type": "website"
},
{
"name": "Support",
"url": "https://www.binance.com/en/support",
"type": "website"
},
{
"name": "binance",
"url": "https://www.facebook.com/binance",
"type": "facebook"
}
],
"rank": 1,
"marketShare": "12.2209741947213",
"coinrankingUrl": "https://coinranking.com/exchange/-zdvbieRdZ+binance"
"delistedAt": null,
"notices": [
{
"type":"DELISTED",
"value":"This exchange is inactive on Coinranking. Its data is not up to date."
}
],
"tags": [
"DEX"
]
}
}
}
Response fields
| Property | Description |
|---|---|
status String | Status of the request Allowed values:success |
data Object | |
data.exchange Object | |
data.exchange.uuid String | UUID of the exchange |
data.exchange.name String | Name of the exchange |
data.exchange.description String | Description of the exchange |
data.exchange.iconUrl String | Location of the icon |
data.exchange.websiteUrl String | Website URL to the exchange |
data.exchange.verified Boolean | DEPRECATED A verified exchange is verified to not participate in harmful practices such as wash trading. |
data.exchange.recommended Boolean | Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges |
data.exchange.numberOfMarkets Number | Number of markets of the exchange paired with Coinranking |
data.exchange.numberOfCoins Number | Number of coins listed for this exchange on Coinranking |
data.exchange.24hVolume String | Total volume in 24 hours |
data.exchange.lastTickerCreatedAt Number | Timestamp of the latest ticker |
data.exchange.links Object[] | List of links, like social media pages |
data.exchange.links.name String | Name of the link |
data.exchange.links.url String | Url to the specific link |
data.exchange.links.type String | The type of link Allowed values:website bitcointalk explorer discord facebook github instagram line-messenger linkedin medium qq quora reddit sina-weibo telegram tiktok twitter vkontakte wechat whitepaper youtube etc. |
data.exchange.rank Number | Rank of the exchange based on volume, taking into account exchange and currency filters |
data.exchange.marketShare String | Percentage of the total exchange volume represented by this exchange. |
data.exchange.coinrankingUrl String | Where to find the exchange on coinranking.com |
data.exchange.delistedAt String/null | The date at which an exchange is delisted at Coinranking, which means no new data is being fetched from the exchange. This is done when an exchange ceases to exist or is hard to reach. When the value is null, the exchange is not delisted. |
data.exchange.notices Object[] | List of notices, which signal some important information about the exchange. E.g. that the exchange has been delisted and no new price data is being fetched from it. The notices are in JSON format, and in most cases consist of a "type" property with an important keyword such as "DELISTED", and a more human readable message in a "value" property. |
data.exchange.tags Object[] | List of tags, like "DEX" or "CEX" |
Error response
jsonHTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Previous
Next