Coin Price by Token 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
}
}Coin Price by Token Addresses
To query one or more token prices by using their token contract addresses
GET
/
simple
/
token_price
/
{id}
Coin Price by Token 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.
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.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
headerAuthqueryAuth
Learn how to set up your API key
Path Parameters
Asset platform's ID.
*refers to /asset_platforms
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.
Response
200 - application/json
Token prices
Hide child attributes
Hide child attributes
Was this page helpful?

