Skip to main content
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, or symbols. 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=true or include_24hr_change=true (returns null if stale) to verify price freshness.
  • include_tokens=all only works with symbols lookups, 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

const response = await client.simple.price.get({
  vs_currencies: 'usd',
  ids: 'bitcoin',
});

console.log(JSON.stringify(response, null, 2));

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 24-hour trading volume. Default: false

​
include_24hr_change
boolean

Include 24-hour change percentage. Default: false

​
include_last_updated_at
boolean

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

​
precision
enum<string>

Decimal places 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

Coin prices

​
{key}
object