優位性を得たい暗号通貨トレーダーにとって、大口保有者（通称ホエール）のウォレットを監視することは、大きな価格変動前に早期のポジション変化を察知する手がかりになります。 Pythonでオンチェーン・ホエールシグナルを使った暗号通貨トレーディングボットを構築することで これらの高価値なデータポイントを自動的に捕捉し、反応することが可能です。このチュートリアルでは、Smart Money APIを使用した実践的な実装を解説します。Smart Money APIは、Hyperliquidのリーダーボードから集約されたホエール活動と複数取引所のデリバティブデータを専門に提供するソースです。
オンチェーン・ホエールシグナルの理解
ホエールウォレットとは、大量の暗号通貨を保有または取引するアドレスのことです。ホエールが取引所に資産を預け入れたり、大きなポジションを開いたり、分散型取引所から引き出したりする場合、それは意図を示すことが多く、市場はそれに追随する傾向があります。Smart Money APIは、Hyperliquidのマルチタイムフレームリーダーボードから約2,000のホエールウォレットを自動的に発見し、サポートされている取引所（Bybit、Binance、Hyperliquidのみ）でのイベントを追跡します。これらのイベントには、大口の流入、流出、ポジション変更が含まれます。
これらのシグナルをトレーディングボットに組み込むことで、指値注文の実行、ストップロスの調整、アラートの送信などの反応をプログラム化でき、感情的な遅れなく実行できます。
Smart Money APIの始め方
まず、 smartmoneyapi.com でサインアップしてAPIキーを取得してください。無料枠では1日100回の呼び出しが可能で、BTCデータに限定されます（テスト用に十分です）。全機能（全シンボル、ホエールイベント、デリバティブ、オンチェーンメトリクス）を利用するには、Trader枠（1日1,000回）またはPro枠（1日5,000回）が推奨されます。
すべてのリクエストは X-API-Key ヘッダーで認証されます。ベースエンドポイントは https://api.smartmoneyapi.comです。以下は接続をテストする最小限のPythonスクリプトです：
import requests
API_KEY = "your_api_key_here"
BASE_URL = "https://api.smartmoneyapi.com"
headers = {"X-API-Key": API_KEY}
# Check health
resp = requests.get(f"{BASE_URL}/v1/health", headers=headers)
print(resp.json())ホエールウォレットデータの取得
最も直接的なホエールシグナルは /v1/whales/summaryで利用可能で、追跡対象ウォレットの総純流入やアクティブウォレット数などの集計メトリクスを返します。個別のイベント（預け入れ、引き出し、ポジション開設）については、 /v1/whales/events.
例: 最新の5つのホエールイベントを取得する:
endpoint = f"{BASE_URL}/v1/whales/events"
params = {"limit": 5}
resp = requests.get(endpoint, headers=headers, params=params)
events = resp.json()
for event in events:
print(f"Symbol: {event['symbol']}, Type: {event['event_type']}, "
f"Amount: {event['amount_usd']}, Wallet: {event['wallet_address'][:8]}...")イベントには以下のようなフィールドが含まれます event_type （例: 「入金」、「出金」、「ロングポジション開始」） symbol, amount_usd、およびタイムスタンプ。ボットは特定のシンボルや閾値でフィルタリングできます — 例えば、ホエールが取引所に50万ドル以上を入金した場合にのみ動作するように設定できます。
ホエールデータをトレード戦略に統合する
シンプルな戦略として「ホエールモメンタム」シグナルを使用できます: 短期間に同じシンボルに対して複数のホエールが取引所に入金している場合、それは売り圧力が迫っていることを示唆する可能性があります。逆に、自己保管への大規模な出金は、しばしば蓄積を示します。
スコアリングメカニズムを構築できます:
- 過去1時間のシンボルごとの正味USDフローを追跡します。
- 正味フローが閾値（絶対値）を超えた場合、シグナルを生成します。
- 確認のためにデリバティブデータ（次のセクション）と組み合わせます。
重要： これはデータ駆動型の手法であり、保証はありません。十分にバックテストを行い、単一のシグナルに依存しないでください。
確認のためのデリバティブデータの追加
Smart Money APIは、Bybit、Binance、Hyperliquidのクロスエクスチェンジデリバティブデータのみを提供します（OKXは含まれません）。 /v1/derivatives/screener エンドポイントを使用して、約229の自動検出されたシンボルのオープンインタレスト、資金調達率、ロング/ショート比率などのメトリクスを取得します。
例：BTC-USDTパーペチュアルの現在の資金調達率とオープンインタレストを取得する：
screener = f"{BASE_URL}/v1/derivatives/screener"
params = {"symbol": "BTC/USDT:USDT", "exchange": "binance"}
resp = requests.get(screener, headers=headers, params=params)
data = resp.json()
print(f"OI: {data['open_interest']}, Funding Rate: {data['funding_rate']}")クジラの預金イベントをオープンインタレストの上昇と負の資金調達率（ショート優位を示す）と組み合わせることで、より堅牢なトレードアイデアを生成できます。
トークンリスクのためのノードインテリジェンス（BSC & Avalanche）
ボットがBinance Smart Chain（PancakeSwap）またはAvalanche C-chain（Trader Joe）で取引する場合、Smart Money APIのノードインテリジェンス製品を活用できます。これは独自のフルノード（または再販可能なRPC）で実行され、以下を提供します：
- 新しいペアの検出
- 大規模なスワップの監視
- ハニーポット検出 (
/v1/node/{bsc|avax}/honeypot/{token}) - トークンリスクスコアリング (
/v1/node/{bsc|avax}/token-risk/{token}) - ウォレット追跡
例えば、新しく発見されたトークンを購入する前に、ハニーポットエンドポイントを呼び出して、コントラクトに売却制限があるかどうかを確認します。レスポンスには以下のようなフラグが含まれます is_honeypot および risk_score (0‑100).
token = "0x123...abc"
resp = requests.get(f"{BASE_URL}/v1/node/bsc/honeypot/{token}", headers=headers)
honeypot_check = resp.json()
if honeypot_check.get("is_honeypot"):
print("Token is a honeypot — skipping.")Smart Money APIは、このサービスのためにNodeプラン（Starter、Pro、API per chain）を提供しています。
ボットループの構築
コンポーネントを連続ループに組み立てます。 time.sleep() またはスケジューラー（例： schedule ライブラリ）を使用してAPIレート制限を遵守します。典型的な間隔は、クジライベントに対して5〜15分、デリバティブデータに対して1分です（あなたのティアが許可する場合）。
疑似コード構造：
while True:
whales = get_whale_events(min_amount_usd=500_000)
for event in whales:
if is_bullish_signal(event):
oi, funding = get_derivatives(event['symbol'])
if oi > threshold and funding < -0.01:
execute_trade(event['symbol'], side="short")
time.sleep(300) # 5 minutesライブ取引の前に、エラーハンドリング、ロギング、およびドライランモードを実装することを忘れないでください。
よくある質問
暗号取引ボットを構築するための最適なPythonライブラリは何ですか？
Smart Money APIのようなプレミアムAPIの場合、 requests で十分です。取引所接続の場合、 ccxt が多くの取引所をサポートする標準ライブラリです。バックテストの場合、 backtrader または vectorbt が人気です。
Smart Money APIはいくつのクジラウォレットを追跡していますか？
Hyperliquidのマルチタイムフレームリーダーボードから自動発見された約2,000のウォレットを、Bybit、Binance、およびHyperliquid取引所のみで追跡しています。
このボットをBSCまたはAvalancheのトークンに使用できますか？
はい、Node Intelligence製品を通じて使用できます。それぞれのチェーンのフルノード（または再販可能なRPC）が必要です。APIはBSCおよびAvalancheの新しいペア検出、大規模なスワップ、ハニーポットチェック、およびウォレット追跡を提供します。
開始するために実際のビットコインデータが必要ですか？
いいえ。無料ティアではビットコインのみで1日100回の呼び出しが可能ですが、ホワイトリストされたシンボルのエンドポイントをテストすることはできます。他のシンボルの場合は、TraderまたはProにアップグレードしてください。
前向きな結論
Smart Money APIのような専門のアグリゲーターのおかげで、Pythonでオンチェーンクジラシグナルを使用した暗号取引ボットの構築がますますアクセスしやすくなっています。ウォレットイベント、デリバティブセンチメント、およびオンチェーンリスクチェックを組み合わせることで、多面的な意思決定エンジンを作成できます。これは、遅れた価格行動への依存を減らします。DeFiエコシステムが拡大するにつれて、大規模なホルダーの行動にプログラム的に反応する能力は、システマティックトレーダーにとって貴重なツールであり続けるでしょう。常にペーパートレーディングと反復的なバックテストから始めて、資本を投入してください。