GET
/
simple
/
price
Coin Price by IDs
curl --request GET \
  --url https://api.coingecko.com/api/v3/simple/price \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "bitcoin": {
    "usd": 67187.3358936566,
    "usd_market_cap": 1317802988326.25,
    "usd_24h_vol": 31260929299.5248,
    "usd_24h_change": 3.63727894677354,
    "last_updated_at": 1711356300
  }
}

​
Tips

  • You may obtain the coin ID (API ID) via several ways:
    • refers to respective coin page and find ‘API ID’.
    • refers to /coins/list endpoint.
    • refers to Google Sheets here.
  • You can retrieve specific coins using their unique ids, names, or symbols.
  • You may flag to include more data such as market cap, 24hr volume, 24hr change, last updated time etc.
  • To verify if a price is stale, you may flag include_last_updated_at=true in your request to obtain the latest updated time. Alternatively, you may flag include_24hr_change=true to determine if it returns a null value.

​
Note

  • You may cross-check the price on CoinGecko and learn more about our price methodology here.
  • When multiple lookup params are provided, the following priority order is applied: ids (highest) > names > symbols (lowest).
  • When searching by name, you need to URL-encode any spaces (e.g. “Binance Coin” becomes “Binance%20Coin”).
  • The include_tokens=all param is exclusively for use with the symbols lookup and is limited to maximum of 50 symbols per request.
  • Wildcard searches are not supported for lookup params (ids, names, symbols).
  • Cache/Update Frequency: every 60 seconds for Public API.
    • Every 20 seconds for Pro-API (Analyst, Lite, Pro, Enterprise).

Authorizations

​
x-cg-demo-api-key
string
header
required

Query Parameters

​
vs_currencies
string
default:usd
required

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

​
ids
string
default:bitcoin

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

​
names
string
default:Bitcoin

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

​
symbols
string
default:btc

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

​
include_tokens
enum<string>

for symbols lookups, specify all to include all matching tokens Default top returns top-ranked tokens (by market cap or volume)

Available options:
top,
all
​
include_market_cap
boolean

include market capitalization, default: false

​
include_24hr_vol
boolean

include 24hr volume, default: false

​
include_24hr_change
boolean

include 24hr change, default: false

​
include_last_updated_at
boolean

include last updated price time in UNIX, default: false

​
precision
enum<string>

decimal place for currency price value

Available options:
full,
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18

Response

200 - application/json

price(s) of cryptocurrency

The response is of type object.