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.

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
networkstringYes必填。只能传 CoinGecko onchain networks 返回并确认存在的 network id。必须先调用 coingecko_networks_list 确认;禁止传中文链名、自然语言、占位符或猜测值。未确认 network 时绝对不得调用本工具。—
addressesstringYes必填。只能传目标链上的真实合约/池子地址。必须先确认 network/asset_platform 和 address 都是 CoinGecko 支持的真实链上标识;禁止传 symbol、中文名、股票代码、公司名、占位符、空字符串或伪地址。未确认地址时绝对不得调用本工具。—
include_24hr_volbooleanNoinclude 24hr volume, default: false—
mcap_fdv_fallbackbooleanNoreturn FDV if market cap is not available, default: false—
include_market_capbooleanNoinclude market capitalization, default: false—
include_inactive_sourcebooleanNoinclude token price data from inactive pools using the most recent swap, default: false—
include_24hr_price_changebooleanNoinclude 24hr price change, default: false—
include_total_reserve_in_usdbooleanNoinclude total reserve in USD, default: 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_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
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"
  }
}