Binance API キー権限管理 完全ガイド|IP ホワイトリスト+HMAC 署名+鍵ローテーション

Binance API キーの読み取り専用 / 取引 / 出金の 3 段階権限、IP ホワイトリスト、HMAC-SHA256 署名、レート制限、漏洩時の緊急対応、四半期ローテーション戦略までを一気通貫で解説し、量的取引・アービトラージ用アカウントをゼロトラスト運用に近づけます。

公開日 2026-07-09 · 約 13 分 · セキュリティ設定

一言で答えると、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 層で最も効果的なセーフティネットです。標準的な設定フロー:

  1. サーバーの出口 IP を特定:本番サーバーで curl https://ifconfig.me または dig +short myip.opendns.com @resolver1.opendns.com を実行してグローバル出口 IP を取得します。IPv6 環境なら IPv6 プレフィックスも併せて記録。
  2. API キーに IP をバインド:Binance の API 管理画面 → 該当 key を編集 → 「アクセス IP を制限」にチェック → IP を貼り付け(複数はカンマ区切り、最大 30 個)→ 2FA 認証で保存。
  3. リクエスト検証:本番サーバーから簡単なリクエスト(GET /api/v3/account 等)を発行し、署名と IP がともに通過することを確認。他 IP から同一リクエストを送ると -2015 が返るはずです。
  4. 固定 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 分以内に以下を完了してください。

  1. 即時に key を無効化:Binance Web 版にログイン → API 管理 → 該当 key を「無効化」(削除ではなく)。無効化直後から全リクエストが失敗します。
  2. 主アカウントパスワードを変更:API 漏洩とパスワードは直接関係なくても、連鎖リスクを避けるため同時変更を推奨。
  3. 全セッションの強制ログアウト:アカウント → セキュリティ → デバイス管理 → 全ログアウト。併せて 2FA をリセット。
  4. ホワイトリスト変更の点検:攻撃者が key を使ってホワイトリストを書き換えていた場合、24 時間クールダウン中ならまだ間に合う。すぐに人的サポートチケットでアカウント凍結を依頼。
  5. 直近 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 です。