バイナンス API の読み取り専用権限(画面上では Enable Reading と表示されます)は、データを読み取ることだけができ、発注・注文のキャンセル・出金はできません。そのため、相場の取得、資産の照合、サードパーティの家計簿ツールへの権限付与に適しています。キーを作成するには、まずバイナンス公式サイトでアカウントの管理画面にログインします。スマートフォンの場合はバイナンス公式アプリでも作成済みのキーを確認でき、iPhone をお使いの方はiOSインストールガイドをご覧ください。なお、読み取り専用キーは資金を動かせないものの、残高や約定履歴は閲覧できるため、依然として機密情報にあたります。気軽に他人へ渡さないでください。
読み取り専用権限でできること・できないこと
A:読み取り専用権限では、口座残高、現在の注文、過去の注文、約定の詳細、入金履歴、出金履歴を取得できます。注文の作成、注文のキャンセル、出金の開始はできません。 バイナンスで API キーを作成すると、初期状態では読み取り権限のみにチェックが入っており、取引・出金・先物などの権限は手動で追加しない限り有効になりません。
読み取り専用権限の価値は、「データを見ること」と「資金を動かすこと」を完全に切り離せる点にあります。読み取り専用キーをレポートツールや家計簿アプリ、自作スクリプトに渡した場合、キーが漏洩しても攻撃者は資産を送金したり市場で発注したりできず、被害はプライバシーの範囲に限られます。
次の表は、代表的な権限の種類ごとの違いを比較したものです。正確な名称や選択肢は、バイナンスの API 管理ページに現在表示されている内容に従ってください。
| 権限の種類 | 残高・履歴の取得 | 発注・キャンセル | 出金 | 漏洩時の主なリスク |
|---|---|---|---|---|
| 読み取りのみ(Enable Reading) | 可能 | 不可 | 不可 | 保有資産や取引傾向を見られる |
| 現物・マージン取引 | 可能 | 可能 | 不可 | 不正な発注で損失が出る |
| 先物取引 | 可能 | 可能(先物口座) | 不可 | 不正なポジション建てや強制清算 |
| 出金を許可 | 可能 | 他のチェック次第 | 可能 | 資産を直接送金される |
表のとおり、読み取り専用キーは4つの設定の中で最もリスクが低いものです。データを見るだけの用途では、手間を省くために全権限へチェックを入れるのではなく、まず読み取り専用を選んでください。
公開の相場データと読み取り専用キーの違い
A:公開の相場用エンドポイントにはキーが一切不要で、読み取り専用キーが担うのは「自分のアカウントのデータを見る」ことです。 最新価格、ローソク足、板情報、24時間統計といったバイナンスの相場系エンドポイントは公開データで、ログインしなくても誰でも呼び出せます。
初心者の方は、相場を取得するだけでも API キーが必要だと誤解しがちですが、実際には HTTP リクエスト1つで足ります。次のコマンドで BTCUSDT の最新価格を直接取得できます。
curl "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"
返ってくるのは取引ペア名と最新の約定価格を含む JSON です。残高、現在の注文、約定履歴のように個人のアカウントに紐づくデータだけが、API Key の付与とリクエストへの署名を必要とします。
| 比較項目 | 公開相場エンドポイント | 読み取り専用キーのエンドポイント |
|---|---|---|
| API Key の要否 | 不要 | 必要 |
| 署名の要否 | 不要 | 必要(HMAC-SHA256) |
| 取得できる内容 | 価格、ローソク足、板、約定 | 残高、注文、約定、入出金履歴 |
| 個人情報に関わるか | いいえ | はい |
| 代表的な用途 | チャート確認、相場ボード、戦略のバックテスト | 資産照合、家計簿、保有資産の監視 |
読み取り専用権限の代表的な3つの使い方
A:読み取り専用キーの代表的な使い方は、資産照合、保有資産の監視、サードパーティツールへの権限付与の3つです。 いずれも資金を動かす必要はなく、アカウントのデータを安定して読み取れれば足ります。
使い方1:資産照合
資産照合とは、バイナンスのアカウントにある実際の残高を、自分の帳簿や表計算シートと項目ごとに突き合わせる作業です。読み取り専用のエンドポイントで資産一覧を取得し、自分で記録している購入・売却・入金・出金の履歴を合算して比べると、見落とした手数料、記録していない振替、記帳漏れの取引を見つけられます。
照合では、通常「利用可能残高」「凍結残高」「評価額」の3つの数字に注目します。凍結残高は未約定の注文から生じるもので見落としやすく、帳簿と API の返す数値が合わない原因になりがちです。
使い方2:保有資産の監視
保有資産の監視とは、アカウントの資産を定期的に取得し、公開の相場価格を掛け合わせて総資産の評価額を求める使い方です。個人用のダッシュボード、スマートフォンのホーム画面ウィジェット、通知スクリプトの多くがこの形です。
こうしたスクリプトはデータを読み取るだけなので、読み取り専用キーで十分です。パソコン、Raspberry Pi、クラウドサーバーのどこで動かす場合でも、取引権限を有効にする必要はありません。
使い方3:サードパーティの家計簿・税務ツールへの権限付与
家計簿、資産の集計、税務の整理を行うツールの中には、取引履歴を同期するために読み取り専用の API キーの提供を求めるものがあります。これらのツールは発注を行わないため、読み取り専用権限で足ります。出金権限の有効化を求めるツールがあれば、ただちに権限付与を中止し、提供元を確認してください。
ステップ1からステップ4:読み取り専用APIキーを作成する
A:読み取り専用キーの作成は、通常、ログイン、API 管理の表示、キーの作成と名前付け、Secret の保存と権限の確認という4つのステップで行います。 バイナンスのウェブ版とアプリ版では、バージョンによってメニューの位置が変わることがあるため、実際の画面に従ってください。
ステップ1:ログインして認証を準備する
まずバイナンス公式サイトにログインし、必要な本人確認が完了していること、2段階認証(2FA)が有効になっていることを確認します。API キーを作成する際、バイナンスは通常、2FA、メール、SMS 認証コードのいずれかで操作の確認を求めます。
ステップ2:API管理ページを開く
アカウントセンターで「API 管理」の入口を探し、新しい API キーの作成を選びます。バイナンスでは、システム生成のキーの種類を選び、キーにラベルを付けられます。ラベルには「読み取り専用-家計簿ツール」のように用途を書いておくと、後で区別しやすくなります。
ステップ3:権限を確認してIPを紐づける
作成後、キーのページに権限の一覧が表示されます。読み取り専用のキーでは「読み取りを有効にする」だけを残し、取引や出金などその他の権限がオフになっていることを確認してください。あわせて IP アクセス制限を入力し、自分のサーバーや固定の送信元アドレスだけが呼び出せるようにしておくことをおすすめします。
ステップ4:Secret Keyを保存する
API Key はページでいつでも確認できますが、Secret Key は通常、作成時に一度だけ全文が表示されます。Secret はすぐにパスワードマネージャーや暗号化したファイルに保存してください。チャットグループにスクリーンショットを送ったり、公開のコードリポジトリに書き込んだりしてはいけません。具体的な保管方法は、当サイトの「バイナンスAPIキーの安全な保存方法」の記事をご覧ください。
読み取り専用キーでアカウントを照会する基本の流れ
A:署名付きの読み取りリクエストは、API Key をリクエストヘッダーに入れ、パラメータにタイムスタンプを含め、署名をクエリ文字列の末尾に付ける、という3つの要素で構成されます。 署名は、Secret Key でパラメータ文字列に HMAC-SHA256 を適用して計算します。
次の Python の例は、環境変数からキーを読み込み、現物アカウントの情報を照会するものです。
import os, time, hmac, hashlib, requests
API_KEY = os.environ["BINANCE_API_KEY"]
API_SECRET = os.environ["BINANCE_API_SECRET"]
query = f"timestamp={int(time.time() * 1000)}"
signature = hmac.new(API_SECRET.encode(), query.encode(), hashlib.sha256).hexdigest()
resp = requests.get(
f"https://api.binance.com/api/v3/account?{query}&signature={signature}",
headers={"X-MBX-APIKEY": API_KEY},
)
for item in resp.json()["balances"]:
if float(item["free"]) > 0 or float(item["locked"]) > 0:
print(item["asset"], item["free"], item["locked"])
このコードは残高がゼロでない資産だけを出力します。リクエストが 401 や権限エラーを返した場合は、まずキーに読み取り権限のチェックが入っているか、呼び出し元の IP がホワイトリストに入っているかを確認してください。署名の詳細は、当サイトの「バイナンスAPIの署名の生成方法」の記事で解説しています。
読み取り系の代表的なエンドポイントには、アカウント情報、現在の注文、注文履歴、アカウントの約定履歴、入金履歴、出金履歴があります。正確なパスやパラメータは、バイナンス公式の API ドキュメントに従ってください。
資産照合の実際の進め方
A:資産照合は、まず照合する時点を固定し、そのうえで API のデータと自分の記録を項目ごとに突き合わせる方法で行います。 こうすれば、データがリアルタイムに変動することによる不一致を避けられます。
次の手順は、個人や小規模チームの参考になります。
- 照合する時点を決めます。たとえば毎月末日の決まった時刻とし、そのタイムスタンプを記録します。
- 読み取り専用のエンドポイントで、その時点での各資産の利用可能残高と凍結残高を取得します。
- 対象期間の約定履歴、入金履歴、出金履歴を取得します。
- 前期末の残高に当期の流入を足し、当期の流出を引いて、理論上の残高を計算します。
- 理論上の残高と API が返した実際の残高を比較し、資産ごとに差異を確認します。
差異が出た場合の原因として多いのは、手数料が別の資産で差し引かれている(たとえば BNB での支払い)、少額資産の交換、キャンペーン報酬の付与、そして口座間(現物、ファンディング、先物)の振替の記帳漏れです。調べるときは、全体をまとめて比べず、資産ごとに順に確認してください。
| 差異の原因 | 典型的な現れ方 | 調べ方 |
|---|---|---|
| 手数料の差し引き | 残高が想定よりわずかに少ない | 約定履歴の手数料資産を確認する |
| 口座間の振替 | 現物残高が急に変わる | 振替履歴と照らし合わせる |
| キャンペーン報酬・エアドロップ | 残高が1件分多い | 資金履歴とお知らせを確認する |
| 凍結残高 | 利用可能残高が少なく見える | 現在の注文を照会する |
| 少額資産の交換 | 複数の少額資産が消える | 交換履歴を突き合わせる |
読み取り専用キーを使う際のリスクと安全上の注意
A:読み取り専用キーで資金が送金されることはありませんが、保有資産と取引行動が露出するため、機密性のある認証情報として管理する必要があります。 保有資産の情報が他人に渡ると、ソーシャルエンジニアリング攻撃やフィッシング詐欺の材料にされるおそれがあります。
基本的な安全のルールは次のとおりです。
- 読み取り専用のキーには、取引・先物・出金の権限にチェックを入れないでください。権限が少ないほど安全です。
- キーに IP アクセス制限を設定し、自分の固定アドレスだけが呼び出せるようにします。
- ツールやスクリプトごとに別々のキーを使い、個別に無効化できるようにします。
- カスタマーサポートや「運用代行」を名乗る相手にキーを渡さないでください。バイナンスが公式に Secret Key を尋ねることはありません。
- 異常な呼び出しを見つけたときや、あるツールを使わなくなったときは、API 管理ページで該当のキーをすぐに削除します。
- サードパーティのツールが出金権限を求めてきた場合は、高リスクのサインと捉え、権限付与を断ってください。
あわせてご注意ください。当サイトは独立したサードパーティの解説サイトであり、バイナンスの公式サイトではありません。API の権限名、ページの入口、制限のルールは、バイナンスの公式ページとドキュメントに現在表示されている内容に従ってください。暗号資産の価格は大きく変動し、投資にはリスクが伴います。中国本土のユーザーは、関連サービスを利用する際、現地の法令を自ら確認して遵守してください。
よくある質問
Q:バイナンスAPIの読み取り専用権限で、他人に出金されることはありますか? A:ありません。読み取り専用権限には出金の機能が含まれておらず、出金には別途「出金を許可」の権限が必要です。ただし、読み取り専用キーが漏洩すると保有資産や約定履歴を見られてしまうため、速やかに削除して作り直してください。
Q:相場を見るだけでもAPIキーの申請は必要ですか? A:必要ありません。最新価格、ローソク足、板情報などの公開相場エンドポイントはキーも署名も不要で、HTTP リクエストを送るだけで取得できます。
Q:読み取り専用キーでIPホワイトリストを設定しなくてもよいですか? A:設定しなくても使えますが、おすすめしません。IP 制限があれば、キーが漏洩しても他のアドレスからは使えません。動的 IP をお使いの場合は、送信元が固定のクラウドサーバー経由でリクエストを転送する方法があります。
Q:読み取り専用キーで先物口座のデータも見られますか? A:先物口座のデータを API で読み取るには、通常、キーの権限で先物関連のオプションを別途有効にする必要があります。具体的なオプションは、バイナンスの API 管理ページの表示に従ってください。
Q:サードパーティの家計簿ツールから読み取り専用キーの提供を求められました。安全ですか? A:権限の面では読み取り専用は比較的安全ですが、提供元が信頼でき、プライバシーに関する明確な説明があることを確認してください。そのツール専用のキーを作成し、使わなくなったらすぐに削除しましょう。
Q:読み取り専用の呼び出しで権限エラーが返る場合は? A:まずキーに読み取り権限のチェックが入っているかを確認します。次に、呼び出し元の IP がホワイトリストにあるか、システム時刻がバイナンスのサーバー時刻と大きくずれていないかを調べ、最後に署名が正しいかを確認してください。
Q:読み取り専用キーは定期的に交換する必要がありますか? A:定期的なローテーションをおすすめします。担当者の異動、ツールの利用停止、漏洩の疑いがあるときは、すぐに交換してください。ローテーションの周期に統一の基準はないため、ご自身のリスク許容度に合わせて決めれば問題ありません。
まだバイナンスのアカウントをお持ちでない場合は、先にバイナンス公式サイトで登録と本人確認を済ませ、本記事の手順で読み取り専用キーを作成してください。スマートフォンではバイナンス公式アプリをインストールしておくと、いつでもキーの状態を確認できます。