データソース¶

接続状況サマリー¶

データソース	用途	接続方式	状態
IBKR TWS	注文執行	Port 4002	✅ 接続OK
Unusual Whales	オプションフロー	REST API	✅ 接続OK
ThetaData	オプション/GEX	Port 25503	✅ 接続OK
Polygon	株価/出来高	REST API	✅ 接続OK
Barchart	IV Rank	Scraping	✅ 設定済

IBKR TWS/Gateway¶

概要¶

Interactive Brokersの取引APIを通じて注文を執行。

接続設定¶

項目	Paper	Live
Port	4002	7496
Client ID	1	1
Read-only	No	No

使用API¶

ib_insync ライブラリ
非同期接続
自動再接続機能

ヘルスチェック¶

# ダッシュボードでのチェック方法
1. lsof でポートLISTEN確認
2. ib_insync.reqCurrentTime() でAPI応答確認

Unusual Whales¶

概要¶

オプションフローデータを提供。Sweep/Block取引を検出。

API情報¶

項目	値
Base URL	`https://api.unusualwhales.com`
認証	Bearer Token
レート制限	120 req/min, 15k req/day

使用エンドポイント¶

エンドポイント	用途
`/api/option-flow/live`	リアルタイムフロー
`/api/option-flow/alerts`	アラート取得

レート制限対策¶

# 市場時間帯による頻度調整
if is_market_open():
    interval = 30  # 30秒間隔
elif is_pre_market():
    interval = 60  # 1分間隔
else:
    interval = 300  # 5分間隔

ThetaData¶

概要¶

オプション価格、Greeks、GEX計算用データを提供。

接続情報¶

項目	値
Port	25503
API Version	v3
Java要件	JDK 21

使用エンドポイント¶

エンドポイント	用途
`/v3/option/list/symbols`	銘柄一覧
`/v3/option/list/expirations`	満期日一覧
`/v3/option/history/eod`	ヒストリカルデータ
`/v3/option/quote`	リアルタイムクォート

起動方法¶

cd /Applications/ThetaData
/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home/bin/java \
    -jar ThetaTerminalv3.jar

Polygon¶

概要¶

株価、出来高、1分足データを提供。

プラン¶

Stocks Developer ($199/month)

リアルタイム株価
5年間のヒストリカルデータ
1分足データ

使用エンドポイント¶

エンドポイント	用途
`/v2/aggs/ticker/{symbol}/range/1/minute`	1分足
`/v2/snapshot/locale/us/markets/stocks/tickers/{symbol}`	スナップショット
`/v1/marketstatus/now`	市場ステータス

早期終了対応¶

# 早期終了日の検出
response = requests.get(
    f"{base_url}/v1/marketstatus/now",
    params={"apiKey": api_key}
)
if response.json().get("earlyHours"):
    # 早期終了モード
    pass

Barchart¶

概要¶

IV Rankデータをスクレイピングで取得。

取得頻度¶

JST 09:00（プレマーケット前）
JST 21:00（場中）

取得方法¶

# Barchart Scraper
cd barchart-scraper
python src/downloader.py

出力形式¶

symbol,iv_rank,iv_percentile,current_iv,iv_high_52w,iv_low_52w
AAPL,45.2,52.1,0.32,0.65,0.18
NVDA,62.5,68.3,0.48,0.92,0.25

データ鮮度管理¶

フォールバック理由¶

理由コード	説明	対応
`holiday`	休場日	前日データ使用
`weekend`	週末	金曜データ使用
`after_hours`	時間外	終値使用
`pre_market`	プレマーケット	前日終値使用
`early_close`	早期終了	終了時データ使用
`api_error`	API障害	キャッシュ使用

ログ出力¶

INFO | 📊 [NVDA] データ取得完了
WARNING | ⚠️ [AAPL] フォールバックデータ使用中: オプション=2025-11-28 (理由: holiday)