Freya Financeで取引所APIキーを管理する方法

#Freya Financeで取引所APIキーを管理する方法

APIキーは、Freyaがあなたに代わって取引所で注文を出すために欠かせないものです。取引所を接続すると、すべてのキーが1か所にまとまり、そこで内容を確認したり、各キーに何が許可されているかを正確に把握したり、キーを追加したり、使わなくなったものを削除したりできます。このガイドではその管理方法を解説します。

はじめて取引所を接続する方は、取引所を接続する方法からお読みください。この記事はすでに追加済みのキーを管理するための内容です。

---

#手順の概要

1. キー一覧を開く — 設定 → APIキー に移動すると、接続済みのすべての取引所が、それぞれのラベル・追加日・ステータスとともに表示されます。
2. 各キーの権限を確認する — 読み取りと取引（先物取引を行う場合は先物も）が表示されていること、そして出金権限が付いていないことを確認します。
3. 必要に応じてキーを追加する — 「APIキーを追加」から、別の取引所や追加のキーを接続します。最初の接続と同じ流れです。
4. 使わなくなったキーを削除する — 削除を選んで確定します。まだそのキーを使っているボットがあると、Freya は削除を拒否して該当数を知らせます。先にそれらを停止または一時停止してください。

#APIキーの場所

設定 → APIキー に移動してください。あなたのAPIキーが表示され、アカウント上のすべての取引所接続が一覧できます。それぞれについて、Freyaは次の情報を表示します。

• 取引所（Binance、OKX、Bybitのいずれか）。
• キーのラベル。複数のキーを見分けるために使います。
• 追加日。
• ステータス（アクティブ）。

まだ何も接続していない場合は、代わりに最初のAPIキーを追加という案内が表示されます。

#キーの権限を理解する

各キーには、作成時に付与された権限が表示されるため、そのキーに何ができるのか迷うことはありません。

• 読み取り — Freyaが残高とポジションを確認できるようにします（すべての機能に必要です）。
• 取引 — Freyaが注文を発注・管理できるようにします（ボットが取引に使うのはこの権限です）。
• 先物 — キーに先物取引のアクセス権も有効になっている場合に表示されます。

この透明性には意味があります。Freya用のキーは読み取りと取引のためだけのものです。出金権限は持っておらず、また持つべきでもありません。そのため、あなたの資金がFreyaを通じて取引所から出ていくことは決してありません。全体像についてはFreya Financeで私の資金は安全ですか？をご覧ください。

#キーを追加する

同じ画面のAPIキーを追加から、複数の取引所（または複数のキー）を接続できます。設定の流れは最初の接続と同じです。OKXのパスフレーズを含む手順の詳細は取引所を接続する方法をご覧ください。

#キーを削除する

接続を解除するには、対象のキーで削除を選んで確認します。知っておいていただきたい点がいくつかあります。

• 取り消せません。 再接続するには、キーを一から追加し直す必要があります。
• Freya は削除前に確認します。 そのキーで稼働中のボット、または待機中で取引の準備ができているボットがあると削除は拒否され、対象のボット数が表示されます。ダッシュボードから停止または一時停止してから再試行してください。取引の途中でキーを失ったボットは、すでに建てたポジションを管理できなくなります。
• 削除時には通知が届きます。 アクセス権の変更を常に把握できるようにするためのセキュリティ上の配慮です。

#キーは安全に保管されます

FreyaはAPI認証情報を暗号化して保管します。APIキー画面にも、安全に保管されている旨が明記されています。出金権限のないキーと組み合わせることで、最悪の事態が起きたとしても、Freyaを通じてあなたの取引所口座から資金が動かされることはありません。

#よくある質問

#取引所APIキーはどこで管理しますか？

設定 → APIキー です。この画面には、接続済みのすべてのキーが取引所・ラベル・追加日・ステータスとともに一覧表示され、新しいキーの追加や既存キーの削除もここから行えます。

#読み取り・取引・先物のラベルは何を意味しますか？

各キーに何が許可されているかを示しています。読み取りはFreyaが残高とポジションを確認できるようにするもの、取引は注文の発注と管理を可能にするもの（ボットが使うのはこれです）、先物はキーに先物取引のアクセス権も付いている場合に表示されます。Freya用のキーに出金権限が必要になることはありません。

#別の取引所やキーを追加するにはどうすればいいですか？

同じ画面の「APIキーを追加」を使います。最初のキーと同じ接続フローが実行されます。OKXの追加パスフレーズを含む詳しい手順は、「取引所を接続する方法」のガイドをご覧ください。

#APIキーを削除するとどうなりますか？

Freya はまだ依存しているものがないか先に確認します。そのキーで稼働中のボット、またはシグナルを待っているボットがあると削除は拒否され、対象のボット数が表示されます。停止または一時停止してから削除してください。キーに依存するものがなくなると接続は解除され、これは取り消せません。キーが削除されたことを確認する通知も届きます。

#APIキーは安全に保管されていますか？

はい。認証情報は暗号化して保管され、接続するキーには取引のアクセス権のみが付与されます — 出金権限は決してありません。この組み合わせにより、Freyaを通じてあなたの資金が取引所から出金されることはありません。

#FreyaはAPIキーを使って私の資金を出金できますか？

いいえ。キーは読み取りと取引のアクセス権のみで作成され、出金権限は含まれません。万が一何か問題が起きたとしても、Freya用のキーを使って誰かがあなたの資金を取引所から動かすことはできません。

#APIキーの権限を編集したり、ローテーションしたり、無効化するにはどうすればいいですか？

接続済みのキーをその場で「編集」する方法はありません。権限の変更、キーの更新や差し替えは、Freya から削除して新しいものを追加する流れになります。取引所で新しいキーを作成し、再接続してください。Freya は使用中のキーを削除しないため、まず古いキーを使っているボットを停止または一時停止してください。新しいキーを接続したら、それらのボットを新しいキーに向けて再度開始します。キーを削除せずに使用を止めたい場合は、キーを削除するのではなく、依存しているボットを一時停止してください。