Coin Price by IDs, Symbols, or Names
curl --request GET \
--url https://api.coingecko.com/api/v3/simple/price \
--header 'x-cg-demo-api-key: <api-key>'{
"bitcoin": {
"usd": 76975,
"usd_market_cap": 1542226908349.8406,
"usd_24h_vol": 29096603418.89408,
"usd_24h_change": -1.4093297098441402,
"last_updated_at": 1779092258
}
}Coin Price by IDs, Symbols, or Names
To query the prices of one or more coins by using their unique Coin API IDs, symbols, or names
GET
/
simple
/
price
Coin Price by IDs, Symbols, or Names
curl --request GET \
--url https://api.coingecko.com/api/v3/simple/price \
--header 'x-cg-demo-api-key: <api-key>'{
"bitcoin": {
"usd": 76975,
"usd_market_cap": 1542226908349.8406,
"usd_24h_vol": 29096603418.89408,
"usd_24h_change": -1.4093297098441402,
"last_updated_at": 1779092258
}
}Notes
- You can look up coins by
ids,names, orsymbols. When multiple are provided, priority is:ids>names>symbols. - Find a coin’s API ID on its CoinGecko page, via Coins List, or this Google Sheet.
- Use
include_last_updated_at=trueorinclude_24hr_change=true(returnsnullif stale) to verify price freshness. include_tokens=allonly works withsymbolslookups, limited to 50 symbols per request.- Maximum of 515 IDs per request. Wildcard searches are not supported.
- URL-encode spaces in
names(e.g.Binance%20Coin).
Cross-check prices on CoinGecko and learn about the price methodology.
SDK Examples
New to the SDK? Install and authenticate theclient first:TypeScript | Python
const response = await client.simple.price.get({
vs_currencies: 'usd',
ids: 'bitcoin',
});
console.log(JSON.stringify(response, null, 2));
response = client.simple.price.get(
vs_currencies="usd",
ids="bitcoin",
)
print(response)
Authorizations
headerAuthqueryAuth
Learn how to set up your API key
Query Parameters
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.
Coins' IDs, comma-separated if querying more than 1 coin.
*refers to /coins/list
Response
200 - application/json
Coin prices
Hide child attributes
Hide child attributes
Was this page helpful?

