CoinGecko Top Pools Contract Address

0.5 credits/call
ae_coingecko_top_pools_contract_address

Find the top liquidity pools associated with a specific token contract address on a network.

Crypto
0.5 credits/call

Pricing

0.5 credits/call
ConditionCharge
Each call0.5 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pageintegerNopage through results Default value: 1—
sortenum (h24_volume_usd_liquidity_desc | h24_tx_count_desc | h24_volume_usd_desc)Nosort the pools by field Default value: h24_volume_usd_liquidity_desc—
includestringNoattributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex`—
networkstringYes必填。只能传 CoinGecko onchain networks 返回并确认存在的 network id。必须先调用 coingecko_networks_list 确认;禁止传中文链名、自然语言、占位符或猜测值。未确认 network 时绝对不得调用本工具。—
token_addressstringYes必填。只能传目标链上的真实合约/池子地址。必须先确认 network/asset_platform 和 address 都是 CoinGecko 支持的真实链上标识;禁止传 symbol、中文名、股票代码、公司名、占位符、空字符串或伪地址。未确认地址时绝对不得调用本工具。—
include_inactive_sourcebooleanNoinclude tokens from inactive pools using the most recent swap, default: false—
include_gt_community_databooleanNoinclude GeckoTerminal community data (Sentiment votes, Suspicious reports) Default value: false—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_coingecko_top_pools_contract_address' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "network": "test",
    "token_address": "test"
  }
}'
Response exampleresponse.json
JSON
{
  "status": {
    "error_code": 404,
    "error_message": "Not found",
    "timestamp": "2026-10-08T10:11:32.304Z"
  }
}