Search suggestions are a quick and easy way to find data on coinranking. The endpoint only accepts one parameter; a query. With this query you can find currencies (including fiat), exchanges and markets, by their symbol or name. The response always returns a set of the most prominent coins, exchanges and markets matching your query.
GET /search-suggestions
https://api.coinranking.com/v2/search-suggestions
| Name | Type | Description |
|---|---|---|
| query (optional) | String | Value to search on |
| referenceCurrencyUuid (optional) | String | UUID of reference currency, in which the coin prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl |
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"coins": [
{
"uuid": "Qwsogvtv82FCd",
"iconUrl": "https://cdn.coinranking.com/gNsKAuE-W/bitcoin_btc.svg",
"name": "Bitcoin",
"symbol": "BTC",
"price": "65955.43592725793773050345"
},
{
"uuid": "ZlZpzOJo43mIo",
"iconUrl": "https://cdn.coinranking.com/By8ziihX7/bch.svg",
"name": "Bitcoin Cash",
"symbol": "BCH",
"price": "629.06361906860411030862"
}
],
"exchanges": [
{
"uuid": "YY5LBnZ-G",
"iconUrl": "https://cdn.coinranking.com/tG3ps5jPI/bitforex.svg",
"name": "Bitforex",
"recommended": false
},
{
"uuid": "C2gDcXEHIFD",
"iconUrl": "https://cdn.coinranking.com/lQYXlA0LJ/hotbit.svg",
"name": "HOTBIT",
"recommended": false
}
],
"markets": [
{
"uuid": "MP77r-vKf4",
"baseSymbol": "BTC",
"quoteSymbol": "USDT",
"baseUuid": "Qwsogvtv82FCd",
"quoteUuid": "HIVsRcGKkPFtW",
"exchangeIconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
"exchangeName": "Binance",
"exchangeUuid": "-zdvbieRdZ",
"recommended": true
},
{
"uuid": "6NVfmwRwJEp",
"baseSymbol": "BTC",
"quoteSymbol": "USDT",
"baseUuid": "Qwsogvtv82FCd",
"quoteUuid": "HIVsRcGKkPFtW",
"exchangeIconUrl": "https://cdn.coinranking.com/tBA4j321g/Okex.svg",
"exchangeName": "OKEx",
"exchangeUuid": "hUlMcwWZp_",
"recommended": true
}
]
}
}
| Name | Type | Description |
|---|---|---|
| data.coins | Object[] | List of coins matching the search pattern |
| data.coins.uuid | String | UUID of the coin |
| data.coins.iconUrl | String | Location of the icon |
| data.coins.name | String | Name of the coin |
| data.coins.symbol | String | Currency symbol |
| data.coins.price | String | Price of the coin |
| data.exchanges | Object[] | List of exchanges matching the search pattern |
| data.exchanges.uuid | String | UUID of the exchange |
| data.exchanges.iconUrl | String | Location of the icon |
| data.exchanges.name | String | Name of the exchange |
| data.exchanges.recommended | Boolean | Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges |
| data.markets | Object[] | List of markets matching the search pattern |
| data.markets.uuid | String | UUID of the market |
| data.markets.baseSymbol | String | The base symbol of this market |
| data.markets.quoteSymbol | String | The quote symbol of this market |
| data.markets.baseUuid | String | The UUID of the base currency |
| data.markets.quoteUuid | String | The UUID of the quote currency |
| data.markets.exchangeIconUrl | String | Location of the icon of the exchange this market belongs to |
| data.markets.exchangeName | String | Name of the exchange |
| data.markets.exchangeUuid | String | UUID of the exchange |
| 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 |
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency with UUID of HxDUgYGNAdQz not available"
}