CoinGecko Coins Markets

0.5 credits/call
ae_coingecko_coins_markets

Get CoinGecko market data for cryptocurrencies, including prices, market caps, trading volume, rankings, price changes, and optional 7-day sparklines.

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).bitcoin
pageintegerNoPage through results. Default: 1—
namesstringNocoins' names, comma-separated if querying more than 1 coin.Bitcoin
orderenum (market_cap_asc | market_cap_desc | volume_asc | volume_desc | id_asc | id_desc)Nosort result by field, default: market_cap_desc—
localeenum (ar | bg | cs | da | de | el | en | es | fi | fr | he | hi | hr | hu | id | it | ja | ko | lt | nl | no | pl | pt | ro | ru | sk | sl | sv | th | tr | uk | vi | zh | zh-tw)Nolanguage background, default: en—
symbolsstringNocoins' symbols, comma-separated if querying more than 1 coin.btc
categorystringNofilter based on coins' category *refers to [`/coins/categories/list`](/reference/coins-categories-list).layer-1
per_pageintegerNoTotal results per page. Default: 100 Valid values: 1...250—
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—
sparklinebooleanNoinclude sparkline 7 days data, default: false—
vs_currencystringYes必填。只能传 CoinGecko 支持的法币/计价货币代码,必须来自 coingecko_simple_supported_currencies 或接口支持列表。禁止传中文、股票代码、自然语言或占位符。usd
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_rehypothecatedbooleanNoinclude rehypothecated tokens in results, default: false When true, returns `market_cap_rank_with_rehypothecated` fieldfalse
price_change_percentagestringNoinclude price change percentage timeframe, comma-separated if query more than 1 timeframe Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y1h

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_coins_markets' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "ids": "solana",
    "order": "market_cap_desc",
    "page": 1,
    "per_page": 1,
    "vs_currency": "usd"
  }
}'
Response exampleresponse.json
JSONPartial content
[
  {
    "ath": 126080,
    "ath_change_percentage": -40.59936,
    "ath_date": "2025-10-06T10:57:42.000Z",
    "atl": 67.81,
    "id": "bitcoin",
    "name": "Bitcoin"
  }
]

This example shows part of the response. Copied content is valid JSON.