DeFi & Onchain Analytics

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

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.

Pro API
Demo API

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 →

curl -X GET \
  "https://api.coingecko.com/api/v3/onchain/simple/networks/eth/token_price/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,0x6b175474e89094c44da98b954eedeac495271d0f" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Onchain Simple Price →

Use /onchain/networks to get the full list of 200+ supported network IDs.

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

Price, volume, FDV, market cap, price changes, and transaction counts for a token.

Pro API
Demo API

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 →

curl -X GET \
  "https://api.coingecko.com/api/v3/onchain/networks/eth/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933?include=top_pools" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Token Data →

Key param	Use
`include`	`top_pools` to see the most active pools for this token

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

Description, socials, websites, CoinGecko ID, and GeckoTerminal analytics score.

Pro API
Demo API

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 →

curl -X GET \
  "https://api.coingecko.com/api/v3/onchain/networks/eth/tokens/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/info" \
  -H "x-cg-demo-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

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

Reserve (TVL), volume, price, transaction counts, and price changes for a specific pool.

Pro API
Demo API

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 →

curl -X GET \
  "https://api.coingecko.com/api/v3/onchain/networks/eth/pools/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640?include=base_token,quote_token,dex" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Pool Data →

reserve_in_usd is your liquidity indicator — total value locked in the pool.

Trending pools — /onchain/networks/trending_pools

Hottest liquidity pools across all networks — spot early DeFi momentum.

Pro API
Demo API

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 →

curl -X GET \
  "https://api.coingecko.com/api/v3/onchain/networks/trending_pools?include=base_token,dex,network&duration=24h" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Trending Pools → | By Network →

Key param	Use
`include`	`base_token`, `quote_token`, `dex`, `network` for richer context
`duration`	`1h`, `6h`, or `24h` trending window

Advanced screening — /onchain/pools/megafilter

Filter pools by volume, liquidity, age, network, DEX, and more — the most powerful pool discovery endpoint.

Pro API
Demo API

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 →

/onchain/pools/megafilter is not available on the Demo API.
Upgrade to Pro →

Key param	Use
`networks`	Filter by chains (e.g. `eth,solana,base`)
`volume_24h_usd_min` / `max`	Volume thresholds
`reserve_usd_min` / `max`	Liquidity depth
`pool_age_min` / `max`	Pool age in hours — find new pools
`sort`	`volume_24h_usd_desc`, `reserve_usd_desc`, etc.

DEX Charts & Trades

Pool OHLCV — sub-minute candles

OHLCV for a specific pool with second, minute, hour, and day timeframes.

Pro API
Demo API

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 →

curl -X GET \
  "https://api.coingecko.com/api/v3/onchain/networks/eth/pools/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640/ohlcv/minute?aggregate=5&limit=100&currency=usd" \
  -H "x-cg-demo-api-key: YOUR_API_KEY"

Pool OHLCV →

Response format: [timestamp, open, high, low, close, volume].

Key param	Use
`aggregate`	Combine candles — `5` for 5-min, `4` for 4-hour
`limit`	Up to 1000 data points
`currency`	`usd` for fiat or `token` for base-token denomination

Token OHLCV — aggregated across pools

Same format as pool OHLCV, but aggregated across all pools for a token — broader market view.

Pro API
Demo API

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 →

/onchain/.../tokens/.../ohlcv is not available on the Demo API.
Upgrade to Pro →

Pool OHLCV reflects a single pool’s price action. Token OHLCV aggregates across all pools — use it for a broader market view.

Pool trades

Recent swap activity for a specific pool — monitor execution or trigger alerts on large trades.On Analyst & above, set trading_period to 7d or 30d to look further back than the 24-hour default, and page through the results with cursor.

Pro API
Demo API

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 →

curl -X GET \
  "https://api.coingecko.com/api/v3/onchain/networks/eth/pools/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640/trades?trade_volume_in_usd_greater_than=10000" \
  -H "x-cg-demo-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

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).

Pro API
Demo API

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 →

/onchain/.../tokens/.../top_holders is not available on the Demo API.
Upgrade to Pro →

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

Historical holder count — rising count signals adoption, declining count may indicate distribution concerns.

Pro API
Demo API

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 →

/onchain/.../tokens/.../holders_chart is not available on the Demo API.
Upgrade to Pro →

Combine top holders with the holders chart — top holders shows current concentration, the chart reveals adoption trends over time.

Get Started

Guides

Resources

DeFi & Onchain Analytics

Set up your API key

Build faster with AI

Token Analytics

Pool Discovery & Liquidity

DEX Charts & Trades

Token Holder Analytics

Set up your API key

Build faster with AI

​Token Analytics

​Pool Discovery & Liquidity

​DEX Charts & Trades

​Token Holder Analytics

Token Analytics

Pool Discovery & Liquidity

DEX Charts & Trades

Token Holder Analytics