Skip to main content
GET
Coins List with Market Data
一次调用返回覆盖多个币种的排名行情表:每个币种一行,包含 current_price、market_cap、market_cap_rank、total_volume、high_24h、low_24h、price_change_percentage_24h、circulating_supply、total_supply、max_supply、带日期的 ath 和 atl,以及 image。用 per_page 和 page 分页,用 order 排序(按市值、成交量或 id,升序或降序),用 ids 或 category 收窄范围。传入 price_change_percentage 会额外返回对应的 price_change_percentage_24h_in_currency 字段。适合用于榜单和板块扫描。如果只需要少数已知币种的价格,get_coingecko_simple_price 更轻量;如需某一币种的完整信息,请使用 get_coingecko_coins_id。
第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

category
string

Filter based on coins' category. *refers to /coins/categories/list

ids
string
默认值:bitcoin

Coins' IDs, comma-separated if querying more than 1 coin. *refers to /coins/list

include_rehypothecated
boolean

Include rehypothecated tokens in results. When true, returns market_cap_rank_with_rehypothecated field. Default: false

include_tokens
enum<string>

For symbols lookups, specify all to include all matching tokens. Default top returns top-ranked tokens by market cap or volume.

可用选项:
top,
all
locale
enum<string>

Language background. Default: en

可用选项:
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
names
string
默认值:Bitcoin

Coins' names, comma-separated if querying more than 1 coin.

order
enum<string>

Sort result by field. Default: market_cap_desc

可用选项:
market_cap_asc,
market_cap_desc,
volume_asc,
volume_desc,
id_asc,
id_desc
page
integer

Page through results. Default: 1

per_page
integer

Total results per page. Default: 100 Valid values: 1...250

precision
enum<string>

Decimal places for currency price value

可用选项:
full,
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18
price_change_percentage
string

Include price change percentage timeframe, comma-separated if querying more than 1 timeframe. Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y

sparkline
boolean

Include sparkline 7-day data. Default: false

symbols
string
默认值:btc

Coins' symbols, comma-separated if querying more than 1 coin.

vs_currency
string
默认值:usd
必填

Target currency of coins and market data. *refers to /simple/supported_vs_currencies

响应

List of coins with market data

id
string
必填

Coin ID

symbol
string
必填

Coin symbol

name
string
必填

Coin name

image
string
必填

Coin image URL

current_price
number | null
必填

Current price in target currency

market_cap
number | null
必填

Market cap in target currency

market_cap_rank
integer | null
必填

Market cap rank

fully_diluted_valuation
number | null
必填

Fully diluted valuation in target currency

total_volume
number | null
必填

Total trading volume in target currency

high_24h
number | null
必填

24-hour price high in target currency

low_24h
number | null
必填

24-hour price low in target currency

price_change_24h
number | null
必填

24-hour price change in target currency

price_change_percentage_24h
number | null
必填

24-hour price change percentage

market_cap_change_24h
number | null
必填

24-hour market cap change in target currency

market_cap_change_percentage_24h
number | null
必填

24-hour market cap change percentage

circulating_supply
number | null
必填

Circulating supply

total_supply
number | null
必填

Total supply

max_supply
number | null
必填

Max supply

ath
number | null
必填

All-time high price in target currency

ath_change_percentage
number | null
必填

All-time high change percentage

ath_date
string<date-time> | null
必填

All-time high date

atl
number | null
必填

All-time low price in target currency

atl_change_percentage
number | null
必填

All-time low change percentage

atl_date
string<date-time> | null
必填

All-time low date

roi
object | null
必填

Return on investment data

last_updated
string<date-time>
必填

Last updated timestamp

market_cap_rank_with_rehypothecated
integer | null

Market cap rank including rehypothecated tokens

sparkline_in_7d
object

Sparkline price data for the last 7 days

price_change_percentage_1h_in_currency
number | null

1-hour price change percentage in target currency

price_change_percentage_24h_in_currency
number | null

24-hour price change percentage in target currency

price_change_percentage_7d_in_currency
number | null

7-day price change percentage in target currency

price_change_percentage_14d_in_currency
number | null

14-day price change percentage in target currency

price_change_percentage_30d_in_currency
number | null

30-day price change percentage in target currency

price_change_percentage_200d_in_currency
number | null

200-day price change percentage in target currency

price_change_percentage_1y_in_currency
number | null

1-year price change percentage in target currency