Binance API Key 作成と IP ホワイトリスト設定の実践手順
Binance でゼロから API Key を作成し IP ホワイトリストにバインドするフル手順。権限選択、IPv4 セグメント 203.0.113.0/24 の書式、90 日ローテーション、鍵漏えい時の緊急対応まで一度に解説します。
Binance で API Key を作成する正しい順序は次のとおりです。まず Binance公式サイトにログインし 2FA を通過、「アカウント → API 管理」画面へ進みます。続いて新規 API を作成して名前を付け、その場で IP ホワイトリストを有効化して固定出口 IPv4 セグメント(例:203.0.113.0/24)を入力、必要に応じて読み取り専用 / 現物取引 / 出金権限を選択(初期はまず読み取り専用のみ推奨)、最後に API Secret を控えてオフラインで確実に保管します。新規発行された API Key はいずれも 90 日間の有効期間しか持たず、期限が来たら必ずローテーションが必要です。API 呼び出しの検証に Binance公式アプリを使うと、通知や取引の確認がすばやく手元で行えます。
Web 開発者の視点で言えば、API Key はアカウントの権能をスクリプト・取引 bot・データダッシュボードに公開する「物理鍵」そのものです。漏えいはアカウント権限の一部を他人に手渡すのと同義です。権限を最小に絞る、IP ホワイトリストをきつく縛る、ローテーション周期を短くする。この三原則は絶対です。以下では手順全体を分解しつつ、IPv4 セグメントの書式、権限レイヤー、漏えい時の緊急対応まで丸ごと整理します。
API Key 作成前の準備
出口 IP を先に把握する
IP ホワイトリスト運用の前提は、あなた自身またはプログラムが固定 IPv4 の出口を持っていることです。そうでなければ IP が変わるたびにホワイトリストを直しに来る羽目になります。典型的な三パターンは次のとおりです。
- 家庭用ブロードバンド:多くは動的 IP。DDNS か VPN で固定化しない限り、家庭回線 IP を直接指定するのは非推奨です。
- クラウドサーバー:通常は出口 IP が固定なので、クラウド事業者に割り当てられたパブリック IPv4 をそのまま使えます。
- オフィスネットワーク:出口が単一 IP か NAT プールかをネットワーク担当者と確認してください。
固定 IP が用意できない段階では、まず読み取り専用の API Key だけを発行し、IP を確定してから段階的に権限を広げるのが安全です。
名前と用途を一対一で対応させる
用途ごとに別の API Key を用意し、一本のカギで何もかも回さないようにしましょう。命名例は次のとおりです。
| Key 名称 | 用途 | 権限 | 備考 |
|---|---|---|---|
read-only-portfolio |
資産ダッシュボードで残高取得 | 読取専用 | 毎時ポーリング |
spot-bot-btc-usdt |
現物グリッド bot | 現物取引 | 単一銘柄 |
data-export |
毎日約定履歴を書き出し | 読取専用 | 1 日 1 回 |
treasury-withdraw |
定期でコールドウォレットへ出金 | 出金 | 取引権限は絶対に付けない |
分割の利点は、どれか一本が漏えいした際に該当 Key だけを失効させれば済むこと、そして各 Key の最終利用時刻を監査に使えることです。
2FA とメール認証の準備
API Key の作成・編集・削除は毎回 2FA コード + メール確認を要求されます。直近で 2FA 移行を行った場合(/posts/biabaweb-2fa-migration/ 参照)は、新しい認証アプリが安定稼働していることを確認してから作業に入ってください。
権限レイヤーの選び方
Binance API Key の権限は上から下へ段階的に強くなります。最小権限の原則で選択しましょう。
権限クイックリファレンス
| 権限 | できること | リスク | 推奨シナリオ |
|---|---|---|---|
| 読取専用 | 残高・注文・約定の参照 | 低 | 資産ダッシュボード、税務書き出し |
| 現物取引 | 発注、キャンセル | 中 | グリッド・アビトラ bot |
| 先物取引 | 建玉、決済、レバレッジ変更 | 高 | 先物戦略 |
| レバレッジ借入 | 借入、返済 | 高 | レバレッジ戦略 |
| 出金 | オンチェーン出金の起票 | 極高 | 財務出金スクリプト |
| ユニバーサル | 複合権限 | 極高 | 非推奨 |
読取専用のデフォルト挙動
読取専用のみを選んだ Key は GET 系エンドポイントしか呼べません。仮に漏えいしても攻撃者は残高と履歴を眺めるだけで資金を動かせず、ホワイトリストと組み合わせれば資産損失リスクはほぼゼロです。データ分析目的であれば、ここで止めるのが鉄則です。
出金権限の追加要件
出金権限にチェックを入れると、Binance は次を必須にします。IP ホワイトリストの設定、そしてアカウントレベルの出金アドレス白名单との併用(/posts/biabaweb-withdrawal-whitelist/)。1 回あたりおよび 24 時間の限度額もアカウント側の出金上限と共有です。スクリプトから自動出金する場合は、二つのホワイトリストを同時に有効化することが前提となります。
Q:まず読取専用で試して、動作確認後に取引権限へ切り替えても良い? A:可能で、この順序を強く推奨します。まず一週間読取専用で走らせ、IP が変動しないか、スクリプトが安定するかを観察し、問題なければ権限を一段ずつ広げてください。権限拡張時にも 2FA + メール確認を求められます。
Q:読取専用と現物取引を同時にチェックした場合、両者は加算されるのか、上書きされるのか? A:加算です。全 Key に読取専用はデフォルトで許可されており、取引権限にチェックを入れると発注能力が上乗せされます。
IP ホワイトリストの書式
IP ホワイトリストはカンマ区切りで複数エントリを指定でき、単一 IP・複数 IP・CIDR セグメントに対応します。
主な記法
- 単一 IPv4:
203.0.113.55 - 複数 IPv4:
203.0.113.55,203.0.113.56 - IPv4 セグメント:
203.0.113.0/24(203.0.113.0 〜 203.0.113.255 の範囲) - 小さめセグメント:
203.0.113.0/29(連続 8 個の IP)
書式の注意点は次のとおりです。
- マスクが小さい(数字が小さい)ほど広い IP を覆い、危険度は上がります。原則 /24 を超えて広げないでください。
- IPv6 と IPv4 は互いに代替できません。実際の出口プロトコルに合わせて指定します。
- ドメイン名や DDNS ホスト名は非対応、必ず数値 IP を書きます。
- セグメント間は半角カンマ区切り、空白は入れません。
クラウドサーバー出口の確認方法
クラウドにデプロイした場合は SSH ログイン後に第三者の IP 表示サービスへアクセスし、実際の出口 IP を確認してください。プレーンテキストで IP を返すエンドポイントが便利です。管理コンソールに表示される「パブリック IP」は入口用と出口用が別々に払い出される事業者もあるので、鵜呑みにしないでください。
CIDR 選択の指針
宿主単位の /32(単一 IP)か、伸縮を見越した /29(8 個)を優先します。/24 は大規模スケール要件がない限り避けましょう。0.0.0.0/0 や「未設定」は絶対禁止です。未設定は全 IP からの呼び出しを許すのと同義で、極めて高リスクです。
ホワイトリストが効いているかの検証
設定後は、ホワイトリスト外のマシンからその API Key で任意のエンドポイントを叩いてみてください。-2015 あるいは「Invalid API-key, IP, or permissions」に類するエラーが返れば、ホワイトリストは有効です。呼び出せてしまう場合は、保存し忘れか IP バインドの入力ミスです。
90 日期限とローテーション
2023 年以降、取引または出金権限を持つ API Key には 90 日の有効期間が強制されています。期限が切れると Key は自動で読取専用へ降格されるので、ユーザーが手動で延長または新規発行を行う必要があります。
正しいローテーション手順
- 期限の 7 日前に新しい API Key を作り、権限・IP・備考を既存と同一に合わせる
- 新 Key の Access Key / Secret Key をスクリプトへ配布し、環境変数を切り替える
- 24 時間観察し、新 Key の稼働が問題ないことを確認する
- 期限到来と同時に旧 Key を削除、「念のため」で残さない
利点は、24 時間の並行運用でサービス中断を避けつつ、旧 Key を期限直後に無効化して漏えい面を最小化できることです。
自動延長に頼らない
Binance には「有効期限の延長」ボタンがありますが、これに頼ると Access Key / Secret Key が半永久的に変わりません。過去に一度でも漏えいしていれば、そのまま長期的なリスク源になります。定期的なローテーションこそ最も有効な鍵衛生です。
出金ホワイトリストとの関係
Key が出金権限を持つ場合、ローテーション時に出金アドレスホワイトリストを作り直す必要はありません。アドレス帳はアカウントレベルで Key と独立しているためです。ただし新 Key + 既存アドレスで小額出金の全経路演習を必ず行い、経路の正常性を確認してから本番規模の運用に戻してください。
鍵漏えい時の緊急対応
API Key の漏えいに気付いた、または疑ったときは、次の順序で 5 分以内に手を動かせば損失を最小化できます。
- 「アカウント → API 管理」を開き、疑わしい Key を削除
- 全セッションからログアウト(ログインページで「他デバイスからログアウト」)
- アカウントのログインパスワードをすぐに変更
- 「セキュリティ → ログイン履歴」「セキュリティ → 操作ログ」を確認
- 「入出金明細」に未承認の取引や出金がないか点検
- 侵入の疑いが強ければ 2FA をリセット
- Binance 公式サイトからサポートチケットを提出し状況を説明
- 一週間以内にホワイトリスト・2FA・API・登録メールを含む完全セキュリティ点検
事後の振り返り
漏えいはどこから起きたのか、典型的な経路を挙げます。
- GitHub のパブリックリポジトリに誤コミット
- 設定ファイルに書いた Key ごとチャットツールにアップロード
- デプロイスクリプトに Key を含めたまま複数台に配布
- 退職者の権限が回収されず放置
- スクリーンショットやログ自動送信機能付きの開発ツールを使用
漏えいごとに根本原因分析(RCA)を行い、次回を防ぐ運用改善へつなげてください。
リスク警告:SNS 上で「API グリッドを代行構築します」と積極的に声をかけてくるアカウントはすべてフィッシングです。Access Key や Secret Key を DM で送るよう要求する行為は例外なく詐欺です。正規アプリのダウンロードは常に公式入口だけを使い、真偽判定のルールは /posts/binance-anti-phishing-real-fake/ を参照してください。
よくある質問
アカウントごとに何本まで API Key を作れる?
メインアカウントで現状 30 本まで、サブアカウントは独立カウントです。実務上、同時アクティブな Key は 5 本以下に抑え、残りは定期的に整理して運用負荷を減らすのがおすすめです。
サブアカウントで独自に API Key を作れる?
作れます。サブアカウントは API 一覧と IP ホワイトリストを独立管理し、権限もメインアカウントと完全分離されます。機関レベルの分離運用では、1 サブアカウント = 1 戦略 = 1 IP という設計が特に有効です。
Secret Key を失念したら?
復元不可です。API Secret Key は作成時に一度しか表示されず、Binance も平文を保存しません。紛失時は Key を削除して作り直すしかないので、作成した瞬間にパスワードマネージャーや暗号化ファイルに書き込むクセをつけてください。
他人の IP から自分の API Key を使われる可能性は?
IP ホワイトリストを設定していれば不可能です。Access Key + Secret Key を盗まれても、ホワイトリスト外のマシンから呼べば即座に失敗します。これがホワイトリストの中核価値です。
期限切れ後もそのまま旧 Key を使い続けたい
読取専用に降格されたうえで使い続けることは可能です。取引や出金を復活させるには「延長」ボタンから 2FA 認証を通してください。ただし本番環境で延長頼みは非推奨で、能動的に新 Key へ差し替えるべきです。
ホワイトリスト変更でレートリミットは変わる?
変わりません。レートリミットはアカウント単位のクォータで、IP ホワイトリストとは独立です。頻繁にリミットに引っかかる場合は、呼び出し頻度の最適化かクォータの引き上げ申請で対応してください。
CIDR セグメントは書ける?
書けます。書式は 203.0.113.0/24 です。ただしセグメントが大きいほど危険なので、/32 で済むところは /32、/29 で済むところは /29 に留めましょう。
複数のクラウドリージョンにデプロイしている場合、どう管理する?
リージョンごとに独立した API Key を用意し、それぞれのリージョンの出口 IP にバインドすることを推奨します。切替時は該当 Key だけを触れば済み、問題発生時の切り分けも速くなります。一本の Key で複数リージョンをまとめてカバーするのは、原因調査が困難になるうえ攻撃面を広げるだけなので避けてください。
初版公開 2026-07-01、次回検証予定 2026-10-01。