Skip to main content
GET
/
simple
/
token_price
/
{id}
Coin Price by Token Addresses
curl --request GET \
  --url https://api.coingecko.com/api/v3/simple/token_price/{id} \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599": {
    "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 asset platform and contract address via several ways:
    • refers to respective coin page and find ‘contract address’.
    • refers to /coins/list endpoint (include platform = true).
  • You may flag to include more data such as market cap, 24hr volume, 24hr change, last updated time etc.

​
Note

  • The endpoint returns the global average price of the coin that is aggregated across all active exchanges on CoinGecko.
  • You may cross-check the price on CoinGecko and learn more about our price methodology here.
  • 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

Path Parameters

​
id
string
default:ethereum
required
Example:

Query Parameters

​
contract_addresses
string
default:0x2260fac5e5542a773aa44fbcfedf7c193bc2c599
required
​
vs_currencies
string
default:usd
required
​
include_market_cap
boolean
​
include_24hr_vol
boolean
​
include_24hr_change
boolean
​
include_last_updated_at
boolean
​
precision
enum<string>
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
​
usd
number
​
usd_market_cap
number
​
usd_24h_vol
number
​
usd_24h_change
number
​
last_updated_at
number