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.
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). | bitcoin |
page | integer | No | Page through results. Default: 1 | — |
names | string | No | coins' names, comma-separated if querying more than 1 coin. | Bitcoin |
order | enum (market_cap_asc | market_cap_desc | volume_asc | volume_desc | id_asc | id_desc) | No | sort result by field, default: market_cap_desc | — |
locale | enum (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) | No | language background, default: en | — |
symbols | string | No | coins' symbols, comma-separated if querying more than 1 coin. | btc |
category | string | No | filter based on coins' category *refers to [`/coins/categories/list`](/reference/coins-categories-list). | layer-1 |
per_page | integer | No | Total results per page. Default: 100 Valid values: 1...250 | — |
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 | — |
sparkline | boolean | No | include sparkline 7 days data, default: false | — |
vs_currency | string | Yes | 必填。只能传 CoinGecko 支持的法币/计价货币代码,必须来自 coingecko_simple_supported_currencies 或接口支持列表。禁止传中文、股票代码、自然语言或占位符。 | usd |
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_rehypothecated | boolean | No | include rehypothecated tokens in results, default: false When true, returns `market_cap_rank_with_rehypothecated` field | false |
price_change_percentage | string | No | include price change percentage timeframe, comma-separated if query more than 1 timeframe Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y | 1h |
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_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
[
{
"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.

