Search

Get search suggestions

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

Query parameters

NameTypeDescription
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

Code examples

Parameters examples

Response

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
      }
    ]
  }
}

Response fields

NameTypeDescription
data.coinsObject[]

List of coins matching the search pattern

data.coins.uuidString

UUID of the coin

data.coins.iconUrlString

Location of the icon

data.coins.nameString

Name of the coin

data.coins.symbolString

Currency symbol

data.coins.priceString

Price of the coin

data.exchangesObject[]

List of exchanges matching the search pattern

data.exchanges.uuidString

UUID of the exchange

data.exchanges.iconUrlString

Location of the icon

data.exchanges.nameString

Name of the exchange

data.exchanges.recommendedBoolean

Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges

data.marketsObject[]

List of markets matching the search pattern

data.markets.uuidString

UUID of the market

data.markets.baseSymbolString

The base symbol of this market

data.markets.quoteSymbolString

The quote symbol of this market

data.markets.baseUuidString

The UUID of the base currency

data.markets.quoteUuidString

The UUID of the quote currency

data.markets.exchangeIconUrlString

Location of the icon of the exchange this market belongs to

data.markets.exchangeNameString

Name of the exchange

data.markets.exchangeUuidString

UUID of the exchange

data.markets.recommendedBoolean

Whether the market is recommended based on the exchange it belongs to, see https://support.coinranking.com/article/82-recommended-exchanges

Error response

HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "REFERENCE_UNAVAILABLE",
  "message": "Reference currency with UUID of HxDUgYGNAdQz not available"
}

Error responses