CoinGecko Simple Price

0.5 credits/call
ae_coingecko_simple_price

Get current cryptocurrency prices using coin IDs, symbols, or names.

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
idsstringNocoins' IDs, comma-separated if querying more than 1 coin. *refers to [`/coins/list`](/reference/coins-list).—
namesstringNocoins' names, comma-separated if querying more than 1 coin.—
symbolsstringNocoins' symbols, comma-separated if querying more than 1 coin.—
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_currenciesstringYes必填。只能传 CoinGecko 支持的法币/计价货币代码,必须来自 coingecko_simple_supported_currencies 或接口支持列表。禁止传中文、股票代码、自然语言或占位符。 查询价格时还需提供 ids、names 或 symbols 中至少一项。—
include_tokensenum (top | all)Nofor `symbols` lookups, specify `all` to include all matching tokens Default `top` returns top-ranked tokens (by market cap or volume)—
include_24hr_volbooleanNoinclude 24hr volume, default: false—
include_market_capbooleanNoinclude market capitalization, default: false—
include_24hr_changebooleanNoinclude 24hr change percentage, default: false—
include_last_updated_atbooleanNoinclude 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-Key
Request 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
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