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, 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. The response always returns a set of the most prominent coins, exchanges, markets, fiats currencies and categories 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: `...search-suggestions?query=bitco`
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: yhjMzLPhuIDl Example: `...search-suggestions?referenceCurrencyUuid=Qwsogvtv82FCd`

Code examples

Response

json
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
      }
    ],
    "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

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

Error responses

Error	Description
VALIDATION_ERROR `Object`	The request could not be validated. The response should provide more details.
REFERENCE_UNAVAILABLE `Object`	The reference currency used in the request is not available. Choose another UUID.

Stats for selection of coins

Real-time (WebSockets)