Skip to main content

Set up your API key

Build faster with AI

TL;DR
Use /onchain/…/token_price for onchain pricing, /onchain/…/pools/…/ohlcv for DEX charts, /onchain/…/pools/…/trades for trade history, and /onchain/…/tokens/…/top_holders for wallet distribution.
Replace YOUR_API_KEY in the examples below with your actual key. Get one here →

​
Token Analytics

1

Onchain token pricing — /onchain/.../token_price/{addresses}

Real-time prices for any onchain token by contract address — including tokens not listed on CoinGecko. Batch multiple addresses in one call.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/onchain/simple/networks/eth/token_price/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,0x6b175474e89094c44da98b954eedeac495271d0f" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Onchain Simple Price →
Use /onchain/networks to get the full list of 200+ supported network IDs.
2

Token market data — /onchain/.../tokens/{address}

Price, volume, FDV, market cap, price changes, and transaction counts for a token.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/onchain/networks/eth/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933?include=top_pools" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Token Data →
Key paramUse
includetop_pools to see the most active pools for this token
3

Token metadata — /onchain/.../tokens/{address}/info

Description, socials, websites, CoinGecko ID, and GeckoTerminal analytics score.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/onchain/networks/eth/tokens/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/info" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Token Info →
The coingecko_coin_id field bridges onchain data to CoinGecko’s main API — use it with /coins/{id} for community and developer metrics.

​
Pool Discovery & Liquidity

1

Pool details — /onchain/.../pools/{address}

Reserve (TVL), volume, price, transaction counts, and price changes for a specific pool.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640?include=base_token,quote_token,dex" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Pool Data →
reserve_in_usd is your liquidity indicator — total value locked in the pool.
2

Trending pools — /onchain/networks/trending_pools

Hottest liquidity pools across all networks — spot early DeFi momentum.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/onchain/networks/trending_pools?include=base_token,dex,network&duration=24h" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Trending Pools → | By Network →
Key paramUse
includebase_token, quote_token, dex, network for richer context
duration1h, 6h, or 24h trending window
3

Advanced screening — /onchain/pools/megafilter

Filter pools by volume, liquidity, age, network, DEX, and more — the most powerful pool discovery endpoint.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter?networks=eth,solana&volume_24h_usd_min=100000&reserve_usd_min=50000&sort=volume_24h_usd_desc" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Pools Megafilter →
Key paramUse
networksFilter by chains (e.g. eth,solana,base)
volume_24h_usd_min / maxVolume thresholds
reserve_usd_min / maxLiquidity depth
pool_age_min / maxPool age in hours — find new pools
sortvolume_24h_usd_desc, reserve_usd_desc, etc.

​
DEX Charts & Trades

1

Pool OHLCV — sub-minute candles

OHLCV for a specific pool with second, minute, hour, and day timeframes.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640/ohlcv/minute?aggregate=5&limit=100&currency=usd" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Pool OHLCV →
Response format: [timestamp, open, high, low, close, volume].
Key paramUse
aggregateCombine candles — 5 for 5-min, 4 for 4-hour
limitUp to 1000 data points
currencyusd for fiat or token for base-token denomination
2

Token OHLCV — aggregated across pools

Same format as pool OHLCV, but aggregated across all pools for a token — broader market view.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/onchain/networks/eth/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933/ohlcv/day?aggregate=1&limit=30&currency=usd" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Token OHLCV →
Pool OHLCV reflects a single pool’s price action. Token OHLCV aggregates across all pools — use it for a broader market view.
3

Pool trades — last 300 trades

Recent swap activity for a specific pool — monitor execution or trigger alerts on large trades.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640/trades?trade_volume_in_usd_greater_than=10000" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Pool Trades →
Use Token Trades for a cross-pool view of all trading activity for a token (Pro only).

​
Token Holder Analytics

1

Top holders — /onchain/.../tokens/{address}/top_holders

Wallet addresses, balances, and ownership percentages for the largest holders. The wallet_tag field identifies known entities (exchanges, protocols, treasuries).
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/onchain/networks/eth/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933/top_holders" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Top Holders →
2

Holder count over time — /onchain/.../tokens/{address}/holders_chart

Historical holder count — rising count signals adoption, declining count may indicate distribution concerns.
curl -X GET \
  "https://pro-api.coingecko.com/api/v3/onchain/networks/eth/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933/holders_chart?timeframe=one_month" \
  -H "x-cg-pro-api-key: YOUR_API_KEY"
Holders Chart →
Combine top holders with the holders chart — top holders shows current concentration, the chart reveals adoption trends over time.