CoinGecko Simple Price
0.5 credits/call
ae_coingecko_simple_price
Get current cryptocurrency prices using coin IDs, symbols, or names.
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 |
|---|---|---|---|---|
ids | string | No | coins' IDs, comma-separated if querying more than 1 coin. *refers to [`/coins/list`](/reference/coins-list). | — |
names | string | No | coins' names, comma-separated if querying more than 1 coin. | — |
symbols | string | No | coins' symbols, comma-separated if querying more than 1 coin. | — |
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_currencies | string | Yes | 必填。只能传 CoinGecko 支持的法币/计价货币代码,必须来自 coingecko_simple_supported_currencies 或接口支持列表。禁止传中文、股票代码、自然语言或占位符。 查询价格时还需提供 ids、names 或 symbols 中至少一项。 | — |
include_tokens | enum (top | all) | No | for `symbols` lookups, specify `all` to include all matching tokens Default `top` returns top-ranked tokens (by market cap or volume) | — |
include_24hr_vol | boolean | No | include 24hr volume, default: false | — |
include_market_cap | boolean | No | include market capitalization, default: false | — |
include_24hr_change | boolean | No | include 24hr change percentage, default: false | — |
include_last_updated_at | boolean | No | include last updated price time in UNIX, 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_simple_price' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"ids": "bitcoin,ethereum",
"include_24hr_change": true,
"vs_currencies": "usd"
}
}'Response exampleresponse.json
{
"bitcoin": {
"usd": 74241,
"usd_24h_change": 1.7950611074895488
},
"ethereum": {
"usd": 2077.19,
"usd_24h_change": 3.0566248808200047
}
}Guides using this tool
See how this tool fits into real workflows
Multi-Asset Portfolio Watch with One AI AgentHoldings spread across A-shares, US stocks, crypto and forex? Use one AI agent to pull quotes from every market, convert to a single currency, and produce one portfolio watch report — no app-hopping.The AI Agent Tool Stack for Quant & Investment ResearchWire your whole research workflow into one AI agent — pull A-share and US equity quotes, crypto prices, company fundamentals and market news from a single plain-English prompt instead of juggling separate data subscriptions.X (Twitter) Sentiment as Trading Signals with AI AgentsLet an AI agent turn X (Twitter) chatter into trading signals — pull recent posts, gauge how loud the conversation is, and align it with live prices from one plain-English prompt, no API wiring or timeline scrolling.
Crypto Price Tracking with AI Agents (CoinGecko)Track crypto prices automatically with an AI agent: pull live quotes, fetch OHLC candles, compute metrics and build a watch dashboard in one chain — with scheduled alerts, no more refreshing price pages.

