Exchanges are a list of hubs where cryptocurrencies are traded. Coinranking calculates the prices of coins based on the trading tickers from these exchanges.
Find information on a specific exchange listed on coinranking. An exchange is a place where cryptocurrencies are traded.
GET /exchange/:uuid
Name | Type | Description |
---|---|---|
uuid | String |
UUID of the exchange you want to request |
Name | Type | Description |
---|---|---|
referenceCurrencyUuid (optional) | String |
UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl |
Example: cURL
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2 \
-H 'x-access-token: your-api-key' \
-G
Example: NodeJs
const request = require('request');
const options = {
method: 'GET',
url: 'https://api.coinranking.com/v2/exchange/xfAXqClCw2',
headers: {
'x-access-token': 'your-api-key'
};
}
request(options, (error, response) => {
if (error) throw new Error(error);
console.log(response.body);
; })
Example: PHP
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.coinranking.com/v2/exchange/xfAXqClCw2",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"x-access-token: your-api-key"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
bash
- referenceCurrencyUuid
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2?referenceCurrencyUuid=5k-_VTxqtCEI \
-H 'x-access-token: your-api-key' \
-G
Name | Type | 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 |
A verified exchange is verified to not participate in harmful practices such as wash trading. |
data.exchange.numberOfMarkets | Number |
Number of markets of the exchange paired with Coinranking |
data.exchange.24hVolume | String |
Total volume in 24 hours |
data.exchange.lastTickerCreatedAt | Number |
Timestamp of the latest ticker |
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 reprented by this exchange. |
data.exchange.coinrankingUrl | String |
Where to find the exchange on coinranking.com |
Response:
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"exchange": {
"numberOfMarkets": 3,
"24hVolume": "776337030.2052088",
"uuid": "xfAXqClCw2",
"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,
"lastTickerCreatedAt": 1546959293000,
"rank": 1,
"marketShare": "12.2209741947213",
"coinrankingUrl": "https://coinranking.com/exchange/-zdvbieRdZ+binance"
}
}
}
404
Name | Type | Description |
---|---|---|
EXCHANGE_NOT_FOUND | Object |
The exchange could not be found. Try another UUID |
422
Name | Type | Description |
---|---|---|
VALIDATION_ERROR | Object |
The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | Object |
The reference currency used in the request is not available. Choose another UUID. |
Response:
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Find coins listed on a specific exchange.
GET /exchange/:uuid/coins
Name | Type | Description |
---|---|---|
uuid | String |
UUID of the exchange you want to request |
Name | Type | Description |
---|---|---|
referenceCurrencyUuid (optional) | String |
UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl |
limit (optional) | Number |
Limit. Used for pagination Default value: 50Size range: 0-100 |
offset (optional) | Number |
Offset. Used for pagination Default value: 0 |
orderBy (optional) | String |
Index to sort on. Default is 24h volume Default value: 24hVolumeAllowed values: 24hVolume price numberOfMarkets |
orderDirection (optional) | String |
order in ascending or descending order Default value: descAllowed values: asc desc |
Example: cURL
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/coins \
-H 'x-access-token: your-api-key' \
-G
Example: NodeJs
const request = require('request');
const options = {
method: 'GET',
url: 'https://api.coinranking.com/v2/exchange/xfAXqClCw2/coins',
headers: {
'x-access-token': 'your-api-key'
};
}
request(options, (error, response) => {
if (error) throw new Error(error);
console.log(response.body);
; })
Example: PHP
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.coinranking.com/v2/exchange/xfAXqClCw2/coins",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"x-access-token: your-api-key"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
bash
- referenceCurrencyUuid
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/coins?referenceCurrencyUuid=5k-_VTxqtCEI \
-H 'x-access-token: your-api-key' \
-G
bash
- limit
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/coins?limit=10 \
-H 'x-access-token: your-api-key' \
-G
bash
- offset
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/coins?limit=50 \
-H 'x-access-token: your-api-key' \
-G
bash
- orderBy
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/coins?orderBy=asc \
-H 'x-access-token: your-api-key' \
-G
bash
- orderDirection
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/coins?orderDirection=asc \
-H 'x-access-token: your-api-key' \
-G
Name | Type | Description |
---|---|---|
status | String |
Status of the request Allowed values: success |
data | Object |
|
data.stats | Object |
|
data.stats.total | Number |
Total number of exchanges |
data.coins | Object[] |
|
data.coins.rank | String |
The rank for this coin in this exchange |
data.coins.uuid | String |
UUID of the coin |
data.coins.symbol | String |
Currency symbol |
data.coins.name | String |
Name of the coin |
data.coins.iconUrl | String |
Location of the icon |
data.coins.price | String |
Price of the coin |
data.coins.btcPrice | String |
Price of the coin expressed in Bitcoin. |
data.coins.24hVolume | String |
24h trade volume |
data.coins.numberOfMarkets | Number |
The amount of markets this coin is exchanged in on this exchange |
data.coins.coinrankingUrl | String |
Where to find the coin on coinranking.com |
Response:
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"total": 3
},
"coins": [
{
"rank": 3,
"uuid": "ETHxDUgYGNAdQ",
"symbol": "ETH",
"name": "Ethereum",
"iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
"price": "203",
"btcPrice": "0.3",
"24hVolume": "380",
"numberOfMarkets": 2,
"coinrankingUrl": "https://coinranking.com/coin/razxDUgYGNAdQ+ethereum-eth"
},
{
"rank": 2,
"uuid": "USDxDUgYGNAdQ",
"symbol": "USDT",
"name": "Tether",
"iconUrl": "https://cdn.coinranking.com/SJs1nH_OZ/usdt.svg",
"price": "1",
"btcPrice": "0.0055573924999568905",
"24hVolume": "2795542.586905519",
"numberOfMarkets": 2,
"coinrankingUrl": "https://coinranking.com/coin/HIVsRcGKkPFtW+tether-usdt"
}
]
}
}
404
Name | Type | Description |
---|---|---|
EXCHANGE_NOT_FOUND | Object |
The exchange could not be found. Try another UUID |
422
Name | Type | Description |
---|---|---|
VALIDATION_ERROR | Object |
The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | Object |
The reference currency used in the request is not available. Choose another UUID. |
Response:
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Find markets on a specific exchange.
GET /exchange/:uuid/markets
Name | Type | Description |
---|---|---|
uuid | String |
UUID of the exchange you want to request markets for |
Name | Type | Description |
---|---|---|
referenceCurrencyUuid (optional) | String |
UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl |
limit (optional) | Number |
Limit. Used for pagination Default value: 50Size range: 0-100 |
offset (optional) | Number |
Offset. Used for pagination Default value: 0 |
orderBy (optional) | String |
Index to sort on. Default is 24h volume. Default value: 24hVolumeAllowed values: 24hVolume price |
orderDirection (optional) | String |
Order in ascending or descending order Default value: descAllowed values: desc asc |
search (optional) | String |
Value to search for within results, e.g. exchange names, currency names, or currency symbols |
Example: cURL
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/markets \
-H 'x-access-token: your-api-key' \
-G
Example: NodeJs
const request = require('request');
const options = {
method: 'GET',
url: 'https://api.coinranking.com/v2/exchange/xfAXqClCw2/markets',
headers: {
'x-access-token': 'your-api-key'
};
}
request(options, (error, response) => {
if (error) throw new Error(error);
console.log(response.body);
; })
Example: PHP
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.coinranking.com/v2/exchange/xfAXqClCw2/markets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"x-access-token: your-api-key"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
bash
- referenceCurrencyUuid
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/markets?referenceCurrencyUuid=5k-_VTxqtCEI \
-H 'x-access-token: your-api-key' \
-G
bash
- limit
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/markets?limit=10 \
-H 'x-access-token: your-api-key' \
-G
bash
- offset
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/markets?offset=50 \
-H 'x-access-token: your-api-key' \
-G
bash
- orderBy
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/markets?orderBy=price \
-H 'x-access-token: your-api-key' \
-G
bash
- orderDirection
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/markets?orderDirection=asc \
-H 'x-access-token: your-api-key' \
-G
bash
- search
curl https://api.coinranking.com/v2/exchange/xfAXqClCw2/markets?search=ethereum \
-H 'x-access-token: your-api-key' \
-G
Name | Type | 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.markets | Object[] |
|
data.markets.uuid | String |
UUID of the market |
data.markets.active | Number |
If the market is enabled or not |
data.markets.base | String |
The coin on the left side of the pair, which price is calculated in units of the quote |
data.markets.base.symbol | String |
Symbol of the baseCurrency of the market |
data.markets.base.uuid | String |
UUID of the baseCurrency of the market |
data.markets.quote | String |
The coin on the right side of the pair. The amount in tickers are how much quote you get for one unit of base. E.g. BTC/USD 10.000 means 1 BTC is traded for 10.000 USD. |
data.markets.quote.uuid | String |
UUID of the quoteCurrency of the market |
data.markets.quote.symbol | String |
Symbol of the quoteCurrency of the market |
data.markets.exchange | String |
Exchange this market belongs to |
data.markets.exchange.name | String |
Name of the exchange |
data.markets.exchange.uuid | String |
UUID of the exchange |
data.markets.exchange.iconUrl | String |
Location of the icon |
data.markets.24hVolume | String |
24h volume of the latest ticker in the reference currency |
data.markets.price | String |
Price of the latest ticker in reference currency |
data.markets.btcPrice | String |
Price of the latest ticker expressed in Bitcoin. |
data.markets.rank | Number |
Rank of the market based on volume, taking into account exchange and currency filters |
data.markets.marketShare | String |
Percentage of the total market volume reprented by this market, taking into account exchange and currency filters |
Response:
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"24hVolume": "2795922.586905519",
"total": 3
},
"markets": [
{
"uuid": "xk9M2LuHuID5",
"active": 1,
"base": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC",
},
"quote": {
"symbol": "USD",
"uuid": "yhjMzLPhuIDl",
},
"exchange": {
"name": "Binance",
"uuid": "-zdvbieRdZ",
"iconUrl": "https://cdn.coinranking.com/d6w2Hj3z0/BitMEX.svg",
},
"24hVolume": "771875964.9750752",
"price": "3842.9444791178726",
"btcPrice": "1",
"rank": 1,
"marketShare": "30.48"
},
{
"uuid": "bn7nTLHHuIq2",
"active": 1,
"base": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC",
},
"quote": {
"symbol": "USDT",
"uuid": "HIVsRcGKkPFtW",
},
"exchange": {
"name": "Coinbase Pro",
"uuid": "qn5ZJmPFP",
"iconUrl": "https://cdn.coinranking.com/Ama6htyHL/coinbase.svg",
},
"24hVolume": "311344830.86823833",
"price": "3869.146354559396",
"btcPrice": "1",
"rank": 2,
"marketShare": "12.35"
}
]
}
}
404
Name | Type | Description |
---|---|---|
EXCHANGE_NOT_FOUND | Object |
The exchange could not be found. Try another UUID |
422
Name | Type | Description |
---|---|---|
VALIDATION_ERROR | Object |
The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | Object |
The reference currency used in the request is not available. Choose another UUID. |
Response:
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Get a list of exchanges. Exchanges are ranked based on their trading volume in the last 24 hours.
GET /exchanges
Name | Type | Description |
---|---|---|
referenceCurrencyUuid (optional) | String |
UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl |
limit (optional) | Number |
Limit. Used for pagination. Only usable when no filters are applied Default value: 50Size range: 0-100 |
offset (optional) | Number |
Offset. Used for pagination. Only usable when no filters are applied Default value: 0 |
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 |
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 |
uuids (optional) | Array |
Exchange UUIDs to filter the exchanges on |
search (optional) | String |
Value to search for within results, e.g. exchange names. |
Example: cURL
curl https://api.coinranking.com/v2/exchanges \
-H 'x-access-token: your-api-key' \
-G
Example: NodeJs
const request = require('request');
const options = {
method: 'GET',
url: 'https://api.coinranking.com/v2/exchanges',
headers: {
'x-access-token': 'your-api-key'
};
}
request(options, (error, response) => {
if (error) throw new Error(error);
console.log(response.body);
; })
Example: PHP
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.coinranking.com/v2/exchanges",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"x-access-token: your-api-key"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
bash
- referenceCurrencyUuid
# By default the volume for exchanges are shown in US Dollar. In this example, EURO
# (5k-_VTxqtCEI) is used as a reference
curl https://api.coinranking.com/v2/exchanges?referenceCurrencyUuid=5k-_VTxqtCEI \
-H 'x-access-token: your-api-key' \
-G
bash
- limit
curl https://api.coinranking.com/v2/exchanges?limit=10 \
-H 'x-access-token: your-api-key' \
-G
bash
- offset
curl https://api.coinranking.com/v2/exchanges?offset=50 \
-H 'x-access-token: your-api-key' \
-G
bash
- orderBy
curl https://api.coinranking.com/v2/exchanges?orderBy=24hVolume \
-H 'x-access-token: your-api-key' \
-G
bash
- orderDirection
curl https://api.coinranking.com/v2/exchanges?orderDirection=asc \
-H 'x-access-token: your-api-key' \
-G
bash
- uuids
curl https://api.coinranking.com/v2/exchanges?uuids[]=-zdvbieRdZ&uuids[]=8FXHCkosV \
-H 'x-access-token: your-api-key' \
-G
bash
- search
curl https://api.coinranking.com/v2/exchanges?search=binance \
-H 'x-access-token: your-api-key' \
-G
Name | Type | 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 |
Exchanges that are verified to not participate in harmful practices such as wash trading are marked as verified. |
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 |
Response:
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"24hVolume": "6554685985.623574",
"total": 198
},
"exchanges": [
{
"coinrankingUrl": "https://coinranking.com/exchange/-zdvbieRdZ+binance",
"uuid": "xfAXqClCw2",
"name": "Binance",
"iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
"numberOfMarkets": 3,
"24hVolume": "776337030.2052088",
"rank": 1,
"marketShare": "12.22",
"verified": true
},
{
"coinrankingUrl": "https://coinranking.com/exchange/XHp8eCjIDc+zb",
"uuid": "fN6bbDs2uGw",
"name": "ZB",
"iconUrl": null,
"lastTickerCreatedAt": 1546960123000,
"numberOfMarkets": 128,
"24hVolume": "693976176.906341",
"rank": 2,
"marketShare": "10.92",
"verified": false
}
]
}
}
422
Name | Type | Description |
---|---|---|
VALIDATION_ERROR | Object |
The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | Object |
The reference currency used in the request is not available. Choose another UUID. |
Response:
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}