CoinGecko Coins ID Market Chart Range
0.5 credits/call
ae_coingecko_coins_id_market_chart_range
Retrieve historical cryptocurrency prices and market data from CoinGecko for a confirmed coin ID and a date range within the most recent two years.
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 |
|---|---|---|---|---|
id | string | Yes | 必填。只能传 CoinGecko 返回并确认存在的 coin id。本 CoinGecko 服务只用于加密货币、代币、NFT、交易所、DEX 和链上数据;股票、证券、公司财务、基金、外汇传统行情或非加密资产需求绝对不得调用 CoinGecko。必须先通过 coingecko_search_data 或 coingecko_coins_list 确认 coin id;确认后才允许调用。禁止把 symbol、中文名、自然语言、股票代码、公司名、合约地址或占位符当作 id。未确认 CoinGecko coin id 时,绝对不得调用本工具。 | — |
to | string | Yes | 必填。必须是 CoinGecko 接受的时间值,并且本接口仅支持查询最近 2 年内的历史数据。必须先确认 CoinGecko 标识,再检查 from/to 都落在最近 2 年范围内;确认合法后才允许调用。禁止传超过 2 年范围的历史时间、过早日期、0、test、占位日期、自然语言日期或不确定时间。超出最近 2 年范围时,绝对不得调用,必须缩小时间范围或说明需要更高套餐。 | — |
from | string | Yes | 必填。必须是 CoinGecko 接受的时间值,并且本接口仅支持查询最近 2 年内的历史数据。必须先确认 CoinGecko 标识,再检查 from/to 都落在最近 2 年范围内;确认合法后才允许调用。禁止传超过 2 年范围的历史时间、过早日期、0、test、占位日期、自然语言日期或不确定时间。超出最近 2 年范围时,绝对不得调用,必须缩小时间范围或说明需要更高套餐。 | — |
interval | enum (hourly | daily) | No | 数据粒度。当前账号不支持显式传入 5m;可传 hourly 或 daily,也可以不传,由 CoinGecko 根据 from 和 to 自动选择数据粒度。 | — |
precision | enum (full | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18) | No | decimal place for currency price value | — |
vs_currency | string | Yes | 必填。只能传 CoinGecko 支持的法币/计价货币代码,必须来自 coingecko_simple_supported_currencies 或接口支持列表。禁止传中文、股票代码、自然语言或占位符。 | — |
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_coins_id_market_chart_range' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"from": "2026-09-01",
"id": "bitcoin",
"interval": "daily",
"to": "2026-10-28",
"vs_currency": "usd"
}
}'Response exampleresponse.json
{
"market_caps": [
[
1788220800000
]
],
"prices": [
[
1788220800000
]
],
"total_volumes": [
[
1788220800000
]
]
}This example shows part of the response. Copied content is valid JSON.

