CoinGecko Token Data Contract Address
0.5 credits/call
ae_coingecko_token_data_contract_address
Get detailed market data for a specific token using its contract address.
0.5 credits/call
Pricing
0.5 credits/call
| Condition | Charge |
|---|---|
| Each call | 0.5 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
address | string | Yes | 必填。只能传目标链上的真实合约/池子地址。必须先确认 network/asset_platform 和 address 都是 CoinGecko 支持的真实链上标识;禁止传 symbol、中文名、股票代码、公司名、占位符、空字符串或伪地址。未确认地址时绝对不得调用本工具。 | — |
include | enum (top_pools) | No | attributes to include | — |
network | string | Yes | 必填。只能传 CoinGecko onchain networks 返回并确认存在的 network id。必须先调用 coingecko_networks_list 确认;禁止传中文链名、自然语言、占位符或猜测值。未确认 network 时绝对不得调用本工具。 | — |
include_composition | boolean | No | include pool composition, default: false | — |
include_inactive_source | boolean | No | include token data from inactive pools using the most recent swap, default: false | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_coingecko_token_data_contract_address' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"network": "eth"
}
}'Response exampleresponse.json
{
"data": {
"attributes": {
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"coingecko_coin_id": "tether",
"decimals": 6,
"fdv_usd": "83760293810.3516",
"image_url": "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661",
"name": "Tether USD"
},
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
"relationships": {
"top_pools": {
"data": [
{
"id": "eth_0x4e68ccd3e89f51c3074ca5072bbac773960dfa36",
"type": "pool"
}
]
}
},
"type": "token"
}
}This example shows part of the response. Copied content is valid JSON.

