一次获取全部合约币种在 5 分钟到 24 小时多个时间段内的价格涨跌幅和振幅。适合做涨跌幅排行、异动提醒和波动率筛选。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等级可以调用本接口:标准 专业 企业
响应数据
data 为数组,每个元素是一个币种。截至 2026-10-20 共返回 1247 个币种,右侧示例只保留了前 2 条。个别币种可能不返回某些周期的涨跌幅或振幅字段,读取前请先判断字段是否存在,缺失时不要当作 0。
涨跌幅和振幅已经是百分数
price_change_percent_*和price_amplitude_percent_*的单位都是 %,0.24表示 0.24%,不需要再乘以 100。
200 · application/json · 响应示例见右侧面板。
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
code | string | 是 | 业务状态码,"0" 表示成功 |
msg | string | 否 | 结果说明;出错时为错误信息 |
data | array of object | 是 | 币种列表,每个元素是一个币种的多周期涨跌幅和振幅 |
data[].symbol | string | 是 | 币种代码 |
data[].current_price | number | 是 | 当前价格,美元 |
data[].price_change_percent_5m | number | 否 | 5 分钟价格涨跌幅,单位 %;个别币种可能不返回 |
data[].price_change_percent_15m | number | 否 | 15 分钟价格涨跌幅,单位 %;个别币种可能不返回 |
data[].price_change_percent_30m | number | 否 | 30 分钟价格涨跌幅,单位 %;个别币种可能不返回 |
data[].price_change_percent_1h | number | 否 | 1 小时价格涨跌幅,单位 %;个别币种可能不返回 |
data[].price_change_percent_4h | number | 否 | 4 小时价格涨跌幅,单位 %;个别币种可能不返回 |
data[].price_change_percent_12h | number | 否 | 12 小时价格涨跌幅,单位 %;个别币种可能不返回 |
data[].price_change_percent_24h | number | 否 | 24 小时价格涨跌幅,单位 %;个别币种可能不返回 |
data[].price_amplitude_percent_5m | number | 否 | 5 分钟价格振幅,单位 %;个别币种可能不返回 |
data[].price_amplitude_percent_15m | number | 否 | 15 分钟价格振幅,单位 %;个别币种可能不返回 |
data[].price_amplitude_percent_30m | number | 否 | 30 分钟价格振幅,单位 %;个别币种可能不返回 |
data[].price_amplitude_percent_1h | number | 否 | 1 小时价格振幅,单位 %;个别币种可能不返回 |
data[].price_amplitude_percent_4h | number | 否 | 4 小时价格振幅,单位 %;个别币种可能不返回 |
data[].price_amplitude_percent_12h | number | 否 | 12 小时价格振幅,单位 %;个别币种可能不返回 |
data[].price_amplitude_percent_24h | number | 否 | 24 小时价格振幅,单位 %;个别币种可能不返回 |
API 等级
只有下表中标为可以的 API 等级能调用本接口。各等级价格见 API 等级。
| API 等级 | 能否调用 |
|---|---|
| 业余 | ❌ 不可以 |
| 初创 | ❌ 不可以 |
| 标准 | ✅ 可以 |
| 专业 | ✅ 可以 |
| 企业 | ✅ 可以 |
用 AI 调用本接口
选一个任务,点「在 ChatGPT 中打开」或「在 Claude 中打开」,AI 会先读取本页说明,再直接给出结果;也可以点「复制」,把完整提示词粘贴到你常用的 AI 工具里。
想让 AI 直接查询实时数据、不写代码?在 Claude、Cursor 中接入 CoinGlass MCP 后直接用中文提问,例如「过去 1 小时合约市场里涨得最多的币种有哪些?」。
应用场景
| 场景 | 说明 |
|---|---|
| 涨跌幅排行榜 | 一次拿到全部币种多个时间段的涨跌幅,直接生成涨幅榜、跌幅榜。 |
| 短线异动提醒 | 监控 5 分钟、15 分钟的涨跌幅和振幅,发现突然拉升或砸盘的币种。 |
| 波动率筛选 | 按 24 小时振幅筛选波动大的币种,用于短线交易或风控。 |
| 市场强弱判断 | 统计上涨和下跌币种的数量,判断整体市场偏强还是偏弱。 |
相关接口
常见问题
0.24 是 0.24% 还是 24%?
是 0.24%。涨跌幅和振幅字段都已经是百分数,不需要再乘以 100。
涨跌幅和振幅有什么区别?
涨跌幅反映时段内价格从起点到现在的变化方向和幅度,可以为负;振幅反映时段内价格波动范围的大小,不区分方向。
哪些 API 等级可以调用?
标准、专业、企业等级可以调用;业余、初创等级不能调用本接口。
多久更新一次?
实时更新。
深入了解:币种涨跌幅与振幅
价格振幅是什么意思?
振幅衡量一段时间内价格波动的范围,通常与该时段最高价和最低价的差距有关。振幅大说明价格上下波动剧烈,即使涨跌幅接近 0 也可能振幅很大。
为什么要看多个时间段的涨跌幅?
短时间段(5 分钟、15 分钟)反映突发异动,长时间段(12 小时、24 小时)反映趋势。多个时间段对照,可以区分短线波动和趋势行情。
如何获取历史价格?
本接口只返回当前的涨跌幅。需要历史走势,请使用「交易对 K 线历史」。
