Unusual Whales API

Unusual Whales APIをクエリして、機関投資家向けの市場データを取得できます。異常なオプションフロー、ダークプールプリント、マーケットタイドセンチメント、ガンマエクスポージャー、議会取引、株式グリークスが対象です。

使用するタイミング

以下のような金融データについてユーザーが尋ねた場合に、このスキルを使用してください。

• 異常なオプション活動、「クジラ」取引、フロー警告、または「最もホットなチェーン」
• ダークプールプリント、取引、またはレベル
• 市場センチメント（マーケットタイド、ネットプレミアム、プット/コール比率）
• インサイダー取引、政治家の取引、または特定の株式/オプションの詳細（グリークス、IV）
• ガンマエクスポージャー（GEX）分析
• AI駆動の取引システムまたは市場分析ツールの構築

前提条件

• Unusual Whales APIキー（https://unusualwhales.com/api_lander で取得可能）
• 環境変数 UNUSUAL_WHALES_API_TOKEN を設定
• 価格は週$50または月$150から

手順

重要なルール（ハルシネーション防止プロトコル）

ベースURL: 常に https://api.unusualwhales.com を使用します

認証: すべてのリクエストにはこのヘッダーを含める必要があります：

Authorization: Bearer <API_TOKEN>

メソッド: すべてのエンドポイントはGETリクエストです。POST、PUT、DELETEは使用しないでください。

厳格なホワイトリスト: 以下の「有効なエンドポイント リファレンス」セクションに記載されているエンドポイントのみ使用できます。そのリストにないURLは存在しません。

ハルシネーション ブラックリスト（これらは使用しないでください）

これらのエンドポイントは偽物ですが、AIモデルによってよくハルシネーションされます：

• ❌ /api/options/flow — 代わりに /api/option-trades/flow-alerts を使用
• ❌ /api/flow または /api/flow/live
• ❌ /api/stock/{ticker}/flow — 代わりに /api/stock/{ticker}/flow-recent を使用
• ❌ /api/stock/{ticker}/options — 代わりに /api/stock/{ticker}/option-contracts を使用
• ❌ /api/unusual-activity
• ❌ /api/v1/ または /api/v2/ を含むURL
• ❌ クエリパラメータ apiKey= または api_key= — 認可ヘッダーのみを使用

コンセプト マッピング

ユーザーの意図を正しいエンドポイントに変換します：

• 「ライブフロー」/ 「クジラ取引」/ 「オプションフロー」 → /api/option-trades/flow-alerts
• 「オプションフィルタ」/ 「オプションスクリーナー」/ 「フローフィルタ」 → /api/screener/option-contracts
• 「市場センチメント」 → /api/market/market-tide
• 「ダークプール」 → /api/darkpool/recent または /api/darkpool/{ticker}
• 「コントラクト グリークス」 → /api/stock/{ticker}/greeks
• 「スポット ガンマ」/ 「スポット GEX」/ 「GEX」/ 「ガンマエクスポージャー」 → /api/stock/{ticker}/spot-exposures/strike

有効なエンドポイント リファレンス

コアデータとフロー

• フロー警告（異常活動）: /api/option-trades/flow-alerts
  • パラメータ: limit, is_call, is_put, is_otm, min_premium, ticker_symbol, size_greater_oi
• オプションスクリーナー（最もホットなチェーン）: /api/screener/option-contracts
  • パラメータ: limit, min_premium, type, is_otm, issue_types[], min_volume_oi_ratio
• 最近のティッカーフロー: /api/stock/{ticker}/flow-recent
• ダークプール（ティッカー別）: /api/darkpool/{ticker}
• ダークプール（マーケット全体）: /api/darkpool/recent
• マーケットタイド: /api/market/market-tide
• ネットプレミアム ティック: /api/stock/{ticker}/net-prem-ticks

オプション、グリークス、IV

• オプションコントラクト リスト: /api/stock/{ticker}/option-contracts
• 各ストライク・満期のグリークス: /api/stock/{ticker}/greeks
• スタティック ガンマエクスポージャー（GEX）ストライク別: /api/stock/{ticker}/greek-exposure/strike
• スポット ガンマエクスポージャー（GEX）ストライク別: /api/stock/{ticker}/spot-exposures/strike
• 補間されたIVとパーセンタイル: /api/stock/{ticker}/interpolated-iv
• オプション出来高/PC比率: /api/stock/{ticker}/options-volume

その他のデータ

• インサイダー取引: /api/insider/transactions
• 政治家の取引: /api/congress/recent-trades
• ニュース: /api/news/headlines

例

例1：スマートマネーの掃引を検出

ユーザープロンプト： 「TSLAの最新の異常なオプション取引を表示してください。」

# unusual_whales_flow.py — ティッカーの異常なオプションフロー警告を取得
import httpx

url = "https://api.unusualwhales.com/api/option-trades/flow-alerts"
headers = {"Authorization": "Bearer YOUR_TOKEN"}
params = {
    "ticker_symbol": "TSLA",
    "min_premium": 50_000,       # 最小$50Kプレミアム
    "size_greater_oi": True,     # サイズ > オープンインタレストのオープニング取引
    "limit": 10,
    "is_otm": True               # アウト・オブ・ザ・マネーのみ
}
response = httpx.get(url, headers=headers, params=params)
trades = response.json().get("data", [])

for trade in trades:
    print(f"{trade['ticker']} | {trade['type']} | ${trade['total_premium']:,.0f}")

例2：異常に強気のアクティビティをスクリーン

ユーザープロンプト： 「今日の異常に強気なオプション活動を表示してください。」

# unusual_whales_screener.py — 強気のオプション活動をスクリーン
import httpx

url = "https://api.unusualwhales.com/api/screener/option-contracts"
headers = {"Authorization": "Bearer YOUR_TOKEN"}
params = {
    "limit": 150,
    "is_otm": True,
    "issue_types[]": ["Common Stock", "ADR"],
    "max_dte": 183,                    # 満期まで最大6カ月
    "max_multileg_volume_ratio": 0.1,  # スプレッド取引を除外
    "min_ask_perc": 0.7,               # アグレッシブな買い手（アスク近くで買う）
    "min_volume": 500,
    "min_premium": 250_000,            # $250K+プレミアム
    "type": "Calls",                   # 強気 = コール
    "vol_greater_oi": True,            # 出来高がオープンインタレストを超過
}
response = httpx.get(url, headers=headers, params=params)
data = response.json().get("data", [])

for contract in data:
    print(f"{contract['ticker_symbol']} {contract['option_symbol']} | Vol: {contract.get('ask_side_volume')}")

例3：ダークプールアクティビティを監視

ユーザープロンプト： 「NVDAに大きなダークプールプリントはありますか？」

# unusual_whales_darkpool.py — ティッカーのダークプール取引を取得
import httpx

url = "https://api.unusualwhales.com/api/darkpool/NVDA"
headers = {"Authorization": "Bearer YOUR_TOKEN"}
response = httpx.get(url, headers=headers)
prints = response.json().get("data", [])

for p in prints:
    notional = float(p['price']) * int(p['size'])
    print(f"${notional:,.0f} | {p['size']} shares @ ${p['price']} | {p['executed_at']}")

例4：市場センチメントを確認

ユーザープロンプト： 「今の全体的な市場センチメントは？」

# unusual_whales_tide.py — マーケットタイドセンチメントデータを取得
import httpx

url = "https://api.unusualwhales.com/api/market/market-tide"
headers = {"Authorization": "Bearer YOUR_TOKEN"}
params = {"interval_5m": False}  # 1日ビュー
response = httpx.get(url, headers=headers, params=params)
data = response.json().get("data", [])

latest = data[-1] if data else {}
net_call = float(latest.get('net_call_premium', 0))
net_put = float(latest.get('net_put_premium', 0))
sentiment = "強気" if net_call > net_put else "弱気"
print(f"マーケットタイド: {sentiment} | コール: ${net_call:,.0f} | プット: ${net_put:,.0f}")

例5：ガンマエクスポージャー分析

ユーザープロンプト： 「RIVNのガンマエクスポージャーをストライク別に表示してください。」

# unusual_whales_gex.py — ストライク別スポットガンマエクスポージャーを取得
import httpx

url = "https://api.unusualwhales.com/api/stock/RIVN/spot-exposures/strike"
headers = {"Authorization": "Bearer YOUR_TOKEN"}
response = httpx.get(url, headers=headers)
data = response.json().get("data", [])

for level in sorted(data, key=lambda x: abs(float(x.get('call_gamma_oi', 0))), reverse=True)[:10]:
    print(f"ストライク ${level['strike']} | コールGEX: {level.get('call_gamma_oi')} | プットGEX: {level.get('put_gamma_oi')}")

例6：議会取引を追跡

ユーザープロンプト： 「最近の議会メンバーによる株式取引を表示してください。」

# unusual_whales_congress.py — 政治家の取引開示を取得
import httpx

url = "https://api.unusualwhales.com/api/congress/recent-trades"
headers = {"Authorization": "Bearer YOUR_TOKEN"}
response = httpx.get(url, headers=headers)
trades = response.json().get("data", [])

for trade in trades[:20]:
    print(f"{trade.get('politician')} | {trade.get('ticker')} | {trade.get('type')} | {trade.get('amount')}")

ガイドライン

• 常に認可ヘッダーを使用し、認証にはクエリパラメータを使用しないでください
• エンドポイントURLを生成する前にハルシネーション ブラックリストを確認してください
• size_greater_oi=True を使用してオープニングポジション（新規資金流入）をフィルタリング
• is_otm=True を使用してアウト・オブ・ザ・マネーのオプション（高レバレッジ的な賭け）をフィルタリング
• min_premium はドル建て — $50Kには50000、$500Kには500000を使用
• ダークプールデータは実行から約15分遅延
• interval_5m=False のマーケットタイドは1日分の集約ビューを提供
• 議会取引データは申告された開示を反映し、リアルタイム取引ではありません
• WebSocketストリーミング（ライブフィード）の場合、Advanced層サブスクリプションが必要
• レート制限が適用されます — X-RateLimit-Remaining のレスポンスヘッダーを確認してください