GET
/
simple
/
price
Coin Price by IDs
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/simple/price \
  --header 'x-cg-pro-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
  }
}

Authorizations

​
x-cg-pro-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

​
{key}
object