Skip to main content
GET
Coin Price by Token Address
Price lookup keyed by on-chain contract address rather than CoinGecko id. id is the asset platform, contract_addresses a comma-separated list of token addresses, vs_currencies the quote currency. Returns a map keyed by lowercase contract address whose field names are built from the quote currency — usd, plus usd_market_cap, usd_24h_vol, usd_24h_change and last_updated_at when the matching include_market_cap, include_24hr_vol, include_24hr_change and include_last_updated_at flags are set. Use it when you hold an address and no id. For the token’s full profile use get_coingecko_token_data; if you already have the CoinGecko id use get_coingecko_simple_price.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Platform ID (e.g., ethereum, binance-smart-chain, polygon-pos).

Query Parameters

contract_addresses
string
required

Comma-separated contract addresses.

vs_currencies
string
required

Comma-separated target currencies.

include_market_cap
boolean
include_24hr_vol
boolean
include_24hr_change
boolean
include_last_updated_at
boolean
precision
string

full or a value from 0 to 18 to specify decimal places for currency price values.

Response

200 - application/json

Map keyed by contract address.

{key}
object