Find markets on a specific exchange. On Coinranking, we use this endpoint on our exchange markets page.
GET /exchange/:uuid/markets
https://api.coinranking.com/v2/exchange/:uuid/markets
Parameter | Description |
---|---|
uuid String | UUID of the exchange. |
Parameter | Description |
---|---|
referenceCurrencyUuid (optional) String |
UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDlExample:
...exchange/-zdvbieRdZ/markets?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:
...exchange/-zdvbieRdZ/markets?limit=10
|
offset (optional) Number |
Offset. Used for pagination Default value: 0Example:
...exchange/-zdvbieRdZ/markets?offset=50
|
orderBy (optional) String |
Index to sort on. Default is 24h volume. Default value: 24hVolumeAllowed values: 24hVolume price Example:
...exchange/-zdvbieRdZ/markets?orderBy=price
|
orderDirection (optional) String |
Order in ascending or descending order Default value: descAllowed values: desc asc Example:
...exchange/-zdvbieRdZ/markets?orderDirection=asc
|
search (optional) String |
Value to search for within results, e.g. exchange names, currency names, or currency symbols Example:
...exchange/-zdvbieRdZ/markets?search=ethereum
|
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",
"recommended": true,
"filters": []
},
{
"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",
"recommended": true,
"filters": []
}
]
}
}
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.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 |
data.markets.recommended Boolean | Whether the market is recommended based on the exchange it belongs to, see https://support.coinranking.com/article/82-recommended-exchanges |
data.markets.filters String[] | An array of filters that are applied to the market. Most of the filters will cause the market to not be included in the price calculation of the coins. Allowed values:PREV_FACTOR EXTERNAL_ZSCORE GEO OUTSIDE_TOP_20 |
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}