読み取り専用の取引所キーを解説：キーにできること、Burokku が受け付けないもの

取引所で保有しているものを表示するには、その取引所の設定で作成した API キーが Burokku に必要です。作成時にチェックを入れた権限によって、アプリがそのキーでできることがすべて決まります。Burokku はこの方法で10以上の取引所を読み取り、貼り付けられたキーで最初に行うのは、そのキーに何が許されているかを確かめることです。

読み取り専用キーにできること、できないこと

読み取りだけをオンにしたキーで、Burokku が見られるのは次のものです。

• アカウント内の各ウォレットの残高：現物、資金、運用、先物など
• 保有中の先物ポジション
• 履歴：入金、出金、取引、ファンディングの支払い

注文を出す、変更する、キャンセルすることはできず、出金や振替もできません。誰かにコピーされても、残高を見られるだけです。

取引所によって権限の名前が違うため、推測はせず、各取引所自身の回答を読み取ります。

• Binance は、内部振替とユニバーサル振替を出金とは別に表示します。私たちはどちらも出金として扱います。
• Kraken には、出金アドレスの追加や変更のための個別の権限があります。これも出金として扱います。
• Bybit のキーは、読み取り専用か読み書き可能かのどちらかです。読み取り用に接続できるのは読み取り専用のキーだけです。
• Coinbase には、資金の出し入れをまとめて扱う権限がひとつあります。この権限を持つキーは拒否します。

ひとつの取引所の画面は、Binance で読み取り専用の API キーを作成する方法で順に説明しています。接続するときには、Burokku が各取引所の手順を表示します。

保存する前にキーをチェックする方法

キーを貼り付けると、Burokku は何かを保存する前に、そのキーで何ができるかを取引所に問い合わせます。読み取り用に接続するキーは、読み取りができ、取引や出金はできないものでなければなりません。どちらかができる場合は受け付けず、外すべき権限をお伝えします。何も保存されません。

私たちを信頼していても、なぜ出金できるキーを拒否するのか。いちばん安全に保管できるキーは、資金をまったく動かせないキーだからです。盗まれたコピーでアカウントを空にされることはありません。だから「念のため」に受け付けることも決してありません。

チェックを通過したキーはその場で一度読み取られるので、アカウントに名前を付ける前に実際の残高を確認できます。キーがどのアカウントのものかを取引所が教えてくれる場合（Bybit がそうです）、すでに追加したアカウントの2つ目のキーは、二重に数えないよう受け付けません。

チェックは接続して終わりではありません。Burokku は1日に一度、各キーの権限を取引所にあらためて問い合わせます。読み取り専用のキーに取引や出金の権限が付いていた場合、Burokku はそのキーを削除し、最後の残高を画面に残したまま、アプリ内とメールで一度だけお知らせします。キーの接続と、私たちが削除したキーは、どちらもアカウントの監査ログに残ります。

キーの保管場所

接続したキーは、ご自身のアカウント専用に作られた鍵でサーバー上で暗号化され、そのアカウントとその取引所に結び付けられます。そのため、コピーをほかの場所に移しても開けません。アカウント自身の領域の外から、平文のキーが見えることはありません。

一度貼り付けたキーが、Burokku のものでもご自身のものでも、ブラウザに送り返されることはありません。アプリに表示されるのは末尾の4文字だけです。何がどこに保管されるかについては、セキュリティの仕組みで説明しています。

キーが使えなくなったとき

キーが使えなくなる理由はありふれたものです。キーを削除した、IP 許可リストを変更した、取引所がキーを無効にした、などです。Burokku の対応は、取引所がキーを拒否したのか、単に取引所につながりにくいだけなのかによって変わります。

• 取引所がキーを拒否した場合。 一度だけなら取引所側の一時的な問題かもしれないので、Burokku は5分待ってから再試行します。2回続けて拒否されると、そのキーの使用をやめ、アプリ内とメールで一度だけお知らせします。バックグラウンドで試し続けることはしません。失敗し続けるキーをロックする取引所もあるからです。再試行するのは、キーを差し替えたときか、再確認を求めたときだけです。
• 取引所につながらない場合。 Burokku は試行の間隔を最大1時間まで少しずつ空け、最後の残高を表示し続けます。取引所につながらないとアカウントに表示されるのは、その状態が30分続いてからです。

自然に失効するキーもあります。Bybit と Gate では、IP 許可リストのないキーは約3か月で失効します。Burokku はその1週間前に一度だけお知らせするので、残高の更新が止まる前に新しいキーを貼り付けられます。

取引用キーとの違い

Burokku から注文を出したい場合は、対応している取引所で、代わりに取引用のキーを接続できます。たとえば Binance や Kraken です。このキーのルールは異なり、より厳しくなります。

• 取引ができること。
• 出金や振替ができないこと。 できる取引用キーは、読み取り専用キーの場合と同様に拒否します。
• IP アドレスにロックされていること。 Burokku は固定 IP アドレスひとつから注文を出し、接続時にそのアドレスを表示します。キーはそのアドレスに制限されている必要があるので、コピーされてもほかの場所では使えません。キーがロックされているかを報告しない取引所では、別のアドレスからキーを試します。そこで取引所が拒否すれば、ロックされています。

取引をオンにするには、Burokku アカウントで2段階認証を設定し、その2段階目の認証で確定する必要があります。その後、どの注文も送信前に、設定した上限と照らしてチェックされます。

ここでも毎日のチェックが適用されます。出金の権限が付いた取引用キーや、IP ロックが外れた取引用キーは削除し、一度だけお知らせします。取引の権限がなくなったキーは、アカウントの読み取り用に戻ります。注文の価格の決め方とチェックについては、Burokku での取引で説明しています。

迷ったら、読み取り専用のキーから始めてください。すべての残高、ポジション、取引をウォレットと並べて確認でき、そのキーで何かが動くことはありません。取引用のキーはあとから追加しても、追加しなくてもかまいません。