Querying Onchain Data

Onchain endpoints use identifiers from GeckoTerminal, not CoinGecko.

CoinGecko Asset Platform IDs and GeckoTerminal Network IDs are not the same.

Always use Network IDs for /onchain endpoints.

Finding Network IDs

Use /onchain/networks, or copy the slug from a GeckoTerminal URL: geckoterminal.com/eth/pools/...

{
  "id": "eth",
  "type": "network",
  "attributes": {
    "name": "Ethereum",
    "coingecko_asset_platform_id": "ethereum"
  }
}

Use /onchain/networks/{network}/dexes, or copy from a GeckoTerminal URL: geckoterminal.com/eth/uniswap_v3

{
  "id": "uniswap_v3",
  "type": "dex",
  "attributes": {
    "name": "Uniswap V3"
  }
}

network ID + pool address — e.g. /onchain/networks/{network}/pools/{address}:

https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc

Find pool addresses on the pool page at GeckoTerminal:

To look up a pool by token name, symbol, or address instead, use /onchain/search/pools:

https://pro-api.coingecko.com/api/v3/onchain/search/pools?query=weth&network=eth

https://pro-api.coingecko.com/api/v3/onchain/networks/eth/tokens/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/pools

Find token addresses on the token page at GeckoTerminal:

Pattern	How
Pool liquidity	Use Pool Data Read `reserve_in_usd`
Token liquidity	Use Token Data Read `total_reserve_in_usd` (across all pools)
Filter pools	Use /pools/megafilter Filter by liquidity, FDV, volume, network, DEX
Launchpad data	Use /pools/megafilter Set `sort=pool_created_at_desc` and filter by DEX
Token security	Use Token Info Returns GT scores, holder distribution, mint/freeze authority
Inactive tokens	Set `include_inactive_source=true` on supported endpoints Read `last_trade_timestamp` for last swap time
CoinGecko vs GT networks	CoinGecko: /asset_platforms GeckoTerminal: /onchain/networks