GET
/
simple
/
networks
/
{network}
/
token_price
/
{addresses}
Token Price by Token Addresses
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/simple/networks/{network}/token_price/{addresses} \
  --header 'x-cg-pro-api-key: <api-key>'
{
  "data": {
    "id": "1ba898f0-eda2-4291-9491-9a5b323f66ef",
    "type": "simple_token_price",
    "attributes": {
      "token_prices": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2289.33"
      },
      "market_cap_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "6692452895.779648"
      },
      "h24_volume_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "965988358.733808"
      },
      "h24_price_change_percentage": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3.3870290336"
      },
      "total_reserve_in_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1576179559.94669772339136684208"
      }
    }
  }
}

Note

  • If the token’s market cap is not verified by the team, the API response will return null for its market cap value, even though it has a displayed value on GeckoTerminal, which might not be accurate as it often matches the Fully Diluted Valuation (FDV).
    • If you require market_cap_usd to return FDV value (as seen in GeckoTerminal.com) when market cap data is unavailable, please specify this parameter mcap_fdv_fallback=true.
  • The returned price currency is in USD.
  • Addresses not found in GeckoTerminal will be ignored.
  • This endpoint allows querying up to 100 contract addresses per request. This limit is exclusive for paid plan subscribers (Analyst plan & above).
  • When using this endpoint, GeckoTerminal’s routing decides the best pool for token price. The price source may change based on liquidity and pool activity. For full control over the price, you may use /networks/{network}/pools/{address} endpoint by providing a specific pool address.
  • Cache/Update Frequency: every 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise).

Authorizations

x-cg-pro-api-key
string
header
required

Path Parameters

network
string
default:eth
required

network ID *refers to /networks

Example:

"eth"

addresses
string
default:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
required

token contract address, comma-separated if more than one token contract address

Query Parameters

include_market_cap
boolean

include market capitalization, default: false

mcap_fdv_fallback
boolean

return FDV if market cap is not available, default: false

include_24hr_vol
boolean

include 24hr volume, default: false

include_24hr_price_change
boolean

include 24hr price change, default: false

include_total_reserve_in_usd
boolean

include total reserve in USD, default: false

Response

200 - application/json

Get current USD prices of multiple tokens on a network

data
object