Get a list of markets. Markets are ranked by their volume over the last 24 hours. Use our filters to get a subset of the markets.
On Coinranking, we use this endpoint on our market ranking page.
https://api.coinranking.com/v2/markets
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:
...markets?referenceCurrencyUuid=5k-_VTxqtCEI
|
limit (optional) Number |
Limit. Used for pagination. Only usable when no filters are applied Default value: 50Size range: 0-5000 Example:
...markets?limit=10
|
offset (optional) Number |
Offset. Used for pagination only usable when no filters are applied Default value: 0Example:
...markets?offset=50
|
orderBy (optional) String |
Sort by either 24h volume or price. Only usable when no filters are applied Default value: 24hVolumeAllowed values: 24hVolume price Example:
...markets?orderBy=price
|
orderDirection (optional) String |
Sort in ascending or descending order. Only usable when no filters are applied. Default value: descAllowed values: desc asc Example:
...markets?orderDirection=asc
|
search (optional) String |
Filter the results by searching for coin names, symbols or exchange names. Example:
...markets?search=bitcoin
|
jsonHTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"24hVolume": "6554685985.623574",
"total": 27521
},
"markets": [
{
"uuid": "xk9M2LuHuID5",
"base": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC"
},
"quote": {
"uuid": "yhjMzLPhuIDl",
"symbol": "USD"
},
"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",
"base": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC"
},
"quote": {
"uuid": "HIVsRcGKkPFtW",
"symbol": "USDT"
},
"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 markets in the reference currency |
data.stats.total Number | Total number of markets |
data.markets Object[] | List of markets |
data.markets.uuid String | UUID of the market |
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.uuid String | UUID of the baseCurrency of the market |
data.markets.base.symbol String | Symbol 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 | The 24 hour volume of the base currency in the reference currency which defaults to US Dollar. For example in an ETH/BTC market the volume would be Ethereum in US Dollar. |
data.markets.price String | The latest price of the base currency in the reference currency which defaults to US Dollar. For example in an ETH/BTC market the price would be Ethereum in US Dollar. |
data.markets.btcPrice String | The latest price of the base currency 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 |
jsonHTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}