CoinGecko Contract Address Market Chart Range

0.5 credits/call
ae_coingecko_contract_address_market_chart_range

Retrieve historical price, market capitalization, and trading volume data for a verified cryptocurrency token using its CoinGecko ID and contract address over a specified date range. Only the most recent two years are available.

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
idstringYes必填。传 CoinGecko 资产平台 ID(如 ethereum),可先用 coingecko_asset_platforms_list 查询;不是 coin id。合约地址另填入 contract_address 或 contract_addresses。—
tostringYes必填。必须是 CoinGecko 接受的时间值,并且本接口仅支持查询最近 2 年内的历史数据。必须先确认 CoinGecko 标识,再检查 from/to 都落在最近 2 年范围内;确认合法后才允许调用。禁止传超过 2 年范围的历史时间、过早日期、0、test、占位日期、自然语言日期或不确定时间。超出最近 2 年范围时,绝对不得调用,必须缩小时间范围或说明需要更高套餐。—
fromstringYes必填。必须是 CoinGecko 接受的时间值,并且本接口仅支持查询最近 2 年内的历史数据。必须先确认 CoinGecko 标识,再检查 from/to 都落在最近 2 年范围内;确认合法后才允许调用。禁止传超过 2 年范围的历史时间、过早日期、0、test、占位日期、自然语言日期或不确定时间。超出最近 2 年范围时,绝对不得调用,必须缩小时间范围或说明需要更高套餐。—
intervalenum (daily)NoOptional data interval. For non-Enterprise accounts, do not pass 5m or hourly; pass daily or leave this parameter empty to let CoinGecko automatically select the granularity based on from and to.—
precisionenum (full | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18)Nodecimal place for currency price value—
vs_currencystringYes必填。只能传 CoinGecko 支持的法币/计价货币代码,必须来自 coingecko_simple_supported_currencies 或接口支持列表。禁止传中文、股票代码、自然语言或占位符。—
contract_addressstringYes必填。只能传目标链上的真实合约/池子地址。必须先确认 network/asset_platform 和 address 都是 CoinGecko 支持的真实链上标识;禁止传 symbol、中文名、股票代码、公司名、占位符、空字符串或伪地址。未确认地址时绝对不得调用本工具。—

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_contract_address_market_chart_range' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "contract_address": "test",
    "from": "test",
    "id": "test",
    "to": "test",
    "vs_currency": "test"
  }
}'
Response exampleresponse.json
JSON
{
  "status": {
    "error_code": 10014,
    "error_message": "Invalid value for 'to' and 'from' provided for the date parameter. Use YYYY-MM-DD, YYYY-MM-DDTHH:MM or UNIX timestamp only.",
    "timestamp": "2026-10-08T10:09:39.171Z"
  }
}