curl --request GET \
--url https://pro-api.coingecko.com/api/v3/simple/token_price/{id} \
--header 'x-cg-pro-api-key: <api-key>'{
"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599": {
"usd": 76721,
"usd_market_cap": 9008047197.715635,
"usd_24h_vol": 181232010.10689816,
"usd_24h_change": -1.6069562341774564,
"last_updated_at": 1779094527
}
}Coin Price by Token Addresses
To query one or more token prices by using their token contract addresses
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/simple/token_price/{id} \
--header 'x-cg-pro-api-key: <api-key>'{
"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599": {
"usd": 76721,
"usd_market_cap": 9008047197.715635,
"usd_24h_vol": 181232010.10689816,
"usd_24h_change": -1.6069562341774564,
"last_updated_at": 1779094527
}
}Notes
- Returns the global average price aggregated across all active exchanges on CoinGecko.
- Find a token’s contract address on its CoinGecko page or via Coins List with
include_platform=true. - Maximum of 515 contract addresses per request.
SDK Examples
const response = await client.simple.tokenPrice.getID('ethereum', {
contract_addresses: '0x2260fac5e5542a773aa44fbcfedf7c193bc2c599',
vs_currencies: 'usd',
});
console.log(JSON.stringify(response, null, 2));
response = client.simple.token_price.get_id(
"ethereum",
contract_addresses="0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
vs_currencies="usd",
)
print(response)
Authorizations
Learn how to set up your API key
Path Parameters
Asset platform's ID.
*refers to /asset_platforms
Query Parameters
Token contract addresses, comma-separated if querying more than 1 token
Target currency of coins, comma-separated if querying more than 1 currency.
*refers to /simple/supported_vs_currencies
Include market capitalization. Default: false
Include 24-hour trading volume. Default: false
Include 24-hour change percentage. Default: false
Include last updated price time as a UNIX timestamp. Default: false
Decimal places for currency price value
full, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18 Response
Token prices
Hide child attributes
Hide child attributes
Price in the target currency
Market capitalization in the target currency
24-hour trading volume in the target currency
24-hour price change percentage in the target currency
Last updated timestamp in UNIX seconds
Was this page helpful?