Skip to main content
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"
      },
      "last_trade_timestamp": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": 1712534400
      }
    }
  }
}

​
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.
  • If include_inactive_source=true is set and no top pool is found for a token, the search will expand to include recently active pools up to the past 1 year.
  • Cache/Update Frequency: Real-time (Cacheless) for Pro API (Basic, 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

​
include_inactive_source
boolean
default:false

include token price data from inactive pools using the most recent swap, default: false

Response

200 - application/json

Get current USD prices of multiple tokens on a network

​
data
object