Binance API キー権限管理 完全ガイド|IP ホワイトリスト+HMAC 署名+鍵ローテーション
Binance API キーの読み取り専用 / 取引 / 出金の 3 段階権限、IP ホワイトリスト、HMAC-SHA256 署名、レート制限、漏洩時の緊急対応、四半期ローテーション戦略までを一気通貫で解説し、量的取引・アービトラージ用アカウントをゼロトラスト運用に近づけます。
一言で答えると、Binance API キーは「読み取り専用 / 現物・先物取引 / 出金」の 3 段階権限モデルを採用しており、すべての key で IP ホワイトリストを有効化し、四半期ごとにローテーションし、出金権限は真に必要なボットのみで有効化するのが推奨形です。「戦略作者」や「収益シェア」を騙って API secret の受け渡しを要求する提携話は例外なく詐欺で、Binance の公式チャネルがユーザーの API secret を求めることは一切ありません。
API キーは量的取引、アービトラージ、クロス取引所ヘッジの生命線ですが、同時に資金全損への高リスク入口でもあります。本記事では権限モデル、IP ホワイトリスト、HMAC 署名、レート制限、漏洩対応、ローテーション戦略の 6 領域に分けて掘り下げます。入口確認には Binance 公式サイト入口 を、アプリは ダウンロードページ から取得してください。設定後は Binance公式サイト で IP ホワイトリスト検証を一度実施し、あるいは Binance公式アプリ から API 利用ログを確認しておくと安心です。
API キー 3 段階権限モデル
Binance の API キーの権限チェックボックスは階層独立です。最小権限原則で必要最低限のみ付与しましょう。権限の組み合わせが、鍵が漏洩した際の最大損失を直接決めます。
| 権限階層 | 主要アクション | 漏洩時の最大損失 | 推奨用途 |
|---|---|---|---|
| 読み取り専用 | 残高 / K 線 / 注文履歴の照会 | 情報漏洩 | データ分析、可視化 |
| 現物取引 | 発注 / 取消 / ポジション照会 | 悪意ある対倒 | 量的戦略、アービトラージ |
| 先物取引 | 先物発注 / レバレッジ変更 | 高レバレッジ強制決済 | 先物量的取引 |
| 出金 | ホワイトリスト宛出金 | ホワイトリスト内額 | 使用は最小限 |
| 全出金アドレス許可 | 非ホワイトリスト宛も許可 | 全資産 | 強く非推奨 |
A:量的戦略に出金権限は不要が原則で、資金集約ボットのみが該当します。その場合も主アカウントのホワイトリストと厳格に紐付け、IP ホワイトリストが外れた瞬間に key を無効化してください。
key と secret の対称保護
API key は公開項目で、漏洩しても致命的ではありません。API secret は署名鍵であり、漏洩は口座の実質的な奪取を意味します。secret は作成時に一度きり表示され、後から管理画面で再確認することはできません。作成時に即座にパスワードマネージャや環境変数に保管し、ソースコード、Git リポジトリ、チャット履歴には決して残さないでください。
IP ホワイトリスト設定 4 ステップ
IP ホワイトリストは API 層で最も効果的なセーフティネットです。標準的な設定フロー:
- サーバーの出口 IP を特定:本番サーバーで
curl https://ifconfig.meまたはdig +short myip.opendns.com @resolver1.opendns.comを実行してグローバル出口 IP を取得します。IPv6 環境なら IPv6 プレフィックスも併せて記録。 - API キーに IP をバインド:Binance の API 管理画面 → 該当 key を編集 → 「アクセス IP を制限」にチェック → IP を貼り付け(複数はカンマ区切り、最大 30 個)→ 2FA 認証で保存。
- リクエスト検証:本番サーバーから簡単なリクエスト(GET /api/v3/account 等)を発行し、署名と IP がともに通過することを確認。他 IP から同一リクエストを送ると -2015 が返るはずです。
- 固定 IP の担保:サーバー IP が動的な場合(家庭用回線、一部 VPS)はエラスティック IP や NAT ゲートウェイを利用してください。IP が変わった瞬間に API 呼び出しが失敗します。
⚠️ 警告:「戦略を動かすには先に IP ホワイトリストを解除してください」と要求する第三者フレームワークは要警戒です。オープンソース戦略フレームワークにはホワイトリスト解除は不要ですし、商用の戦略プラットフォームでも対応するホワイトリスト運用ガイドが必ずあります。
主要クラウドの出口 IP 特性
AWS のエラスティック IP は既定で静的、割り当てたまま維持できます。Alibaba Cloud や Tencent Cloud も同様です。Cloudflare Workers や Vercel Edge は動的出口であり、Binance API との直接接続には不向きです。中間に静的 IP のプロキシ層を挟む構成を推奨します。
HMAC-SHA256 署名機構
Binance の現物、先物、オプション API は全て HMAC-SHA256 署名を採用しています。リクエストの署名は HMAC-SHA256(query_string, secret)、署名フィールド名は signature です。
- リクエストには必ず timestamp(ミリ秒タイムスタンプ)を含める。
- recvWindow は既定 5000 ミリ秒、最大 60000 ミリ秒。
- タイムスタンプがサーバー時刻から recvWindow を超えてずれると -1021 エラー。
- 署名は query string 末尾または body の最後尾フィールドに配置。
A:recvWindow は 5000 ミリ秒を推奨します。値を大きくするほど攻撃者の再送猶予が増えます。家庭回線で -1021 が頻発する場合、まずは NTP 同期を疑ってください。recvWindow を大きくするのは対症療法にすぎません。
署名例
Python の場合:signature = hmac.new(secret.encode(), query_string.encode(), hashlib.sha256).hexdigest()。secret のエンコード誤り、query_string のフィールド順序変更のいずれも署名失敗の原因になります。公式 SDK か実績のある第三者ライブラリを推奨し、自前で文字列を組み立てるのは避けましょう。
WebSocket プライベートチャンネル認証
現物の user data stream は先に REST で listenKey を取得し、その後 WebSocket に接続します。listenKey は 60 分の有効期限で、30 分ごとに keepalive が必要です。keepalive を忘れるとプライベートチャンネルが静かに切断され、初心者が最も踏みやすい落とし穴の一つになっています。
レート制限機構
レート制限は取引システム保護の要であり、量的開発者が必ず押さえるべきパラメータです。
| エンドポイント種別 | 重み上限 | 集計窓 | 備考 |
|---|---|---|---|
| 現物パブリック | 6000 weight | 1 分 | IP 単位 |
| 現物取引 | 1200 weight | 1 分 | key 単位 |
| 先物パブリック | 2400 weight | 1 分 | IP 単位 |
| 先物取引 | 100 注文 / 10 秒 | ローリング | key 単位 |
| WebSocket 接続 | 5 接続 / IP | 長時間接続 | 頻繁な再接続を避ける |
A:レスポンスヘッダー X-MBX-USED-WEIGHT-1M で当分の消費 weight を確認できます。戦略コードはこの値を監視してバックオフを実装してください。429 を踏むと短時間で IP 単位のバンにつながります。
418 発動時の帰結
429 を退避せず連発すると 418(IP バン)にエスカレートします。バン時間は最短 2 分、最長 3 日。418 期間中は API キーを切り替えても復旧しない——バンは IP 単位だからです。戦略側で厳密なローカルレート制限を設ける必要があります。
key 漏洩時の緊急対応 5 ステップ
漏洩が疑われる場合、5 分以内に以下を完了してください。
- 即時に key を無効化:Binance Web 版にログイン → API 管理 → 該当 key を「無効化」(削除ではなく)。無効化直後から全リクエストが失敗します。
- 主アカウントパスワードを変更:API 漏洩とパスワードは直接関係なくても、連鎖リスクを避けるため同時変更を推奨。
- 全セッションの強制ログアウト:アカウント → セキュリティ → デバイス管理 → 全ログアウト。併せて 2FA をリセット。
- ホワイトリスト変更の点検:攻撃者が key を使ってホワイトリストを書き換えていた場合、24 時間クールダウン中ならまだ間に合う。すぐに人的サポートチケットでアカウント凍結を依頼。
- 直近 30 日の明細を監査:取引履歴と出金履歴をダウンロードし、1 件ずつ照合。不審な取引は直ちにスクリーンショットで証拠保全。
A:削除ではなく無効化を選ぶ理由は証拠保全のためです。削除すると API 経由で当該 key の履歴を照会できなくなり、事後追跡が困難になります。
事後レビュー
事後には必ず完全な振り返りを行ってください。どのマシンから secret が漏れたのか、ログに平文 secret が残っていなかったか、IP ホワイトリストを一時解除した経緯はなかったか。8 割のケースは secret を Git リポジトリにコミット、あるいは平文設定ファイルに置いたことが原因です。
鍵ローテーション戦略
3 段階の周期を推奨します。
- 読み取り専用 key:半年ごとにローテーション。長期漏洩による静かな悪用を防止。
- 取引 key:四半期ごとにローテーション。戦略のリリースサイクルと合わせる。
- 出金 key:タスク終了の都度無効化。次回タスク前に再発行し、常駐させない。
- テスト key:テスト完了時に即無効化。テスト用 key に取引権限は決して付与しない。
ローテーション後は Binance公式サイト にログインして旧 key が全て無効化済みか確認してください。Binance公式アプリ から API 利用履歴を眺め、見慣れない UA があれば即対応します。
よくある質問
Q1:読み取り専用 API キーが漏洩した場合も対応が必要ですか?
A:必要です。読み取り専用 key はポジション、注文、残高を露呈するため、逆張り対倒やフィッシングの標的絞りに悪用され得ます。発見次第すぐ無効化を。
Q2:1 アカウントで作成できる API キー数は?
A:Binance は現物で最大 30 個、先物側は独立して最大 30 個です。1 戦略 1 key を推奨し、隔離と監査を容易にしてください。
Q3:-1021(タイムスタンプ)エラーが頻発する原因は?
A:多くはローカル時計の非同期です。Linux は chronyd / systemd-timesyncd、Windows は自動時刻同期をオンにしてください。家庭回線ではしばしば数百ミリ秒〜秒単位のズレが生じます。
Q4:API secret を環境変数に保管してよいですか?
A:推奨されるやり方です。ただし環境変数がログにダンプされないよう配慮が必要で、特に CI/CD 環境では要注意です。AWS Secrets Manager や HashiCorp Vault などのシークレットマネージャがより安全です。
Q5:API キーが「未有効化」表示になっている場合、凍結ですか?
A:口座リスク管理の発動、または KYC ステータス変化の可能性があります。まずメール受信箱でリスク管理通知の有無を確認し、必要ならサポートチケットで優先処理を依頼してください。
Q6:先物 API と現物 API は同じ key ですか?
A:はい、1 本の key で現物・先物・オプションを網羅し、権限のチェックボックスがそれぞれ独立しています。現物と先物で key を分けるのがリスク分離の常套手段です。
Q7:API 取引に手数料割引はありますか?
A:VIP レベルに達すれば、API 取引も Web 版と同じ手数料割引が自動適用されます。追加申請は不要です。BNB 手数料充当も API 取引で有効です。
Q8:漏洩した secret は取り消せますか?
A:secret 自体は取り消せませんが、その key を無効化することで実質失効します。secret は再生不可の一度限りの値で、漏洩したら key ごと差し替えるしかありません。
警告
⚠️ Binance 公式が Email、Telegram、Discord を通じてユーザーの API secret を要求することは一切ありません。「収益率アップ」「戦略シェア」を謳って secret を求める提案はすべて詐欺です。オープンソースの量的フレームワークはローカル配備が可能で、第三者サーバーに secret を送信する必要はありません。
本記事の公開日は 2026-07-08、次回検証予定は 2026-10-08 です。