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": "49dd0b90-d99d-48b6-8fe2-03e826fbcef2",
    "type": "simple_token_price",
    "attributes": {
      "token_prices": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2084.57379936447"
      },
      "market_cap_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "4706652516.682727"
      },
      "h24_volume_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "313441016.145429"
      },
      "h24_price_change_percentage": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "-1.8867250098940773"
      },
      "total_reserve_in_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1015673598.896450024556193850116628967"
      },
      "last_trade_timestamp": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1779882383"
      }
    }
  }
}

GET

onchain

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": "49dd0b90-d99d-48b6-8fe2-03e826fbcef2",
    "type": "simple_token_price",
    "attributes": {
      "token_prices": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2084.57379936447"
      },
      "market_cap_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "4706652516.682727"
      },
      "h24_volume_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "313441016.145429"
      },
      "h24_price_change_percentage": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "-1.8867250098940773"
      },
      "total_reserve_in_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1015673598.896450024556193850116628967"
      },
      "last_trade_timestamp": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1779882383"
      }
    }
  }
}

Notes

Prices are returned in USD. Addresses not found in GeckoTerminal will be ignored.
Supports up to 100 contract addresses per request (Analyst plan or above).
Unverified token market cap returns null. Use mcap_fdv_fallback=true to return FDV value (as seen on GeckoTerminal) when market cap data is unavailable.
GeckoTerminal’s routing selects the best pool for pricing based on liquidity and activity. For full control, use Specific Pool Data with a specific pool address.
Set include_inactive_source=true to expand the search to recently active pools (up to 1 year) if no top pool is found.

SDK Examples

const response = await client.onchain.simple.networks.tokenPrice.getAddresses('0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2', {
  network: 'eth',
});

console.log(JSON.stringify(response, null, 2));

response = client.onchain.simple.networks.token_price.get_addresses(
  "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  network="eth",
)

print(response.model_dump_json(indent=2))

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

network

string

default:eth

required

Network ID. *refers to /onchain/networks.

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

Include token price data from inactive pools using the most recent swap. Default: false

Response

200 - application/json

Token price data

data

object

required

Show child attributes

API Usage Specific Pool Data by Pool Address

CoinGecko API

Onchain API

Token Price by Token Addresses

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples