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, 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. 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

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:
...search-suggestions?query=bitco
referenceCurrencyUuid (optional) String

UUID of reference currency, in which the coin prices are calculated. Defaults to US Dollar.

Default value: yhjMzLPhuIDl

Example:
...search-suggestions?referenceCurrencyUuid=Qwsogvtv82FCd

Code 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

PropertyDescription
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

Error response

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

Error responses

On this page