mcpField
C
coinglass

coinglass

github.com/starchild-ai-agentその他3011.5k 回インストール1 週間前に更新
リポジトリ

coinglass について

coinglassは、CoinGlassの暗号資産デリバティブおよび機関投資家向けデータを照会する関数を備えたスクリプトモードのスキルです。市場ポジション、清算、クジラの動向、取引フロー、ETFデータを扱い、記載された利用範囲はStartupプランの制限を受けます。

主な機能

  1. 01資金調達率と未決済建玉
  2. 02ロング・ショート比率とネットポジション
  3. 03清算の概要と履歴
  4. 04クジラのアラートと送金
  5. 05取引量とフロー指標
  6. 06ETFのフロー、一覧、プレミアム

活用シーン

  1. 01通貨の資金調達率と未決済建玉を確認
  2. 02取引所ごとのロング・ショートポジションを確認
  3. 03清算の履歴と概要を調査
  4. 04クジラの送金やETFフローを追跡

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/starchild-ai-agent/official-skills --skill coinglass

インストール後、Claude Code で/coinglassを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

__init__.py
coinglass.py
coinglass.py.backup2
exports.py
tools/
__init__.py
_api.py
bitcoin_etf.py
funding_rate.py
futures_market.py
hyperliquid.py
liquidations_advanced.py
liquidations.py
long_short_advanced.py
long_short_ratio.py
open_interest.py
other_etfs.py
volume_flow.py
whale_transfer.py

詳細

プラン階層（プラットフォームキー = Startup、2026-09 検証済み）

プラットフォームから注入される COINGLASS_API_KEY は Startup プランです。ツール層で実際にアクセスできるエンドポイントは次のとおりです。

✅ Startup で利用可能（通常のデータ）:

  • Funding rates（v2/v4）、対応コイン/取引所/ペア、ペア市場
  • Open interest（現在値 / OHLC 履歴 / 集計履歴）
  • Long/Short レシオ（グローバル / トップアカウント / トップポジション）
  • Taker 買い/売り出来高（単一取引所 + 集計。集計には exchange_list が必要）
  • CVD、Net position（v1/v2）、コインネットフロー
  • 清算: コイン一覧、コイン/ペア履歴（ペアは BTCUSDT 形式が必要）、集計履歴（exchange_list が必要）
  • ETF フロー / 一覧 / プレミアム（BTC、ETH、SOL、XRP、HK）
  • クジラ転送、Hyperliquid クジラアラート（アラートフィードのみ）
  • 価格履歴（シンボルはペア形式、例: BTCUSDT）

❌ Startup では利用不可（401「Upgrade plan」— これらはスキップし、呼び出さないでください）:

  • api/futures/coins-markets（全コイン市場サマリー、すなわち cg_coins_market_data）— 呼び出さないでください。以下の「全市場 / 複数コイン OI ルーティング」を使用してください
  • api/futures/liquidation/order（個別の清算注文）
  • api/futures/liquidation/heatmap/model1 + aggregated-heatmap/model1（清算ヒートマップは完全に利用不可）
  • api/hyperliquid/position、api/hyperliquid/wallet/position-distribution（Hyperliquid ポジション分布。クジラアラートのみ動作します）

代替手段（優先順）:

  1. ユーザーが自身のキーを用意する（Basic+ プラン）: COINGLASS_API_KEY を設定し、 https://open-api-v4.coinglass.com を直接呼び出して sc-proxy をバイパスします（sc-proxy はそのヘッダーを上書きするため、プロキシ経由のパスではユーザーキーは効果がありません）。
  2. Apify スクレイパー: apify スキルを使用して、coinglass.com 上の清算ヒートマップ / Hyperliquid ポジションページをスクレイピングします。

401「Upgrade plan」レスポンスを受け取ると、cg_request は CoinglassPlanError を発生させ、エラーメッセージにはすでにこのガイダンスが含まれています。

全市場 / 複数コイン OI ルーティング（coins-markets は利用不可）
目的使用するもの備考
1 コインの現在 OI と 4h/24h 変化cg_open_interest(symbol)（exchangeName=="All" の行を取得）Startup で動作します
1 コインのファンディングfunding_rate(symbol)% を含む文字列を返します
コイン全体の OI 履歴コインごとの OI 履歴をタイムスタンプで合計バー間隔を明記して「Top-N 集計」とラベル付けしてください。全市場として提示しないでください
全市場の現在 OI 合計 / コインごとの現在 OIcoingecko スキル cg_derivatives(include_tickers='unexpired'): contract_type=="perpetual" を保持し、index_id ごとに open_interest（USD）を合計取引所報告値で、小規模取引所も含み、CoinGlass より高くなります。現在値のみで履歴はありません。チャートとテキストで常に出典を明記してください

異なるソース（CoinGlass Top-N、CoinGecko 全市場、Bloomberg などの第三者）の数値を、比較や参照線として 1 つのチャートにプロットしないでください。

清算ヒートマップ（❌ Startup では利用不可 — アーカイブされた使い方）

cg_liquidation_analysis はすべてゼロを返し、使用できません。両方のヒートマップエンドポイント（heatmap/model1 と aggregated-heatmap/model1）は、Startup プランでは 401 Upgrade plan を返します。

ヒートマップデータが必要な場合: ユーザーに Basic+ キーを用意してもらい直接呼び出すか（上記の代替手段を参照）、Apify でページをスクレイピングしてください。

# Only works with a user-owned higher-tier key (direct, not via sc-proxy)
from tools._api import cg_request

# Full-market aggregated heatmap (recommended, no exchange needed)
# range supports: 12h, 24h, 3d, 7d, 30d, 90d, 180d, 1y
data = cg_request("api/futures/liquidation/aggregated-heatmap/model1",
                  params={"symbol": "BTC", "range": "24h"})

# Response structure:
# data["y_axis"]                   → price levels (low to high)
# data["liquidation_leverage_data"] → [[y_idx, leverage, usd_value], ...]
# data["price_candlesticks"]        → OHLCV candles; last close = current price
# data["update_time"]               → update timestamp

# How to parse:
from collections import defaultdict
y_axis = data["y_axis"]
current_price = float(data["price_candlesticks"][-1][4])
price_liq = defaultdict(float)
for y_idx, leverage, usd_val in data["liquidation_leverage_data"]:
    if 0 <= y_idx < len(y_axis):
        price_liq[y_axis[y_idx]] += usd_val

longs  = {p: v for p, v in price_liq.items() if p < current_price}  # long liquidations (triggered on the way down)
shorts = {p: v for p, v in price_liq.items() if p > current_price}  # short liquidations (triggered on the way up)

スクリプトの使用方法

スクリプトモードのスキル — このファイルを読み、bash ブロックから呼び出します:

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/coinglass")
from exports import funding_rate, cg_open_interest, cg_liquidations

print(funding_rate(symbol="BTC"))
print(cg_open_interest(symbol="BTC"))
EOF

利用可能な関数の完全なリストと正確なシグネチャについては exports.py を参照してください。よく使うもの: funding_rate、long_short_ratio、 cg_open_interest、cg_liquidations、cg_liquidation_analysis、 cg_global_account_ratio、cg_top_account_ratio、cg_top_position_ratio、 cg_taker_exchanges、cg_net_position、cg_supported_coins、 cg_supported_exchanges、cg_coins_market_data、cg_pair_market_data、 cg_ohlc_history、cg_hyperliquid_whale_alerts、 cg_hyperliquid_whale_positions、cg_taker_volume_history、 cg_aggregated_taker_volume、cg_cumulative_volume_delta、 cg_coin_netflow、cg_whale_transfers、cg_btc_etf_flows、 cg_eth_etf_flows、cg_sol_etf_flows。

Coinglass

Coinglass は、利用可能な中で最も包括的な暗号資産デリバティブおよび機関投資家データを提供します。先物のポジション、クジラの追跡、出来高分析、清算、ETF フローをカバーする 37 のツールを備えています。

API プラン: Startup（プラットフォームキーがダウングレードされています。先頭の「プラン階層」を参照） レート制限: このプランではリクエスト制限が低くなっています。バッチ呼び出しは控えめにしてください API バージョン: V4（V2 の後方互換性あり） ツール総数: 8 カテゴリにわたる 37 ツール

関数リファレンス（完全なシグネチャ + 戻り値の形状）

すべての関数は exports.py にあります。ほとんどは Optional[List[Dict]] または Optional[Dict] を返します。None は上流の呼び出しが失敗したか空を返したことを意味します — インデックスを付ける前に必ず確認してください。

⚠️ フィールド命名規則（最初にお読みください）

CoinGlass v4 API は、清算エンドポイントにあるいくつかのレガシーな snake_case の例外を除き、ほぼすべてのデータフィールドに camelCase を使用します。snake_case だと決めつけないでください — スクリプトを書く前に dict を inspect してください。

  • camelCase: openInterest、volUsd、longRate、shortVolUsd、 exchangeName、nextFundingTime、fundingIntervalHours、 oichangePercent、h4OIChangePercent、avgFundingRateBySymbol、 tokenAmount、liquidationUsd（一部のエンドポイント）
  • snake_case（レガシー、cg_liquidations のみ）: liquidation_usd、 longLiquidation_usd、shortLiquidation_usd
  • rate フィールド（ファンディング）は "+" / "-" / "%" を含む文字列です — 数値として比較するには float(r.rstrip('%').lstrip('+')) でパースしてください
  • avgFundingRateBySymbol（cg_open_interest の行にある）は、 すでにパーセント単位の数値です — 0.005313 は 0.0053%/8h を意味します。100 を掛けないでください。妥当性の目安: BTC のファンディングは通常 ±0.01%/8h 程度です。~0.1%/8h を超えるものは、ほぼ間違いなく単位のバグです。
  • タイムスタンプはミリ秒の Unix エポックです（例: 1777881600000）
ファンディング & 未決済建玉
関数シグネチャ
funding_rate(symbol, exchange=None)dict — キー: symbol、exchange、rate（文字列）、num_exchanges、exchanges_data（{exchangeName、rate、nextFundingTime、fundingIntervalHours、status} のリスト）
cg_open_interest(symbol='BTC', interval='0')dict のリスト（取引所ごとに 1 つ）— キー: symbol、openInterest、volUsd、oichangePercent、h4OIChangePercent、h24VolChangePercent、volChangePercent7d、avgFundingRateBySymbol、exchangeName、exchangeLogo
ロング/ショート比率
関数シグネチャ
long_short_ratio(symbol='BTC', interval='h4')リスト — 先頭の項目は集計値です。内部の list フィールドに取引所ごとの内訳があります。キー: longRate、shortRate、longVolUsd、shortVolUsd、totalVolUsd、list
cg_global_account_ratio(symbol='BTC', exchange='Binance', interval='1h')履歴バーのリスト
cg_top_account_ratio(symbol='BTC', exchange='Binance', interval='1h')リスト — トップトレーダーのアカウント数比率
cg_top_position_ratio(symbol='BTC', exchange='Binance', interval='1h')リスト — トップトレーダーのポジションサイズ比率
cg_taker_exchanges(symbol='BTC', range_type='4h')リスト — 取引所全体のテイカーの買い/売り
cg_net_position(symbol='BTC', exchange='Binance', interval='1h')リスト — 時間経過に伴うネットのロング・ショート USD
清算
関数シグネチャ
cg_liquidations(symbol='BTC', time_type='h24')dict の LIST（取引所ごとに1つ + 先頭に 'All' 行）。キー: exchange、liquidation_usd、longLiquidation_usd、shortLiquidation_usd（注記: snake_case のレガシーフィールド）
cg_liquidation_analysis(symbol='BTC', time_type='h24')dict — ネットワーク全体の集計統計
cg_coin_liquidation_history(symbol='BTC', interval='h4')list — 過去の清算バー
cg_pair_liquidation_history(symbol='BTC', exchange='Binance', interval='h4')list — 1つの取引所における1つのペアの過去の清算
cg_liquidation_coin_list(symbol=None)清算サマリー付きの全コインのリスト
cg_liquidation_orders(symbol='BTC', exchange=None)list — 最近の個別清算注文
先物市場データ
関数シグネチャ
cg_supported_coins()List[str] — CoinGlass がサポートするシンボル
cg_supported_exchanges()取引所情報の dict のリスト
cg_coins_market_data(symbol=None)❌ Startup では利用不可（401）— 「フルマーケット / マルチコイン OI ルーティング」を参照
cg_pair_market_data(symbol='BTC', exchange=None)list — ペアレベルのスナップショット
cg_ohlc_history(symbol='BTC', interval='h4', exchange=None)OHLCV バーのリスト
Hyperliquid クジラ追跡
関数シグネチャ
cg_hyperliquid_whale_alerts()list — 最近の大口ポジションアラート
cg_hyperliquid_whale_positions()list — 現在のクジラのオープンポジション
cg_hyperliquid_positions_by_coin(symbol='BTC')list — 特定のコインを保有するクジラ
cg_hyperliquid_position_distribution(symbol='BTC')dict — ロング/ショートのポジションサイズ分布
出来高 / フロー
関数シグネチャ
cg_taker_volume_history(symbol='BTC', exchange='Binance', interval='1h', limit=1000, start_time=None, end_time=None)list — テイカー買い/売り出来高バー
cg_aggregated_taker_volume(symbol='BTC', interval='h4')list — 全取引所を集計
cg_cumulative_volume_delta(symbol='BTC', exchange='Binance', interval='1h', limit=1000, start_time=None, end_time=None)list — CVD バー
cg_coin_netflow(symbol=None)list — コインごとの純流入/流出
cg_whale_transfers()dict — 最近のオンチェーン大口送金
ETF フロー
関数シグネチャ
cg_btc_etf_flows()list — 米国 BTC ETF ごとの日次フロー
cg_btc_etf_history(etf_ticker=None)list — 過去の AUM/フロー
cg_btc_etf_list()BTC ETF のティッカー + AUM のリスト
cg_btc_etf_premium_discount()list — NAV に対するプレミアム/ディスカウント %
cg_hk_btc_etf_flows()list — 香港 BTC ETF のフロー
cg_eth_etf_flows() / cg_eth_etf_list() / cg_eth_etf_premium_discount() / cg_hk_eth_etf_flows()ETH ETF の相当機能
cg_sol_etf_flows() / cg_sol_etf_list()SOL ETF データ
cg_xrp_etf_flows() / cg_xrp_etf_list()XRP ETF データ
サンプルレスポンス（最も使用される関数）

funding_rate(symbol="BTC"):

{
  "symbol": "BTC",
  "exchange": "average",
  "rate": "-0.0016%",
  "num_exchanges": 21,
  "exchanges_data": [
    {"exchangeName": "Binance", "rate": "+0.0050%",
     "nextFundingTime": 1777881600000, "fundingIntervalHours": 8, "status": 1}
  ]
}

cg_liquidations(symbol="BTC", time_type="h24"):

[
  {"exchange": "All", "liquidation_usd": 170497688.16,
   "longLiquidation_usd": 8179073.80, "shortLiquidation_usd": 162318614.36},
  {"exchange": "Bybit", "liquidation_usd": 40454694.98, ...}
]

cg_open_interest(symbol="BTC"):

[
  {"symbol": "BTC", "openInterest": 61395303653.62, "volUsd": 56349328748.42,
   "oichangePercent": 7.17, "h4OIChangePercent": 5.33,
   "avgFundingRateBySymbol": -0.001874, "exchangeName": "Binance"}
]

long_short_ratio(symbol="BTC", interval="h4"):

[{
  "symbol": "BTC", "longRate": 53.65, "shortRate": 46.35,
  "longVolUsd": 12558668895.91, "shortVolUsd": 10848776476.99,
  "totalVolUsd": 23407445372.91,
  "list": [
    {"exchangeName": "Binance", "longRate": 55.75, "shortRate": 44.25, ...}
  ]
}]

ツール選択ガイド

デシジョンツリー

ステップ 1: これは清算に関するものですか？

Liquidation query?
├─ YES → How many coins?
│   ├─ ALL coins / ranking / summary
│   │   └─ → cg_liquidation_coin_list  ✅ (most liquidation queries land here)
│   ├─ ONE coin, need history over time
│   │   └─ → cg_coin_liquidation_history
│   ├─ ONE coin, specific orders (price/side/USD)
│   │   └─ → cg_liquidation_orders
│   └─ ONE coin, just a quick total + sentiment label
│       └─ → cg_liquidation_analysis  (rarely needed; only if explicitly "simple summary")

ステップ 2: これはロング/ショート比率に関するものですか？

Long/short query?
├─ Historical time-series, trend over time, L/S ratio change
│   └─ → cg_global_account_ratio  (ALL accounts)
│      or cg_top_account_ratio    (top traders only)
│      or cg_top_position_ratio   (by position size)
└─ Current snapshot only (no history needed)
    └─ → long_short_ratio

ステップ 3: これはオープンインタレストに関するものですか？

OI query?
└─ → cg_open_interest  (always — do NOT use cg_coins_market_data for OI)

ステップ 4: これは市場概況 / センチメントのクエリですか？

Sentiment / pre-trade check?
└─ Use: funding_rate + long_short_ratio + cg_open_interest
   DO NOT use cg_coins_market_data as a substitute for any of the above
キーワード → ツール検索
キーワード / パターン正しいツール❌ 使用しないでください
清算ランキング / 本日の清算 / 全コイン清算cg_liquidation_coin_listcg_liquidations
24時間清算サマリーcg_liquidation_coin_listcg_liquidation_analysis
グローバル口座 L/S 比率cg_global_account_ratiolong_short_ratio
トップトレーダー L/S 比率cg_top_account_ratiolong_short_ratio
建玉cg_open_interestcg_coins_market_data
市場センチメント / ポジション分析funding_rate + long_short_ratio + cg_open_interestcg_coins_market_data
BTC ロング事前チェックリストfunding_rate + cg_global_account_ratio + cg_liquidation_coin_list—
よくある間違い

間違い 1（最も一般的 — 失敗 8 回）: cg_liquidation_coin_list が必要なときに cg_liquidations を使用する

  • cg_liquidations → 1 コイン、1 時間枠、基本的な合計のみ
  • cg_liquidation_coin_list(exchange) → すべてのコイン、複数時間枠（1h/4h/12h/24h）、取引所別の内訳
  • ルール: 質問がランキング、概要を求める場合、または単一のコインを指定しない場合 → cg_liquidation_coin_list を使用してください

間違い 2（失敗 5 回）: 清算ランキングに cg_liquidation_analysis を使用する

  • cg_liquidation_analysis は単一コインの合計にセンチメントラベルを追加するもので、ランキングツールではありません
  • ルール: 「本日の清算ランキング」/「コイン別清算」→ 常に cg_liquidation_coin_list

間違い 3（失敗 3 回）: ヒストリカル L/S 分析に long_short_ratio を使用する

  • long_short_ratio は現在のスナップショットです（時系列なし）
  • cg_global_account_ratio は履歴を返します — ユーザーがトレンドや経時的な比較を求める場合に使用してください
  • ルール: 質問がグローバル口座とトップトレーダーを比較する場合 → cg_global_account_ratio と cg_top_account_ratio の両方を呼び出してください

間違い 4（失敗 2 回）: 建玉に cg_coins_market_data を使用する

  • cg_coins_market_data は多数のコインの一括スナップショットであり、専用の OI ツールや L/S ツールの代わりにはなりません
  • ルール: OI の質問 → cg_open_interest。L/S の質問 → long_short_ratio または cg_global_account_ratio。どちらも cg_coins_market_data にルーティングしないでください。

ルール

ツール呼び出しのガイダンス

❌ 禁止ツール — 絶対に使用しないでください:

  • bash — データを処理/整形するスクリプトを書かないでください。自然言語を使用してください。
  • write_file / read_file / edit_file — 中間データを保存しないでください。直接回答してください。
  • learning_log — 真のスキルバグまたは永続的な API エラーのみに使用してください。空のレスポンスには使用しないでください。
  • echo — デバッグや出力に使用しないでください。

✅ 正しいパターン:

  • ツールがデータを返す → 自然言語で要約 → 完了
  • ツールが空/null を返す → 「データがありません」と報告 → 完了
  • 計算が必要（%、変化、比率）→ 回答内で暗算してください

ツール数を質問の範囲に合わせてください:

  • 単一指標の質問（「BTC ファンディングレート」、「ETH ロング/ショート比率」）→ 1 ツール、直接回答
  • 多次元分析（「ロングするのに良いタイミングか」、「デリバティブの健全性チェック」）→ 3〜5 ツール、統合
  • 比較（「ETH vs SOL」）→ コインごとに同じツール、並べて比較
  • 同じツールを 2 回呼び出すことは避けてください。ただし、ユーザーが明示的にコイン間 / 取引所間の比較を求める場合を除きます。
ラーニングログの使用（重要）

learning_log は以下の場合に禁止です:

  • ❌ 空の API レスポンス — 「データがありません」と報告するだけにしてください
  • ❌ ツールが None/null を返す — 適切に処理してください
  • ❌ ツール選択に関する不確実性 — まずデシジョンツリーを確認してください
  • ❌ 通常のツールエラー — 1 回再試行し、その後失敗を報告してください

learning_log は以下の場合のみ:

  • ✅ スキルコードの真のバグ（誤ったデータ形式が返された）
  • ✅ 2 回以上の再試行後の永続的な API レート制限エラー
  • ✅ スキル定義に従って存在すべきツールの欠落
ETF ツールの選択
クエリプライマリツールセカンダリツール
BTC ETF の流入/流出cg_btc_etf_flows()詳細な履歴には cg_btc_etf_history()
ETH ETF の流入/流出cg_eth_etf_flows()—
SOL/XRP ETF フローcg_sol_etf_flows() / cg_xrp_etf_flows()—
HK ETF フローcg_hk_btc_etf_flows() / cg_hk_eth_etf_flows()—
ETF リスト / ティッカーcg_btc_etf_list() / cg_eth_etf_list()—
ETF プレミアム / ディスカウントcg_btc_etf_premium_discount()—

ETF 比較ワークフロー:

# BTC vs ETH ETF comparison
btc = cg_btc_etf_flows()
eth = cg_eth_etf_flows()
# Compare the latest day's net flows, summarize in 2-3 sentences

クイックルーティング (まずこちらを使用)

クエリの種類ツール
清算サマリー (24時間、コイン別)cg_liquidation_coin_list
個別の清算注文cg_liquidation_orders
コインの清算履歴cg_coin_liquidation_history
資金調達率funding_rate
ロング/ショート比率 (グローバル)cg_global_account_ratio
建玉cg_open_interest
Hyperliquid 上のクジラの動きcg_hyperliquid_whale_alerts
ETF フロー (BTC)cg_btc_etf_flows

Coinglass をいつ使用するか

Coinglass を次の用途に使用します:

  • デリバティブのポジション - レバレッジ取引のトレーダーは何をしているか?
  • クジラの追跡 - Hyperliquid DEX 上の大きなポジションを追跡
  • 資金調達率 - 無期限先物を保有するコスト
  • 建玉 - 未決済ポジションの想定元本の合計
  • ロング/ショート比率 - レバレッジ取引のトレーダーのセンチメント (グローバル、トップアカウント、トップポジション)
  • 清算 - 強制決済とヒートマップおよび個別注文
  • 出来高分析 - テイカー出来高、CVD、ネットフローパターン
  • ETF フロー - 機関投資家の採用 (Bitcoin、Ethereum、Solana、XRP、香港)
  • クジラの送金 - 大規模なオンチェーンの動き (>$10M)
  • 先物市場データ - 対応コイン、取引所、ペア、OHLC 価格履歴

ツールカテゴリ

1. 基本的なデリバティブ分析 (7 ツール)

市場分析のためのコアなデリバティブデータ:

  • funding_rate(symbol, exchange?) - 現在の資金調達率
  • long_short_ratio(symbol, exchange?, interval?) - 基本的なロング/ショート比率
  • cg_open_interest(symbol) - 取引所全体の現在の建玉
  • cg_liquidations(symbol, time?) - 最近の清算
  • cg_liquidation_analysis(symbol) - ❌ Startup では利用不可 (ヒートマップエンドポイントに依存)
  • cg_supported_coins() - 対応しているすべてのコイン
  • cg_supported_exchanges() - ペアのあるすべての取引所
2. 高度なロング/ショート比率 (6 ツール)

複数の指標による詳細なポジション分析:

  • cg_global_account_ratio(symbol, interval?) - グローバルなアカウントベースのロング/ショート比率
  • cg_top_account_ratio(symbol, exchange, interval?) - トップトレーダーのアカウント比率
  • cg_top_position_ratio(symbol, exchange, interval?) - サイズ別のトップポジション
  • cg_taker_exchanges(symbol) - 取引所別のテイカーの買い/売り
  • cg_net_position(symbol, exchange) - ネットのロング/ショートポジション
  • cg_net_position_v2(symbol) - 拡張されたネットポジションデータ

ユースケース:

  • スマートマネーの追跡 (トップアカウント対個人投資家)
  • 取引所固有のセンチメント
  • ポジションサイズの分布分析
3. 高度な清算 (4 ツール)

カスケード予測のための詳細な清算追跡:

  • cg_coin_liquidation_history(symbol, interval?, limit?, start_time?, end_time?) - すべての取引所にわたる集計
  • cg_pair_liquidation_history(symbol, exchange, interval?, limit?, start_time?, end_time?) - 取引所固有のペア
  • cg_liquidation_coin_list(exchange) - 取引所上のすべてのコイン
  • cg_liquidation_orders(symbol, exchange, min_liquidation_amount, start_time?, end_time?) - 個別注文 (過去 7 日間、最大 200)

ユースケース:

  • 清算クラスターの特定
  • 時間の経過に伴う清算パターンの追跡
  • 大規模な清算イベントの発見
4. Hyperliquid クジラトラッキング (4 ツール)

Hyperliquid DEX 上の大口トレーダーを追跡します (直近約 200 件のアラート):

  • cg_hyperliquid_whale_alerts() - 直近の大口ポジションのオープン/クローズ (>$1M)
  • cg_hyperliquid_whale_positions() - PnL を含む現在のクジラポジション
  • cg_hyperliquid_positions_by_coin() - コイン別にグループ化されたすべてのポジション
  • cg_hyperliquid_position_distribution() - センチメントを含むサイズ別の分布

ユースケース:

  • Hyperliquid 上のスマートマネーを追跡する
  • 大口ポジションの変化を検出する
  • クジラの PnL とセンチメントを追跡する
5. 先物市場データ (5 ツール)

市場概況と価格データ:

  • cg_coins_market_data() - ❌ Startup では利用不可。マルチコインのデータについては「フルマーケット / マルチコイン OI ルーティング」を参照
  • cg_pair_market_data(symbol, exchange) - 特定ペアの指標
  • cg_ohlc_history(symbol, exchange, interval, limit?) - OHLC ローソク足
  • cg_taker_volume_history(symbol, exchange, interval, limit?, start_time?, end_time?) - ペア固有のテイカーボリューム
  • cg_aggregated_taker_volume(symbol, interval, limit?, start_time?, end_time?) - 取引所間で集計された値

ユースケース:

  • マーケットスクリーニング (すべてのコインを一度にスキャン)
  • プライスアクション分析
  • ボリュームパターンの認識
6. ボリューム & フロー分析 (4 ツール)

オーダーフローと資金移動の追跡:

  • cg_cumulative_volume_delta(symbol, exchange, interval, limit?, start_time?, end_time?) - CVD = (買い - 売り) の累計
  • cg_coin_netflow() - コインに流入/流出する資金
  • cg_whale_transfers() - 大規模なオンチェーン送金 (>$10M、過去 6 か月)

ユースケース:

  • オーダーフローのダイバージェンス検出
  • スマートマネーの追跡
  • 機関投資家の動きの監視
7. ビットコイン ETF データ (5 ツール)

機関投資家によるビットコイン採用の追跡:

  • cg_btc_etf_flows() - 日次の純流入/流出
  • cg_btc_etf_premium_discount() - ETF 価格 vs NAV
  • cg_btc_etf_history() - 包括的な履歴 (価格、NAV、プレミアム%、シェア、資産)
  • cg_btc_etf_list() - ビットコイン ETF の一覧
  • cg_hk_btc_etf_flows() - 香港ビットコイン ETF のフロー

ユースケース:

  • 機関投資家の需要の追跡
  • プレミアム/ディスカウントのアービトラージ
  • 地域別フローの比較 (米国 vs 香港)
8. その他の ETF データ (8 ツール)

イーサリアム、Solana、XRP、香港の ETF:

  • cg_eth_etf_flows() - イーサリアム ETF のフロー
  • cg_eth_etf_list() - イーサリアム ETF の一覧
  • cg_eth_etf_premium_discount() - ETH ETF のプレミアム/ディスカウント
  • cg_sol_etf_flows() - Solana ETF のフロー
  • cg_sol_etf_list() - Solana ETF の一覧
  • cg_xrp_etf_flows() - XRP ETF のフロー
  • cg_xrp_etf_list() - XRP ETF の一覧
  • cg_hk_eth_etf_flows() - 香港イーサリアム ETF のフロー

ユースケース:

  • マルチアセットの機関投資家追跡
  • 比較フロー分析
  • 地域別の選好分析

一般的なワークフロー

クイックマーケットスキャン
# Get everything in 3 calls
btc_oi = cg_open_interest("BTC")  # coins-markets is plan-gated on Startup
btc_liquidations = cg_liquidations("BTC")
whale_alerts = cg_hyperliquid_whale_alerts()
ディープポジション分析
# BTC positioning across metrics
cg_global_account_ratio("BTC")  # Retail sentiment
cg_top_account_ratio("BTC", "Binance")  # Smart money
cg_net_position_v2("BTC")  # Net positioning
# Note: liquidation heatmap is unavailable on Startup; see "Plan Tiers" at the top
ETF フロー監視
# Institutional demand
btc_flows = cg_btc_etf_flows()
eth_flows = cg_eth_etf_flows()
sol_flows = cg_sol_etf_flows()
クジラトラッキング
# Follow the whales
hyperliquid_whales = cg_hyperliquid_whale_alerts()
whale_positions = cg_hyperliquid_whale_positions()
onchain_whales = cg_whale_transfers()  # >$10M on-chain
ボリューム分析
# Order flow
cvd = cg_cumulative_volume_delta("BTC", "Binance", "1h", 100)
netflow = cg_coin_netflow()  # All coins
taker_vol = cg_aggregated_taker_volume("BTC", "1h", 100)

解釈ガイド

資金調達率
レート (8h)解釈
> +0.05%極端な強欲 — ロングの過密、スクイーズリスク
+0.01% ～ +0.05%強気バイアス、正常
-0.005% ～ +0.01%中立
-0.05% ～ -0.005%弱気バイアス、正常
< -0.05%極端な恐怖 — ショートの過密、反発リスク

極端な資金調達率はしばしば反転に先行します。極端な水準では、群衆はたいてい間違っています。

未決済建玉 + 価格マトリックス
OI価格解釈
上昇上昇新規ロングの参入 — 強気の確信
上昇下落新規ショートの参入 — 弱気の確信
下落上昇ショートカバー — 弱い上昇、確信が薄い
下落下落ロングの清算 — 弱い売り、投げ売り
ロング/ショート比率
比率解釈
> 1.5ロングの過密 — 逆張りの弱気
1.1～1.5やや強気
0.9～1.1均衡
0.7～0.9やや弱気
< 0.7ショートの過密 — 逆張りの強気
CVD（累積出来高デルタ）
パターン読み方
CVD 上昇、価格上昇強い買い圧力、健全な上昇トレンド
CVD 下落、価格上昇弱い上昇、分配
CVD 上昇、価格下落買い集め、底打ちの可能性
CVD 下落、価格下落強い売り圧力、健全な下降トレンド
ETF フロー
フロー読み方
大規模な流入機関投資家の買い、強気
継続的な流入持続的な需要
大規模な流出機関投資家の売り、弱気
NAV に対するプレミアム高い需要、強気センチメント
NAV に対するディスカウント弱い需要、弱気センチメント

分析パターン

マルチ指標による確認: 信頼度の高いシグナルのために、カテゴリをまたいでツールを組み合わせます：

  • 資金調達率 + L/S レシオ + 清算 = ポジションの極端な偏り
  • CVD + テイカーボリューム + クジラアラート = スマートマネーの方向性
  • ETF フロー + クジラの送金 + 建玉 = 機関投資家のコンビクション

スマートマネー対個人投資家: 指標を比較してダイバージェンスを特定します：

  • cg_top_account_ratio（スマートマネー）対 cg_global_account_ratio（個人投資家）
  • Hyperliquid のクジラポジション対全体のロング/ショートレシオ

カスケード予測: 清算ツールを使ってボラティリティを予測します：

  • cg_coin_liquidation_history は時間経過に伴う清算パターンを示します
  • cg_liquidation_orders は最近の強制決済を明らかにします
  • 大規模な清算イベント = カスケードリスクゾーン

フローのダイバージェンス: 資本の動きを追跡します：

  • cg_coin_netflow は資金がどこへ流れているかを示します
  • cg_whale_transfers は大規模な動きを明らかにします
  • ETF フローは機関投資家の需要を示します

パフォーマンス最適化

バッチ呼び出し対個別呼び出し

✅ 最適: バッチエンドポイントを使用する

# Whole-market current OI: coingecko cg_derivatives (coins-markets is plan-gated)

# One call gets all whale alerts
whales = cg_hyperliquid_whale_alerts()

# One call gets all ETF flows
btc_etf = cg_btc_etf_flows()

❌ 非効率: 複数の個別呼び出し

# Don't do this - wastes API quota
btc = cg_pair_market_data("BTC", "Binance")
eth = cg_pair_market_data("ETH", "Binance")
sol = cg_pair_market_data("SOL", "Binance")
クエリパラメータ

ほとんどの履歴エンドポイントが対応しています：

  • interval: 時間の粒度（1h、4h、12h、24h など）
  • limit: レコード数（デフォルトは異なります、最大 1000）
  • start_time: Unix タイムスタンプ（ミリ秒）
  • end_time: Unix タイムスタンプ（ミリ秒）

例：

cg_coin_liquidation_history(
    symbol="BTC",
    interval="1h",
    limit=100,
    start_time=1704067200000,  # 2024-01-01
    end_time=1704153600000     # 2024-01-02
)

対応取引所

先物データを提供する主要取引所：

  • ティア 1: Binance、OKX、Bybit、Gate、KuCoin、MEXC
  • 従来型: CME（ビットコインおよびイーサリアム先物）、Coinbase
  • DEX: Hyperliquid、dYdX、ApeX
  • その他: Bitfinex、Kraken、HTX、BingX、Crypto.com、CoinEx、Bitget

完全なリストとペアの詳細については cg_supported_exchanges() を使用してください。

重要な注意事項

  • API キー: COINGLASS_API_KEY 環境変数が必要です
  • シンボル: 標準的なシンボル（BTC、ETH、SOL など）を使用してください - cg_supported_coins() で確認できます
  • 取引所: ペアを含む完全なリストについては cg_supported_exchanges() を確認してください
  • 更新頻度:
    • マーケットデータ: ≤ 1 分
    • 資金調達率: 8 時間ごと（一部の取引所では 1 時間ごと）
    • OHLC: インターバルに応じてリアルタイムから 1 分
    • ETF データ: 毎日（市場終了後）
    • クジラの送金: リアルタイム（数分以内）
  • API バージョン:
    • V4 エンドポイントは CG-API-KEY ヘッダーを使用します（ほとんどのツール）
    • V2 エンドポイントは coinglassSecret ヘッダーを使用します（一部のレガシーツール）
    • どちらも同じ COINGLASS_API_KEY 環境変数で動作します
  • レート制限: Startup プラン — バッチポーリングは控えめにし、タイトなループを避けてください
  • 履歴データの制限:
    • 清算注文: 過去 7 日間、最大 200 レコード
    • クジラの送金: 過去 6 か月、最低 $10M
    • Hyperliquid アラート: 最新の大規模ポジション約 200 件
    • その他のエンドポイント: 通常、数か月から数年の履歴
  • プラン制限（Startup）: heatmap、liquidation/order、coins-markets、 Hyperliquid position は 401 Upgrade plan を返します（CoinglassPlanError を発生させます）。 ユーザーがこのデータを必要とする場合 → ユーザー自身のキーを提供してもらう（COINGLASS_DIRECT=1 + 自身の COINGLASS_API_KEY、直接呼び出し）、または Apify スキルで coinglass.com のページをスクレイピングします。

データ品質に関する注意事項

  • Hyperliquid: データは取引所固有のもので、他の DEX は含まれません
  • クジラの送金: Bitcoin、Ethereum、Tron、Ripple、Dogecoin、Litecoin、Polygon、Algorand、Bitcoin Cash、Solana をカバーします
  • ETF データ: 米国 ETF は市場終了後（東部時間午後 4 時）に更新され、香港 ETF は香港市場の終了後に更新されます
  • 清算注文: 直近 200 件に限定されます。より広い範囲を確認するにはヒートマップを使用してください
  • CVD: 累積指標です。リセットは自動ではないため、絶対値ではなく変化を追跡してください

バージョン履歴

  • v3.1.0 (2026-09): スタータープランの対応
    • プラットフォームキーをスタートアップにダウングレードし、エンドポイント権限の全体マップを文書化
    • 401「Upgrade plan」時に BYOK / Apify のガイダンスを含む CoinglassPlanError を追加
    • ユーザー提供キー用の COINGLASS_DIRECT=1 ダイレクトモードを追加（sc-proxy がユーザーキーを上書きします）
    • 4 件のパラメータバグを修正: coin/pair 清算履歴（exchange_list / pair シンボル）、 集計テイカーボリューム（exchange_list）、価格履歴（pair シンボル）
  • v3.0.0 (2025-03): 36 個の新しいツールを追加
    • 高度な清算（5 ツール）
    • Hyperliquid クジラ追跡（5 ツール）
    • ボリュームとフローの分析（5 ツール）
    • クジラの送金（1 ツール）
    • Bitcoin ETF（6 ツール）
    • その他の ETF（8 ツール）
    • 高度な L/S 比率（6 ツール）
  • v2.2.0 (2024): 先物市場データを含む V4 API への移行
  • v1.0.0 (2024): 基本的なデリバティブデータを含む初回リリース

コメント

Markdown 対応