Search suggestions
Get search suggestions
Search suggestions are a quick and easy way to find data on coinranking. With a query you can find currencies (including fiat), exchanges, markets and categories by their symbol, name or contract address.
While searching you can provide either part of a name or symbol, or a complete smart contract address. None are case sensitive. By default, the response returns a set of the most prominent coins, exchanges, markets, fiat currencies, categories, commodities and indices matching your query.
https://api.coinranking.com/v2/search-suggestions
Query parameters
| Parameter | Description |
|---|---|
query (optional) String |
Value to search on. Can be a part of a name or symbol, or a complete smart contract address. Example:
https://api.coinranking.com/v2/search-suggestions?query=bitco
|
types (optional) String[] |
Suggestion buckets to search. Defaults to all buckets. You can provide a single value, repeated array values, or comma-separated values. The response includes every bucket; buckets that were not requested are returned as empty arrays. Allowed values: coins exchanges markets fiat categories commodities indices allDefault value: all Example:
https://api.coinranking.com/v2/search-suggestions?query=bitco&types[]=coins&types[]=exchanges
|
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:
https://api.coinranking.com/v2/search-suggestions?referenceCurrencyUuid=Qwsogvtv82FCd
|
Code examples
Response
jsonHTTP/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
}
],
"fiat": [
{
"uuid": "yhjMzLPhuIDl",
"iconUrl": "https://cdn.coinranking.com/kz6a7w6vF/usd.svg",
"name": "US Dollar",
"symbol": "USD",
"price": "1"
}
],
"categories": [
{
"slug": "defi",
"shortname": "DeFi",
"name": "DeFi coins",
"iconUrl": "https://cdn.coinranking.com/MlN0Muv9-/defi.svg",
"numberOfCoins": 100
}
]
}
}
Response fields
| Property | 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 |
data.fiat Object[] | List of fiat currencies matching the search pattern |
data.fiat.uuid String | UUID of the currency |
data.fiat.iconUrl String | Location of the icon |
data.fiat.name String | Name of the currency |
data.fiat.symbol String | Currency symbol |
data.fiat.price String | Rate of the currency |
data.categories Object[] | List of categories matching the search pattern |
data.categories.slug String | Slug of the category |
data.categories.shortname String | Shortened name of the category |
data.categories.name String | Full name of the category |
data.categories.iconUrl String | Location of the icon |
data.categories.numberOfCoins Number | Number of coins in the category |
Error response
jsonHTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency with UUID of HxDUgYGNAdQz not available"
}
Previous
Next