取引所の接続は、トレーディングボットを始めるうえで昔から最も面倒な部分でした。プラットフォームを離れてAPIセクションを探し、どの権限なら安全そうかを判断し、「一度しか表示されない」と言われるシークレットをコピーし、IPアドレスを入力欄に貼り付け、すべて正しくできていることを祈る — そんな作業です。
Bybitでは、そのどれもがもう必要ありません。FreyaはBybitの登録ブローカーであるため、Bybit自身がキーを作成してFreyaへ直接引き渡せます。あなたはBybitの画面上で一度承認するだけで完了です。
この記事では、それが実際に何をしているのかを説明します — 取引口座へのアクセスが関わる以上、「ワンクリック」というのは、まさに中身をきちんと検証すべき類いの主張だからです。
要点
- あなたはBybit自身のサイト上でFreyaを承認します。キーはBybitが作成し、Freyaのサーバーへ直接送られます。
- 認証情報があなたのブラウザ、クリップボード、スクリーンショットを経由することはありません — キーが漏えいするのは、たいていそこからです。
- IPホワイトリストは不要で、キーに有効期限もありません。BybitがキーをFreyaのサーバーに自ら紐付けるためです。
- 1回の承認で現物と先物の両方が設定されます。
- 付与されるのは手動キーとまったく同じ範囲のアクセスです：読み取りと取引のみで、出金は決して含まれません。
「ワンクリック」が実際に意味すること
承認すると3つのことが起こります。それぞれを正確に押さえておく価値があります。
キーを作成するのはBybitであり、Freyaではありません。 Freyaがあなたに代わって認証情報を生成することはなく、Bybitのパスワードを尋ねることもありません。キーは、あなたがBybitのドメイン上で承認した後に、Bybit自身によって、あなたのBybitアカウントの中で発行されます。
キーはサーバー間で直接受け渡されます。 キーはあなたのブラウザを経由せず、BybitのシステムからFreyaのシステムへ渡ります。これは思った以上に重要です。APIキーが漏えいする最も一般的な原因は不正侵入ではなく、クリップボード、チャットメッセージ、スクリーンショット、置き忘れたテキストファイルに残ったシークレットだからです。クイック接続は、そのステップ自体をなくします。
BybitがキーをFreyaのサーバーに紐付けます。 Freyaは登録ブローカーであるため、Bybitはそのキーがどのアドレスから使用されうるかを把握しており、その制限を自ら適用します。あなたがIPアドレスをどこかにコピーする必要はありません。
有効期限がない理由
Bybit上で手動作成したキーには有効期限が付くことがあります。期限が切れるとボットは動作できなくなります — たいてい最も都合の悪いタイミングで、しかも明確な説明のないままに。
ブローカーに紐付いたキーには、この問題がありません。すでにFreyaのサーバーに限定されているため、Bybitは第二の安全策としての有効期限を必要としないのです。実運用では、稼働中のボットを静かに壊しうる要因が1つ減ることを意味します。
あなたが承認する内容
Bybitの同意画面には、何がリクエストされているかが表示されます。読み飛ばさずに目を通す価値があります。
クイック接続で作成されるキーができること：
- 残高、ポジション、注文履歴の読み取り
- 注文の発注・変更・キャンセル — ボットが取引できるのはこの権限によるものです
できないこと：
- 資金の出金や振替。 Freyaへも、それ以外のどこへも送れません。Freyaはこの権限をリクエストしませんし、仮に付与されても使うことはできません。
- アカウント設定、セキュリティ、パスワードの変更。
これは、正しく作成された手動キーとまったく同じ範囲です。クイック接続がそれ以上を付与することはありません。単に権限を手作業で選ぶ手間を省くだけです — そして手動設定で最も間違いが起こりやすいのが、まさにその工程です。多すぎる方向にも、少なすぎる方向にも。
接続の流れ：ステップごとに
- 設定 → APIキーを開き、APIキーを追加を選択します。
- Bybitを選びます。クイック接続タブがデフォルトで選択されています。
- Bybitと接続を選択します。Bybitのタブが開きます。
- Bybitにログインします — アカウントがなければ、その場で作成できます。時間はいくらかけても大丈夫です。接続は待っていてくれます。
- 同意画面を読み、承認します。
- タブが閉じ、現物と先物の両方のキーがFreyaに表示されます。
拒否した場合
何も作成されず、何も変わりません。理由があってもなくても拒否でき、後からいつでもやり直せます。何も決めずにタブを閉じた場合も結果は同じです。
ブラウザがタブをブロックした場合
ボタンをクリックしたのに新しいタブがブロックされるブラウザもあります。Freyaがそれを検知し、Bybitを自分で開くためのリンクを表示します。その後の接続はまったく通常どおり進みます。
接続した後
Bybitのキーは設定 → APIキーの下に、現物用と先物用の2つとして表示され、作成するどのボットからでもすぐに使えます。
後日もう一度接続しても安全です。 Bybitはアカウントごと・プラットフォームごとに1つのキーを発行するため、2回目の接続は重複を増やすのではなく、既存のキーを更新します。この更新は同じBybitアカウントの場合です。別のBybitアカウントは既存の接続の上には接続されません。先に現在のBybit SpotとBybit Futuresのキーを削除し（それらを使うボットは停止）、それから再接続してください。
アクセスの解除は、どちら側からでもあなたの手で行えます。 Freyaでキーを削除すれば、保存された認証情報も一緒に消えます。Bybitのアカウント側で失効させれば、そこでアクセスは止まります。どちらか一方の操作だけで十分です。
よくある質問
クイック接続は安全ですか？
手動でキーを作成するのと少なくとも同等に安全であり、むしろ安全と言えます。認証情報はBybitが生成してFreyaのサーバーへ直接届けるため、クリップボードやスクリーンショットに残ることがありません。承認はBybit自身のドメイン上で行い、そこで拒否すれば何も作成されません。
FreyaにBybitのパスワードは見えますか？
いいえ。ログインするのはBybitのサイト上であり、Freyaのサイトではありません。FreyaがあなたのBybitログイン情報を受け取ることはありません。
Freyaは私の資金を出金できますか？
いいえ。キーには出金権限がなく、Freyaがそれをリクエストすることもありません。資金があなたのBybitアカウントから出ていくのは、あなた自身が操作したときだけです。
なぜFreyaはIPホワイトリストの登録を求めないのですか？
Bybitが代わりにやってくれるからです。登録ブローカーとして、FreyaのサーバーアドレスはBybitに把握されており、発行されるキーは自動的にそのアドレスに制限されます。
現物と先物で別々に設定する必要はありますか？
いいえ — 1回の承認で両方がカバーされます。
希望すれば手動で接続することもできますか？
はい。手動接続タブは常に利用でき、BinanceとOKXではこれが唯一の方法です。手動の手順はBybitをFreyaに接続するをご覧ください。
Bybitのサブアカウントでも使えますか？
クイック接続はメインのBybitアカウント向けです。サブアカウントには手動接続をご利用ください。
すでに手動でBybitキーを追加している場合は？
そのまま使い続けても、クイック接続でつないで新しいキーを使っても構いません — 両方を共存させられます。クイック接続が更新するのは自身が作成したキーだけなので、手入力したキーに触れることは決してありません。
関連記事
- BybitをFreyaに接続する — 両方の接続方法と、キーの差し替え
- Freya Financeに取引所を接続する方法 — BinanceとOKX
- Freya Financeで私の資金は安全ですか？
- 取引所APIのセキュリティとリスク軽減