SuperAPI AI 工具集

coinglass

数据与分析

查看项目

更新于 10-16 09:35

技能介绍

用途:调用 CoinGlass 数据接口,研究加密永续合约市场与机构资金动向,例如比较 BTC 等现货 ETF 资金流、查看资金费率与爆仓情况。

主要能力:共 37 个工具,分 8 类。资金费率与持仓量(funding_rate、cg_open_interest);多空比(long_short_ratio、cg_global_account_ratio、cg_top_account_ratio、cg_top_position_ratio、cg_net_position);爆仓(cg_liquidations、cg_coin_liquidation_history、cg_pair_liquidation_history、cg_liquidation_coin_list);期货市场数据(cg_supported_coins、cg_pair_market_data、cg_ohlc_history);Hyperliquid 鲸鱼追踪(cg_hyperliquid_whale_alerts 等);成交量与流向(cg_taker_volume_history、cg_cumulative_volume_delta、cg_coin_netflow、cg_whale_transfers);ETF 资金流(BTC/ETH/SOL/XRP 及香港 ETF 的 flows、list、premium_discount)。

使用方式:脚本模式技能。先读取该文件,再在 bash 块中运行,例如: python3 - <<'EOF' import sys sys.path.insert(0, "/data/workspace/skills/coinglass") from exports import funding_rate, cg_open_interest print(funding_rate(symbol="BTC")) print(cg_open_interest(symbol="BTC")) EOF 完整函数签名见 exports.py。字段多为 camelCase,爆仓相关部分为 snake_case;funding 的 rate 是带 +/- / % 的字符串;avgFundingRateBySymbol 已是百分比数值,勿再乘 100;时间戳为毫秒。函数多返回 Optional[List[Dict]] 或 Optional[Dict],None 表示失败或为空,使用前需判断。

限制:平台注入的 COINGLASS_API_KEY 为 Startup 方案,速率限制较低,需控制批量调用。Startup 不可用接口包括 api/futures/coins-markets、单笔爆仓订单、爆仓热力图及 Hyperliquid 仓位分布,会返回 401 Upgrade plan;cg_liquidation_analysis 返回全零不可用。替代方案:用户自备 Basic+ 密钥直连 https://open-api-v4.coinglass.com(绕过 sc-proxy,否则密钥无效),或用 apify 技能抓取页面。全市场持仓量可用 coingecko 技能的 cg_derivatives。不要把不同来源的数据画在同一张图上。