CoinGecko Onchain Simple Price
0.5 credits/call
ae_coingecko_onchain_simple_price
Look up the current price of a token using its contract address on a specific blockchain network.
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 |
|---|---|---|---|---|
network | string | Yes | 必填。只能传 CoinGecko onchain networks 返回并确认存在的 network id。必须先调用 coingecko_networks_list 确认;禁止传中文链名、自然语言、占位符或猜测值。未确认 network 时绝对不得调用本工具。 | — |
addresses | string | Yes | 必填。只能传目标链上的真实合约/池子地址。必须先确认 network/asset_platform 和 address 都是 CoinGecko 支持的真实链上标识;禁止传 symbol、中文名、股票代码、公司名、占位符、空字符串或伪地址。未确认地址时绝对不得调用本工具。 | — |
include_24hr_vol | boolean | No | include 24hr volume, default: false | — |
mcap_fdv_fallback | boolean | No | return FDV if market cap is not available, default: false | — |
include_market_cap | boolean | No | include market capitalization, default: false | — |
include_inactive_source | boolean | No | include token price data from inactive pools using the most recent swap, default: false | — |
include_24hr_price_change | boolean | No | include 24hr price change, default: false | — |
include_total_reserve_in_usd | boolean | No | include total reserve in USD, 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_onchain_simple_price' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"addresses": "0xe45a355d9e9cad2ad85f2d03e3ee3102a036acf0",
"include_24hr_price_change": true,
"include_24hr_vol": true,
"include_market_cap": true,
"include_total_reserve_in_usd": true,
"mcap_fdv_fallback": true,
"network": "elysium"
}
}'Response exampleresponse.json
{
"data": {
"attributes": {
"h24_price_change_percentage": {
"0xe45a355d9e9cad2ad85f2d03e3ee3102a036acf0": "0.8986137606"
},
"h24_volume_usd": {
"0xe45a355d9e9cad2ad85f2d03e3ee3102a036acf0": "2659948.96936441"
},
"market_cap_usd": {
"0xe45a355d9e9cad2ad85f2d03e3ee3102a036acf0": "129796561.0047051"
},
"token_prices": {
"0xe45a355d9e9cad2ad85f2d03e3ee3102a036acf0": "0.400577435317462"
},
"total_reserve_in_usd": {
"0xe45a355d9e9cad2ad85f2d03e3ee3102a036acf0": "1560998.4105382836597273558305400548757480840728795693719459792462944"
}
},
"id": "f9514906-8429-4012-b801-ac4a0a757644",
"type": "simple_token_price"
}
}
