BybitをFreyaに接続する

Bybitは、Freyaが接続の設定をあなたの代わりに行える唯一の取引所です。FreyaはBybitの登録ブローカーであるため、BybitがAPIキーを自らの側で作成し、適切な権限を付与して、Freyaへ直接引き渡します — あなたはキーを目にすることも、シークレットをコピーすることも、IPアドレスをホワイトリストに登録することもありません。

この方法はクイック接続と呼ばれます。Bybit上で自分でキーを作成する従来の方法も引き続き存在し、問題なく使えます。このガイドでは両方の方法に加え、キーを差し替える必要があるときや接続に失敗したときの対処法を解説します。

はじめる前に

先に確認しておきたいことが2つあります。

接続するアカウントに資金を入れておく。 残高が空ではボットはポジションを開けませんが、Freyaは取引原資のないキーでも問題なく接続してしまいます。先物ボットを運用する予定なら、ボットが使うアカウントに資金があることを確認してください。

ブラウザを使う。 どちらの方法もデスクトップとモバイルのブラウザで動作します。APIキーの手動作成はBybit側ではブラウザ専用の作業です — BybitのモバイルアプリにはAPIキーの画面がありません。

クイック接続

こちらが私たちの推奨する方法です。Bybitにログイン済みなら15秒ほどで終わります。

1. Freyaで設定 → APIキーを開き、APIキーを追加を選択します。
2. 取引所としてBybitを選びます。クイック接続タブがすでに選択されています。
3. Bybitと接続を選択します。Bybitのタブが開きます。
4. Bybitにログインします。 アカウントがまだなければ、その場で作成して戻ってくれば大丈夫です — 接続は待っていてくれます。
5. 内容を確認して承認します。 BybitはFreyaが何をリクエストしているかを正確に表示します。何かが付与されるのは、承認というこのステップだけです。
6. タブが自動的に閉じ、キーがFreyaに表示され、すぐに使えます。

1回の承認で現物と先物の両方がカバーされます。市場ごとに繰り返す必要はありません。

裏側で起きていること

承認すると、BybitはFreyaのブローカー登録に紐付いたAPIキーを作成し、Freyaのサーバーへ直接送信します。この経路で届くため、キーがあなたのブラウザ、クリップボード、スクリーンショットを経由することはありません — APIキーが漏えいするのは、たいていそこからです。

さらに、BybitはそのキーをFreyaのサーバーに自ら紐付けます。あなたが得られる2つの利点：

• IPホワイトリストが不要。 Bybitの設定にコピー＆ペーストするものは何もありません。
• キーに有効期限がない。 手動で作成したキーは期限切れになりえますが、ブローカーに紐付いたキーはなりません。

途中で気が変わったら

Bybitの画面で拒否してもまったく問題ありません。Bybit側では何も作成されず、Freya側でも何も変わりません — 認証が完了しなかったことが表示されるだけで、いつでも好きなときにやり直せます。

何も決めずにBybitのタブを閉じた場合も同じです。

Bybitキーの差し替え

新しいキーが必要になることがあります — Bybit側で古いキーを失効させた、別のBybitアカウントへ移行する、サポートから再接続を依頼された、といった場合です。

クイック接続なら、もう一度接続するだけです。 設定 → APIキー → APIキーを追加を開き、Bybitを選んで、前回と同じようにBybitと接続を選択します。Bybitはアカウントごと・プラットフォームごとに1つのキーを発行するため、再接続は2つ目のコピーを積み重ねるのではなく、すでにあるキーを更新します。既存のボットは更新された認証情報でそのまま動き続けます。

これは同じBybitアカウントの場合です。Freyaは既存の接続の上に別のBybitアカウントを接続しません。アカウントを切り替えるには、その接続を使うボットを停止し、FreyaでBybit SpotとBybit Futuresのキーを削除してから、新しいアカウントで接続し、ボットに新しいキーを選択してください。

先にBybit側でキーを削除してしまった場合も、再接続が解決策です — 承認すればBybitが新しいキーを発行します。

⚠️ ボットの稼働中にFreyaのキーを削除しないでください — ボットを止めるつもりがない限りは。有効な認証情報を失った稼働中のボットは、すでに開いたポジションを管理できません。先にボットを停止または終了させてから、再接続してください。

手動接続

キーを自分で作成したい場合や、Bybitのサブアカウントを接続する場合はこちらを使います。

Bybitでキーを作成する

1. ブラウザでBybitにログインし、アカウントのAPIセクションを開きます。
2. システム生成APIキーを作成します。
3. 用途としてAPI取引を選びます — 読み取り専用ではありません。
4. **契約取引（Contract Trade）と現物取引（Spot Trade）**の権限に加え、読み取りアクセスを付与します。
5. 出金は決して付与しないでください。 Freyaには不要であり、使うこともできません。
6. キーをIPで制限し、Freyaのアドレスを入力します。アドレスはモーダルに表示され、コピーできます。

⚠️ Bybitがシークレットキーを表示するのは一度だけです。 画面を閉じる前にコピーしてください。紛失するとキーは復元できず、新しく作り直すしかありません。

Freyaにキーを追加する

1. Freyaで設定 → APIキー → APIキーを追加を開き、Bybitを選びます。
2. 手動接続タブに切り替えます。
3. APIキーとシークレットキーを貼り付け、後で見分けられる名前を付けます。
4. APIキーを追加を選択します。Freyaが接続と権限をその場で認証します。

認証に失敗した場合、Freyaは漠然としたエラーではなく、どの部分が失敗したかを正確に伝えます。各メッセージと対処法は取引所APIキーの接続エラーを解決するをご覧ください。

よくある質問

どちらの方法を使うべきですか？

特別な理由がなければクイック接続です。ステップが少なく、タイプミスで失敗することがなく、IPホワイトリストも完全に不要になります。手動接続は、キーを自分で作成・管理したい人と、サブアカウント向けに存在します。

クイック接続は手動キーよりも多くのアクセスをFreyaに与えますか？

いいえ。どちらの方法でも、同じ範囲の取引キーが作られます：読み取りと取引のみで、出金は決して含まれません。違いは誰が設定するかであって、キーに何ができるかではありません。

IPアドレスのホワイトリスト登録は必要ですか？

手動接続の場合のみ必要です。クイック接続ではBybitがキーをFreyaのサーバーに自動で紐付けます。そのキーに有効期限がないのも同じ理由です。

Bybitの現物と先物を別々に接続できますか？

クイック接続ならその必要はありません — 1回の承認で両方が設定されます。手動接続なら、市場を分けて管理したい場合に別々のキーを追加できます。

2回接続したらどうなりますか？

何も壊れず、何も重複しません。Bybitはアカウントごと・プラットフォームごとに1つのキーを発行するため、2回目の接続は既存のキーを更新します。

Bybitのサブアカウントでクイック接続を使えますか？

サブアカウントには手動接続をご利用ください。クイック接続はメインのBybitアカウント向けです。

Freyaに入った後のキーは安全ですか？

キーは届いた瞬間に暗号化され、二度と表示されません — あなたにも、サポートにも。Freyaで削除すれば保存された認証情報が消え、Bybit側で失効させれば反対側からアクセスが断たれます。全体像はFreya Financeで私の資金は安全ですか？をご覧ください。

接続した直後にキーが無効だと表示されます。なぜですか？

多くの場合、取引権限なしで作成されたキーか、Freya以外のIPに制限されたキーが原因です。クイック接続ではどちらも起こりえないため、その方法で再接続するのがたいてい最速の解決策です。

関連記事

• Bybitクイック接続：ワンクリック設定の仕組み
• Freya Financeに取引所を接続する方法 — BinanceとOKXも含む総合ガイド
• 取引所APIキーの接続エラーを解決する
• 取引所APIのセキュリティとリスク軽減