Coinglass 提供加密货币衍生品与机构数据,资料称其覆盖 37 个工具,涵盖期货持仓、巨鲸追踪、成交量分析、爆仓与 ETF 资金流向。API 方案为 Professional(699 美元/月),速率限制 6000 请求/分钟,API 版本为 V4(兼容 V2),共 8 个类别 37 个工具。
【用途】 适用于以下分析方向:衍生品持仓(杠杆交易者在做什么)、巨鲸追踪(Hyperliquid DEX 上的大额持仓)、资金费率(持有永续合约的成本)、未平仓合约量(持仓总名义价值)、多空比(杠杆交易者情绪,含全局、头部账户、头部持仓)、爆仓(强制平仓及热力图与单笔订单)、成交量分析(主动成交成交量、CVD、净流模式)、ETF 流向(比特币、以太坊、Solana、XRP、香港)、巨鲸转账(链上大额转账,>1000 万美元)、期货市场数据(支持的币种、交易所、交易对及 OHLC 价格历史)。
【主要能力(8 类)】
- 基础衍生品分析(7 个工具):funding_rate(symbol, exchange?) 当前资金费率;long_short_ratio(symbol, exchange?, interval?) 基础多空比;cg_open_interest(symbol) 跨交易所当前 OI;cg_liquidations(symbol, time?) 近期爆仓;cg_liquidation_analysis(symbol) 爆仓热力图分析;cg_supported_coins() 全部支持币种;cg_supported_exchanges() 全部交易所及交易对。
- 高级多空比(6 个工具):cg_global_account_ratio、cg_top_account_ratio、cg_top_position_ratio、cg_taker_exchanges、cg_net_position、cg_net_position_v2。用途包括聪明钱追踪、特定交易所情绪、持仓规模分布分析。
- 高级爆仓(4 个工具):cg_coin_liquidation_history、cg_pair_liquidation_history、cg_liquidation_coin_list、cg_liquidation_orders。用途包括识别爆仓聚集、随时间追踪爆仓模式、发现大额爆仓事件。
- Hyperliquid 巨鲸追踪(4 个工具):cg_hyperliquid_whale_alerts、cg_hyperliquid_whale_positions、cg_hyperliquid_positions_by_coin、cg_hyperliquid_position_distribution,约 200 条近期大额头寸告警(>$1M)。
- 期货市场数据(5 个工具):cg_coins_market_data、cg_pair_market_data、cg_ohlc_history、cg_taker_volume_history、cg_aggregated_taker_volume。
- 成交量与流向分析(4 个工具):cg_cumulative_volume_delta、cg_coin_netflow、cg_whale_transfers。
- 比特币 ETF 数据(5 个工具):cg_btc_etf_flows、cg_btc_etf_premium_discount、cg_btc_etf_history、cg_btc_etf_list、cg_hk_btc_etf_flows。
- 其他 ETF 数据(8 个工具):以太坊、Solana、XRP 及香港 ETF 的流向、列表与溢价折价。
【使用方式】 需要 COINGLASS_API_KEY 环境变量。V4 端点使用 CG-API-KEY 请求头,V2 端点使用 coinglassSecret 请求头,二者均使用同一环境变量。币种使用标准符号(BTC、ETH、SOL 等),可用 cg_supported_coins() 核对;交易所可用 cg_supported_exchanges() 查询完整列表与交易对。多数历史端点支持 interval、limit、start_time、end_time(Unix 毫秒时间戳)等参数,例如 cg_coin_liquidation_history(symbol="BTC", interval="1h", limit=100, start_time=1704067200000, end_time=1704153600000)。资料建议优先使用批量端点以减少配额消耗。
支持的交易所:第一梯队含 Binance、OKX、Bybit、Gate、KuCoin、MEXC;传统交易所含 CME(比特币与以太坊期货)、Coinbase;DEX 含 Hyperliquid、dYdX、ApeX;其他含 Bitfinex、Kraken、HTX、BingX、Crypto.com、CoinEx、Bitget。
【适用场景与解读参考】 资料给出若干解读指引:资金费率超过 +0.05%(8h)为极度贪婪、多头拥挤;低于 -0.05% 为极度恐惧、空头拥挤。OI 与价格组合可判断新多、新空、空头回补与多头爆仓。多空比 >1.5 为多头拥挤(逆向看空),<0.7 为空头拥挤(逆向看多)。CVD 与价格组合可判断买压、派发、吸筹与卖压。ETF 大额流入为看多信号,溢价表示需求强。资料还给出多指标交叉确认、聪明钱与散户对比(cg_top_account_ratio 对比 cg_global_account_ratio)、级联预测与流向背离等分析模式。
【数据更新与限制】 市场数据不超过 1 分钟更新;资金费率每 8 小时(部分交易所每 1 小时);ETF 数据为每日(收盘后)。历史数据限制:爆仓订单仅过去 7 天、最多 200 条;巨鲸转账为过去 6 个月、最低 1000 万美元;Hyperliquid 告警约 200 条最近大额头寸。Hyperliquid 数据仅限该交易所,不含其他 DEX。巨鲸转账覆盖比特币、以太坊、Tron、Ripple、Dogecoin、Litecoin、Polygon、Algorand、Bitcoin Cash、Solana。ETF 数据中美国 ETF 在美股收盘后更新,香港 ETF 在香港市场收盘后更新。CVD 为累计指标,不会自动重置,应关注变化量而非绝对值。
【版本历史】 v3.0.0(2025-03)新增 36 个工具,含高级爆仓、Hyperliquid 巨鲸追踪、成交量与流向、巨鲸转账、比特币 ETF、其他 ETF、高级多空比;v2.2.0(2024)迁移至 V4 API 并加入期货市场数据;v1.0.0(2024)初始版本,含基础衍生品数据。