ボットがあなたの代わりに取引するには、まずFreyaが資金の置かれている取引所 — Binance、OKX、Bybit — と接続する必要があります。そのために資金を移動したり、取引所のパスワードを共有したりすることはありません。代わりにAPIキーを作成します。これは、あなたの代理でFreyaが注文を発注することだけを許可する、権限を絞った認証情報です。お金はあなた自身の取引所口座に置かれたままです。
このガイドでは、どの権限を付与すべきか（そして決して付与してはいけないのはどれか）、キーをFreyaに追加する手順、そして接続が認証されない場合の対処法を具体的に解説します。なぜこれが安全なのかという全体像を知りたい方は、先にFreya Financeで私の資金は安全ですか？をお読みください。
要点
- 取引所の接続はAPIキー — 権限を絞った認証情報 — で行います。資金を移動したり、取引所のパスワードを共有したりする必要はありません。
- キーに必要なのは読み取り権限と、現物取引および／または先物取引の権限です。出金権限は絶対に付与しないでください。
- OKXのキーには作成時に自分で設定するパスフレーズが必要です。BinanceとBybitでは不要です。
- Freyaでは「設定 → APIキー → APIキーを追加」からキーを登録すると、その場で認証が実行されます。
- 認証に失敗した場合、Freyaが原因を明示します — キーが無効、IPが未登録、権限不足など — それぞれに簡単な対処法があります。
手順の概要
- 取引所でAPIキーを作成する — 読み取りと取引の権限を有効にし、出金は無効のままにします。
- 認証情報をコピーする — APIキー、シークレットキー、そして（OKXの場合）パスフレーズ。
- Freyaにキーを追加する — 「設定 → APIキー → APIキーを追加」で取引所を選択します。
- Freyaに認証させる — 接続と権限がその場で確認されます。
- エラーが出たら対処する — 認証に失敗した場合、Freyaが問題点を正確に伝えます。
APIキーとは何か — そしてFreyaに必要な権限
APIキーとは、あるアプリが限られた範囲であなたの取引所口座とやり取りできるようにする認証情報のペア（キーとシークレットキー）です。そのキーに何を許可するかを決めるのはあなたです。Freyaでは、次のものだけを有効にしてください。
- 読み取り — Freyaが残高、ポジション、注文状況を確認できるようにするためです。
- 現物取引および／または先物取引 — ボットが必要な注文を発注できるようにするためです。運用予定のボットに合うものを有効にしてください。
Freyaが行うのは取引の発注だけであり、あなたの口座から資金を移動する必要は一切ありません。接続するキーでは、出金権限を必ず無効のままにしてください。これは取引所側であなたが管理する権限です。これをオフにしておけば、Freyaも、万一キーを入手した第三者も、あなたの資金を出金することはできません。どのボットプラットフォームを接続する場合でも、これが最も重要な習慣です。
ステップ1：取引所でAPIキーを作成する
取引所のAPI管理セクションで、新しいAPIキーを作成します。
- Binance — API管理からキーを作成し、読み取りと現物取引および／または先物取引を有効にして、出金はオフのままにします。
- OKX — キーを作成し、パスフレーズを設定します（Freyaで入力が必要です）。読み取りと取引を有効にし、出金は有効にしません。
- Bybit — 利用する商品に対して読み取りと取引の権限を付けてキーを作成し、出金はオフのままにします。
取引所がIPホワイトリストに対応している場合は、キーをFreyaのIPアドレスに制限するのが良い習慣です。設定する際は、必ずFreyaのIPをホワイトリストに登録してください。登録がないと接続は拒否されます（下のエラー一覧を参照）。
キーを作成すると、取引所はシークレットキーを一度だけ表示します。すぐにコピーして安全に保管してください。紛失すると復元はできず、キーを削除して新しく作り直す必要があります。
ステップ2：Freyaにキーを追加する
Freyaで設定 → APIキーに進み、APIキーを追加を選択します。そして、
- 取引所を選択します（Binance、OKX、Bybitのいずれか）。
- APIキーとシークレットキーを貼り付けます。 OKXの場合は、設定したパスフレーズも入力します。
- キーに名前を付けます — 後で見分けられるようにするためです。
複数の取引所を接続することもでき、キーの管理や削除はいつでも同じページから行えます。
ステップ3：Freyaがあなたのキーを認証する
キーを追加すると、Freyaはすぐに接続と権限を確認します — 推測の余地はありません。すべて正しければ、キーは認証済みとなり、すぐに使用できます。何か問題があれば、何を直せばよいかを明確なメッセージで示します。
認証エラーの読み解き方
認証に失敗した場合は、Freyaが表示するメッセージを下の対処法と照らし合わせてください。
| Freyaの表示 | 意味 | 対処法 |
|---|---|---|
| APIキーが無効です | キーのコピーが正しくないか、取引所側で削除された | APIキーを正確にコピーし直すか、新しく作成する |
| シークレットキーが無効です | シークレットキーがAPIキーと一致していない | シークレットキーをコピーし直す。紛失した場合は新しいキーを作成する |
| IPアドレスがホワイトリストに登録されていません | キーにIP制限があり、Freyaのアドレスが許可されていない | FreyaのIPをキーのホワイトリストに登録するか、IP制限を解除する |
| 権限が不足しています | キーに読み取りまたは取引の権限がない | キーで読み取りと現物・先物取引を有効にする |
| 読み取り権限が無効です | Freyaがあなたの口座を読み取れない | キーで読み取り・閲覧の権限を有効にする |
| 現物・先物権限が無効です | キーではボットに必要な注文を発注できない | ボットに合う取引タイプ（現物または先物）を有効にする |
| 接続に失敗しました | 一時的なネットワークまたは取引所の問題 | 少し待ってから、もう一度キーを追加してみる |
また、「制限なし」モードのキー — つまりIP制限がかかっていないキー — もFreyaは検出します。セキュリティのため、FreyaはIP制限を有効にして表示されたアドレスを追加するようお願いし、それまでキーは保存できません。有効にするのは読み取りと取引だけ（出金は決して有効にしない）にして、キーをFreyaのIPに制限してください。（接続エラーの詳細は取引所に接続できませんか？をご覧ください。）
セキュリティに関する補足
この接続は設計上安全ですが、その状態を保つにはいくつかの習慣が役立ちます。
- 出金は常にオフ — Freyaが必要とすることはありません。
- IPホワイトリストを使う — 取引所が対応している場合。
- 1つのキーに1つの用途 — 使わなくなったキーは削除しましょう。
資金とキーがどのように保護されているかの全体像については、Freya Financeで私の資金は安全ですか？と取引所APIのセキュリティとリスク軽減をご覧ください。
よくある質問
FreyaはAPIキーにどの権限を必要としますか？
読み取り（残高、ポジション、注文を確認するため）と、現物取引および／または先物取引（ボットの注文を発注するため）です。運用するボットに合う取引タイプを有効にしてください。Freyaが出金権限を必要とすることはないため、常に無効のままにしてください。
Freyaは私の資金を出金する権限を必要としますか？
いいえ。Freyaは取引の発注と管理を行うだけであり、あなたの取引所から資金を移動することはできませんし、できるべきでもありません。接続するキーでは出金権限を常にオフにしておいてください — これは取引所側であなたが管理する権限です。
なぜ「IPアドレスがホワイトリストに登録されていません」と表示されるのですか？
あなたのAPIキーが特定のIPアドレスに制限されていて、Freyaのアドレスがそのリストに入っていないためです。取引所でキーのホワイトリストにFreyaのIPアドレスを追加するか、キーからIP制限を解除してください。更新後、Freyaでもう一度キーを追加します。
なぜ「APIキーが無効です」や「シークレットキーが無効です」と表示されるのですか？
多くの場合、キーやシークレットキーのコピーが正しくないか、取引所側でキーが削除・再生成されたためです。両方の値を正確にコピーし直してください。シークレットキーはキー作成時に一度しか表示されないため、手元にない場合は取引所でキーを削除し、新しく作成してください。
パスフレーズとは何ですか？なぜOKXでは必要なのですか？
OKXのAPIキーには、作成時にあなた自身が設定するパスフレーズが含まれます — キーとシークレットキーに加わるもう1つの認証情報です。OKXのキーを追加する際は、Freyaでも同じパスフレーズを入力してください。BinanceとBybitではパスフレーズは使いません。
複数の取引所を接続できますか？
はい。Binance、OKX、BybitのAPIキーを追加でき、「設定 → APIキー」からいつでも管理・削除できます。
FreyaにAPIキーを渡しても安全ですか？
キーが正しく設定されていれば安全です — 読み取りと取引のみで出金はなし、可能な場合はIPホワイトリストを設定します。あなたの資金はご自身の取引所に置かれたままで、共有するキーでそれを動かすことはできません。詳しい説明は「Freya Financeで私の資金は安全ですか？」をご覧ください。
Freyaはどの取引所に対応していますか？
Freyaは現在、Binance、OKX、Bybit（現物および先物）に接続できます。今後、対応取引所が増える可能性があります。取引を行うのは接続したいずれかの取引所であり、資金と利用可能な市場はその取引所に置かれたままです。
どの通貨や通貨ペアを取引できますか？
利用できるペアはFreyaの独自リストではなく、接続した取引所自身の上場銘柄から取得されます — つまり、その取引所がペア（BTC/USDT、ETH/USDTなど）を扱っていれば、それでボットを構築できます。取引の多くはクオート通貨としてUSDTを用います。取引所がペアを上場廃止した場合、そこでの取引はできなくなります。