Coin Price by IDs, Symbols, or Names

Changed on

To query the prices of one or more coins by using their unique Coin API IDs, symbols, or names

get/simple/price

Request

  • Base URL
    https://pro-api.coingecko.com/api/v3
  • Auth
    • API key in header x-cg-pro-api-key
    • or API key in query parameter x_cg_pro_api_key

Query parameters

vs_currenciesstring required

Target currency of coins, comma-separated if querying more than 1 currency. *refers to /simple/supported_vs_currencies.

For the complete list of fiat currencies supported by this endpoint, see Fiat Currencies Support List.

idsstring

Coins' IDs, comma-separated if querying more than 1 coin. *refers to /coins/list

namesstring

Coins' names, comma-separated if querying more than 1 coin.

symbolsstring

Coins' symbols, comma-separated if querying more than 1 coin.

include_tokens'top' | 'all'

For symbols lookups, specify all to include all matching tokens. Default top returns top-ranked tokens by market cap or volume.

include_market_capboolean

Include market capitalization. Default: false

include_24hr_volboolean

Include 24-hour trading volume. Default: false

include_24hr_changeboolean

Include 24-hour change percentage. Default: false

include_last_updated_atboolean

Include last updated price time as a UNIX timestamp. Default: false

precision'full' | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18'

Decimal places for currency price value

Response

Coin prices

SimplePrice required

Changes

    • info

      api tag Simple removed

    • breaking

      for the query request parameter ids, default value bitcoin was added

    • breaking

      for the query request parameter names, default value Bitcoin was added

    • breaking

      for the query request parameter symbols, default value btc was added