在机器人替您交易之前，Freya 需要连接到您资金所在的交易所 — Binance、OKX 或 Bybit。您无需转移资金，也无需分享交易所密码。取而代之的是，您创建一个 API 密钥：一种权限受限的凭证，它允许 Freya 代您下单，而您的资金始终留在自己的交易所账户中。
本指南将准确说明该授予哪些权限（以及绝对不能授予哪些权限）、如何在 Freya 中添加密钥，以及当连接验证不通过时该怎么做。如果您想先了解这为何是安全的整体逻辑，请先阅读我的资金在 Freya Finance 上安全吗？。
要点总结
- 您通过 API 密钥（一种权限受限的凭证）连接交易所 — 而不是转移资金或分享交易所密码。
- 密钥需要读取权限，以及现货和／或合约交易权限。它绝不能拥有提现权限。
- OKX 密钥需要您在创建时自行设置的 Passphrase；Binance 和 Bybit 不需要。
- 在 Freya 的「设置 → API 密钥 → 添加 API 密钥」中添加密钥，Freya 会立即进行验证。
- 如果验证失败，Freya 会准确告诉您原因 — 密钥无效、IP 未列入白名单，或缺少某项权限 — 每一种都有简单的解决方法。
步骤速览
- 在您的交易所创建 API 密钥，开启读取和交易权限，但不开启提现权限。
- 复制凭证 — API 密钥、密钥（Secret），以及（OKX 的）Passphrase。
- 将密钥添加到 Freya，路径为「设置 → API 密钥 → 添加 API 密钥」，并选择您的交易所。
- 让 Freya 验证 — Freya 会立即检查连接与权限。
- 修正它报告的任何错误 — 如果验证失败，Freya 会准确告诉您问题所在。
什么是 API 密钥 — 以及 Freya 需要哪些权限
API 密钥是一对凭证（一个密钥和一个 Secret），它让某个应用以受限的方式与您的交易所账户通信。这个密钥被允许做什么，由您决定。对 Freya 而言，只需启用：
- 读取 — 让 Freya 能够查看您的余额、持仓和订单状态。
- 现货交易和／或合约交易 — 让您的机器人能够下达所需的订单。请根据您计划运行的机器人类型来启用对应项。
Freya 只负责下单交易；它从不需要把资金转出您的账户。请始终让所连接密钥的提现权限保持关闭。这是您在交易所端掌控的权限 — 只要它是关闭的，无论是 Freya 还是任何可能拿到该密钥的人，都无法提走您的资金。这是连接任何机器人平台时最重要的习惯。
第 1 步：在您的交易所创建 API 密钥
在交易所的 API 管理板块中，创建一个新的 API 密钥：
- Binance — 在 API 管理中创建密钥，启用读取以及现货和／或合约交易权限，并保持提现关闭。
- OKX — 创建密钥并设置一个 Passphrase（您在 Freya 中会用到它）；启用读取和交易权限，不启用提现。
- Bybit — 为您将要使用的产品创建带有读取和交易权限的密钥，并保持提现关闭。
如果您的交易所提供 IP 白名单功能，将密钥限制到 Freya 的 IP 地址是个好习惯。如果您这样做，请务必把 Freya 的 IP 加入白名单，否则连接会被拒绝（参见下方的错误对照表）。
创建密钥时，交易所只会显示 Secret 一次。请立即复制并妥善保管。如果丢失，您无法找回 — 只能删除该密钥并重新创建一个。
第 2 步：将密钥添加到 Freya
在 Freya 中，进入**「设置 → API 密钥」并选择「添加 API 密钥」**。然后：
- 选择您的交易所（Binance、OKX 或 Bybit）。
- **粘贴 API 密钥和 Secret。**对于 OKX，还需输入您设置的 Passphrase。
- 为密钥命名，方便您日后识别。
您可以连接多个交易所，并随时在同一页面管理或删除您的密钥。
第 3 步：Freya 验证您的密钥
您一添加密钥，Freya 就会检查连接和权限 — 无需猜测。如果一切正确，密钥即通过验证并可以使用。如果有问题，Freya 会显示一条清晰的提示，准确说明需要修正什么。
读懂验证错误
如果验证失败，请把 Freya 显示的提示与下面的解决方法对应起来：
| Freya 显示的提示 | 含义 | 如何解决 |
|---|---|---|
| 无效的 API 密钥 | 密钥复制有误，或已在交易所被删除 | 重新准确复制 API 密钥，或创建一个新的 |
| 无效的密钥（Secret） | Secret 与该 API 密钥不匹配 | 重新复制 Secret；如果已丢失，请创建新密钥 |
| IP 地址未列入白名单 | 密钥设置了 IP 限制，而 Freya 的地址不在允许范围内 | 把 Freya 的 IP 加入该密钥的白名单，或移除 IP 限制 |
| 缺少权限 | 密钥缺少读取或交易权限 | 在密钥上启用读取以及现货／合约交易权限 |
| 已禁用读取权限 | Freya 无法读取您的账户 | 在密钥上启用读取／查看权限 |
| 已禁用现货／合约权限 | 该密钥无法下达您的机器人所需的订单 | 启用与您的机器人相匹配的交易类型（现货或合约） |
| 连接失败 | 临时的网络或交易所问题 | 稍等片刻，然后重新尝试添加密钥 |
Freya 还会标记出处于**「无限制」模式的密钥 — 也就是没有设置任何 IP 限制的密钥。出于安全考虑，Freya 会要求您开启 IP 限制**并添加它显示的地址，之后才能保存该密钥。请只启用读取和交易权限（绝不启用提现），并把密钥限制到 Freya 的 IP。（关于连接错误的更多内容，请见无法连接您的交易所？。）
关于安全的说明
这套连接方式在设计上是安全的，但几个习惯能让它保持如此：
- 始终关闭提现 — Freya 从不需要它。
- 在交易所支持时使用 IP 白名单。
- 一把密钥，一个用途 — 并删除您不再使用的密钥。
要全面了解您的资金和密钥是如何被保护的，请参阅我的资金在 Freya Finance 上安全吗？和交易所 API 安全与风险缓解。
常见问题
Freya 需要我的 API 密钥拥有哪些权限？
读取权限（查看您的余额、持仓和订单）以及现货和／或合约交易权限（下达机器人的订单）。请启用与您将要运行的机器人相匹配的交易类型。Freya 从不需要提现权限，因此请始终让它保持关闭。
Freya 需要提取我资金的权限吗？
不需要。Freya 只负责下单和管理交易；它不能、也不应该有能力把资金转出您的交易所。请始终让所连接密钥的提现权限保持关闭 — 这是您在交易所端掌控的权限。
为什么 Freya 提示「IP 地址未列入白名单」？
因为您的 API 密钥被限制到了特定的 IP 地址，而 Freya 的地址不在名单上。您可以在交易所把 Freya 的 IP 地址添加到该密钥的白名单中，或者移除密钥的 IP 限制。更新之后，请在 Freya 中重新添加该密钥。
为什么会提示「无效的 API 密钥」或「无效的密钥」？
通常是因为 API 密钥或 Secret 复制有误，或者该密钥已在交易所被删除或重新生成。请重新准确复制这两个值。由于 Secret 只在创建密钥时显示一次，如果您已经没有它了，请在交易所删除该密钥并创建一个新的。
Passphrase 是什么，OKX 为什么要它？
OKX 的 API 密钥包含一个 Passphrase，它由您在创建密钥时自行设置 — 是密钥和 Secret 之外的一项额外凭证。在 Freya 中添加 OKX 密钥时，请输入相同的 Passphrase。Binance 和 Bybit 不使用 Passphrase。
我可以连接多个交易所吗？
可以。您可以添加 Binance、OKX 和 Bybit 的 API 密钥，并随时在「设置 → API 密钥」中管理或删除它们。
把 API 密钥交给 Freya 安全吗？
在密钥设置正确的前提下是安全的 — 只开读取和交易权限，不开提现权限，并在条件允许时设置 IP 白名单。您的资金留在您自己的交易所，而您分享的这把密钥无法转移它们。完整的解释请参阅《我的资金在 Freya Finance 上安全吗？》。
Freya 支持哪些交易所？
Freya 目前可连接 Binance、OKX 和 Bybit（现货和合约）。未来可能会陆续增加更多交易所。您在所连接的交易所上进行交易 — 您的资金和可交易市场都留在该交易所。
我可以交易哪些币种或交易对？
可用的交易对来自您所连接交易所自身的上币列表，而不是 Freya 单独的一份清单 — 因此只要交易所上架了某个交易对（例如 BTC/USDT、ETH/USDT），您就可以在它上面搭建机器人。大多数交易以 USDT 作为计价货币。如果交易所下架了某个交易对，它在该交易所就不再可交易。