Binance API Key 安全管理ガイド|権限分級・IP ホワイトリスト・漏洩時の緊急対応
Binance API Key は自動売買と資産運用の中核権限を担います。本記事では読み取り専用、取引、出金の三段階権限、IP ホワイトリストの紐付け、鍵漏洩時の緊急処置とベストプラクティスを解説します。
Binance API Key はクオンツ取引、クロスプラットフォーム帳票、サードパーティ戦略ツールへの入口であり、漏洩すれば口座そのものを外部プログラムに丸ごと渡すのに等しい重みを持ちます。本記事では、権限分級から IP ホワイトリスト、鍵ローテーション、漏洩時の緊急対応まで、そのまま流用できる API セキュリティ運用手順を整理し、開発者やクオンツユーザーが自動化の利便性を享受しつつも同等の資産リスクを背負わなくて済むようにします。
API Key の基本構成
Binance の API Key は 3 要素で構成されます。すなわち Key(公開クレデンシャル)、Secret(署名鍵)、そして任意の IP ホワイトリストです。全リクエストは HMAC-SHA256 署名で検証され、Secret は生成時に一度だけ表示され、その後は再取得できません。つまり Secret が漏洩した場合、対処は「削除して再作成する」以外にありません。
権限分級:読み取り専用、取引、出金
Binance の API 権限は次の 3 階層に分かれています。
| 権限レベル | 実行可能な操作 | リスクレベル |
|---|---|---|
| 読み取り専用(Read Only) | 残高、注文履歴、約定明細の照会 | 低 |
| 現物・信用取引 | 発注、キャンセル、先物証拠金の振替 | 中 |
| 先物取引 | 建玉、レバレッジ調整、成行ストップ | 中高 |
| 出金(Withdraw) | ホワイトリストアドレスへの能動的な出金 | 極高 |
| ユニバーサル振替(Universal Transfer) | 口座間の高速振替 | 中 |
権限付与の最小原則
- 帳票ツールは「読み取り専用」だけをチェックし、書き込み系権限は絶対に付与しない。
- グリッドボットやアービトラージ戦略は「現物取引」が必要だが「出金」は不要。
- 資金集約スクリプトだけが「出金」を必要とし、IP ホワイトリスト必須。
- 先物戦略には別途 Key を作成し、現物用 Key と混在させない。
- ツールごとに Key を分ける。問題発生時の原因特定と失効処置が速くなる。
API Key 作成の全手順
手順 1:API 管理ページに入る
Binance アカウント にログインし、「アカウントセンター → API 管理」に進みます。初回作成時は 2FA 認証が強制的に要求されます。モバイルでは Binance公式アプリ を利用できますが、Key の生成はデスクトップブラウザで行うのが Secret を控えやすくおすすめです。
手順 2:命名とタイプ選択
命名は「用途-環境-日付」の形式を推奨します。例:「grid-prod-20260711」。タイプは「システム生成」と「自作 Ed25519」の 2 種類があります。本番環境では中間者による Secret 傍受のリスクを下げるため、自作 Ed25519 を優先してください。
手順 3:権限にチェックを入れる
最小原則に従ってチェックし、「全て許可」をデフォルトで選ばないこと。危険度の高い権限にはシステムが二次ポップアップで確認を求めます。
手順 4:IP ホワイトリストを紐付ける
「アクセス制限」欄にサーバーのグローバル IP を入力します。複数の場合はカンマで区切ります。注意点は次のとおり。
| IP ホワイトリスト状態 | Key 有効期間 | 許可される操作 |
|---|---|---|
| IP 未設定 | 90 日 | 現物取引、出金は不可 |
| IP 設定済み | 自動失効なし | 現物、先物、出金すべて可能 |
つまり、IP を設定しない Key は 90 日ごとに再確認が強制され、出金権限を持たせるには IP ホワイトリストが必須です。
手順 5:Secret を保存する
生成完了後、Secret はページ上に一度だけ表示されます。パスワードマネージャ(1Password、Bitwarden、KeePassXC)またはクラウド KMS(AWS KMS、GCP KMS)で暗号化してすぐに保存してください。⚠️ WeChat やメールで平文送信するのは絶対に避けてください。
IP ホワイトリストの応用
固定 IP vs 動的 IP
家庭用ブロードバンドは通常動的 IP のため、API リクエストが周期的に拒否されます。解決策は 3 つ。
- ISP に固定 IP を申請する。コストは高いが恒久的な対策。
- クラウドサーバー(AWS EC2、Vultr、テンセントクラウドなど)に戦略スクリプトを配置し、サーバー IP をホワイトリストに登録する。
- NAT ゲートウェイで出口 IP を集約し、複数マシンで 1 つのホワイトリストエントリを共有する。
複数 IP の冗長化
主サーバー IP と予備サーバー IP の少なくとも 2 本を登録することを推奨します。主サーバーがダウンしても予備ノードが即座に引き継ぎ、単一障害点による発注失敗を回避できます。
VPN・プロキシ利用時の注意
VPN 経由で API にアクセスする場合、ホワイトリストには VPN の出口 IP を登録する必要があります。VPN ノードを頻繁に切り替えると IP が変動するため、コア戦略の運用には不向きです。
鍵ローテーションの仕組み
漏洩の兆候がなくても、Key の定期ローテーションを推奨します。
Q:どのくらいの頻度でローテーションすべきですか? A:読み取り専用 Key は 6 か月ごと、取引 Key は 3 か月ごと、出金 Key は毎月または大口出金のたびに直後にローテーション。
Q:シームレスに切り替えるには? A:先に新 Key を発行し、新スクリプトで 24 時間ドライランして戦略に異常がないことを確認したうえで旧 Key を削除します。旧 Key の削除後に新 Key が未有効化のまま発注失敗になる事態を避けます。
鍵漏洩時の緊急チェックリスト
Key の漏洩が疑われたら、以下の順に処置します。
- すぐに API 管理ページにログインして該当 Key を削除する。反映は秒単位。
- Key に出金権限があれば、出金ホワイトリストのアドレスもすべて削除する。
- デバイス管理から全セッションをサインアウトし、パスワードと 2FA を再設定する。
- 資金の動きを確認する。現物残高、先物ポジション、C2C 広告が改変されていないか。
- 直近 30 日の約定と出金履歴をエクスポートし、セキュリティチケットを提出する。
- 損失が大きい場合、所轄のサイバー犯罪部門に通報し、オンチェーンの証拠を保存する。
よくある漏洩源
- 公開 GitHub リポジトリ:Secret をコードに直書きし、GitHub の秘匿情報スキャナに捕捉される。
- Docker イメージ:レイヤーに環境変数が残留する。
- ログファイル:デバッグ時にリクエストヘッダをログに出力し、ログがクラウド同期される。
- コラボプラットフォーム:Notion、Lark、企業版 WeChat の文書に平文で保存する。
- 旧ハードディスク:旧 PC を売却する前にパスワードマネージャのデータベースを完全消去しなかった。
⚠️ リスクの注意:Binance は GitHub と主要な漏洩源を毎分スキャンしており、関連 Key を検出すると自動で無効化しメール通知します。ただし検出には時間差があるため、ユーザー側でも git-secrets、trufflehog、gitleaks などで自前のスキャンを構築することを推奨します。
署名リクエスト実装のポイント
タイムスタンプと recvWindow
Binance API はタイムスタンプを検証し、サーバーとローカルの時刻差は 5 秒以内である必要があります。本番スクリプトでは NTP 同期を必ず有効化してください。recvWindow の既定値は 5000 ミリ秒で、最大 60000 まで延長できますが、延長すると再送攻撃のウィンドウが広がります。
署名対象の完全性
署名はクエリパラメータと body の全パラメータを覆う必要があり、1 つでも欠けると検証に失敗します。よくある誤りは timestamp を署名対象から外してしまうこと。開発時は公式 SDK の利用を推奨します。
| 言語 | 公式 SDK | メンテ状況 |
|---|---|---|
| Python | binance-connector-python | アクティブ |
| Node.js | @binance/connector | アクティブ |
| Go | binance-connector-go | アクティブ |
| Java | binance-connector-java | アクティブ |
| Rust | コミュニティクレート中心 | 半アクティブ |
API 利用時のコンプライアンスと契約リスク
レート制限
現物 API は毎分 1200 ウェイト、口座系 API は毎分 6000 ウェイトで、超過すると IP レベルの禁止が発動します。本番スクリプトには指数バックオフとトークンバケット制限を組み込みましょう。
高頻度取引の特別申請
日次発注数が 100 万件を超える場合、VIP API チャネルを申請でき、より高いレート上限と専用 WebSocket を享受できます。申請には「高頻度取引契約」の締結が必要で、より厳格な禁止規則が適用されます。
先物と現物の API は独立
先物 API のベースは fapi.binance.com、現物 API のベースは api.binance.com で、Key は互換ではありません。現物 Key を先物 SDK にセットして署名エラーになる、といった事故に注意してください。
現物、先物、オプションの取引差分をより詳しく知りたい方は Binance プラットフォーム機能総覧 と アプリダウンロードガイド を参照してください。
よくあるご質問
Q:API Key で Web にログインできますか?
A:できません。API Key はプログラマティックなインターフェース専用で、Web と App のログインはメール、パスワード、2FA が必要です。
Q:Secret を紛失したら復旧できますか?
A:できません。Secret は生成時に一度だけ表示され、Binance はサーバー側に保存しません。紛失した場合は削除して再作成する以外に手段はありません。
Q:IP ホワイトリスト設定後に一時的に IP を変更できますか?
A:可能です。ただし変更のたびに 2FA +メール確認が必要で、変更後 5 分間は旧 IP からもアクセスできますが、その後は即座に失効します。
Q:戦略が時々署名エラーになるのはなぜですか?
A:多くの原因はローカル時刻のドリフトです。NTP を有効化し、ローカル時刻ではなくサーバー時刻(GET /api/v3/time の戻り値)を優先して利用してください。
Q:現物 Key で先物ポジションを直接照会できますか?
A:できません。現物と先物の Key は独立しており、ポジション照会には先物 Key が必要です。統合口座ビューが必要なら「Portfolio Margin API」を申請してください。
Q:Key は複数箇所にバックアップすべきですか?
A:Secret はパスワードマネージャのマスターデータベース+クラウドバックアップに保存すれば十分です。IM のチャット履歴やクラウドドライブの平文ファイルに置くのは避けてください。
Q:Key の異常利用をどう監視しますか?
A:Binance の API 管理ページには直近 30 日のリクエスト数、IP、エラーコードの統計が表示されます。Webhook を接続するか毎日ログを取得し、異常なコールに対してアラートを出す運用を推奨します。
Q:チームメンバーに個別 API Key を発行できますか?
A:可能です。法人アカウントはサブアカウントに対応しており、サブアカウント単位で独立した Key を生成できます。個人アカウントで Key を共有すると各メンバーの操作を監査できないため、共有はお勧めしません。
⚠️ 特記事項:本記事で述べる権限、レート、有効期間は 2026 年 7 月時点の公式ドキュメントに準拠します。Binance はコンプライアンスやシステム更新の都合で閾値を更新することがあります。本番デプロイ前に必ず最新の API ヘルプセンターで確認してください。
ドキュメント公開日:2026-07-01、次回見直し予定:2026-10-01