CoinGlass API 是做什么的？
CoinGlass API 面向以下用户场景设计：
• 量化交易 / 策略研究
• 交易工具 & 行情看板
• 风控与风险预警系统
• 机构级衍生品数据分析
在这篇入门文章中，你将学会如何用 CoinGlass API v4 获取三类最核心的数据：
• 清算数据（Liquidation）
• 持仓量（Open Interest）
• 资金费率（Funding Rate）
为什么爆仓（Liquidation）、持仓量（OI）和资金费率（Funding Rate）数据很重要
大多数交易者只看价格。
而专业交易者关注的是：
• 爆仓（Liquidation）：哪里会发生被动平仓
• 持仓量（Open Interest）：杠杆是否在堆积
• 资金费率（Funding Rate）：市场多空是否极端失衡
CoinGlass API v4 提供了跨交易所、统一口径的衍生品数据接口，让你可以用代码直接获取这些核心信号。
⸻
整个过程不超过 5 分钟。
⸻
Step 1：获取 API Key（1 分钟完成）
1. 注册 / 登录 CoinGlass
CoinGlass API v4 使用 HTTP Header 鉴权：
CG-API-KEY: YOUR_API_KEY
👉 前往生成 API Key
⸻
Step 2：获取爆仓数据（Liquidation）
接口说明（v4）
• Base URL
https://open-api-v4.coinglass.com/
• Endpoint
GET /api/futures/liquidation/history
该接口用于获取指定交易对的爆仓历史数据（按时间区间聚合）。
⸻
Python 示例代码
import requests
BASE_URL = "https://open-api-v4.coinglass.com"/
HEADERS = {
"accept": "application/json",
"CG-API-KEY": "YOUR_API_KEY"
}
response = requests.get(
f"{BASE_URL}/api/futures/liquidation/history",
headers=HEADERS,
# 示例参数，具体以官方文档为准
params={
"symbol": "BTCUSDT",
"exchange": "Binance",
"interval": "1h"
}
)
print(response.json())
⸻
为什么爆仓数据很重要？
爆仓代表的是 被动、强制成交，通常发生在：
• 行情极端波动
• 杠杆过度堆积
• 趋势临近阶段性拐点
爆仓数据常被用于：
• 爆仓预警
• 波动率监控
• 极端行情识别
👉 查看“爆仓历史” API 文档
⸻
Step 3：获取持仓量（Open Interest）
接口说明（v4）
GET /api/futures/open-interest/history
持仓量（OI）反映的是：
市场中未平仓合约的总规模
⸻
Python 示例
response = requests.get(
f"{BASE_URL}/api/futures/open-interest/history",
headers=HEADERS,
# 示例参数，具体以官方文档为准
params={
"symbol": "BTCUSDT",
"exchange": "Binance",
"interval": "1h"
}
)
print(response.json())
⸻
OI 的典型解读方式
• 价格上涨 + OI 上升
→ 新杠杆进场，趋势被强化
• 价格上涨 + OI 下降
→ 平仓推动，趋势可能衰减
OI 是判断行情“是否健康”的关键指标之一。
⸻
Step 4：获取资金费率（Funding Rate）
接口说明（v4）
GET /api/futures/funding-rate/history
资金费率用于维持永续合约价格与现货价格的一致性。
⸻
Python 示例
response = requests.get(
f"{BASE_URL}/api/futures/funding-rate/history",
headers=HEADERS,
# 示例参数，具体以官方文档为准
params={
"symbol": "BTCUSDT",
"exchange": "Binance",
"interval": "1h"
}
)
print(response.json())
⸻
资金费率可以告诉你什么？
• 资金费率持续为正
→ 多头拥挤，多头支付空头
• 资金费率极端偏离
→ 市场情绪可能过热，存在反转风险
资金费率经常与清算、OI 结合使用，用于判断拥挤交易。
⸻
用这三类数据，你能做什么？
只使用 清算 + OI + Funding，你就可以构建：
• 实时爆仓预警系统
• 杠杆堆积监控指标
• 假突破 / 诱多诱空过滤器
• 波动风险预警模型
👉 查看 “资金费率” API 文档
⸻
下一步：更高级的数据能力
除了本文介绍的基础指标，CoinGlass API 还提供：
• 订单簿深度（Order Book Depth）
• 订单流 / 主动成交（Order Flow）
• 流动性分布（Liquidity）
• 大额成交（Large Trades）
这些 进阶数据 更适合专业交易员、量化团队与机构用户，我们将在后续文章中详细拆解。
⸻
如果你正在构建任何与加密衍生品相关的工具或策略：
CoinGlass API 可以作为你的数据底座。
👉 立即开始使用 CoinGlass API
