Bybit 是唯一一家 Freya 能替您完成连接设置的交易所。Freya 是注册的 Bybit 经纪商，这意味着 Bybit 会在自己一侧创建 API 密钥、附加正确的权限，并直接交给 Freya — 您从不需要看到密钥、复制 Secret，也不需要把任何 IP 地址加入白名单。
这条路径叫做快速连接。老办法 — 您自己在 Bybit 上创建密钥 — 仍然存在，也仍然可用。本指南涵盖这两种方式，以及需要更换密钥或连接失败时该怎么做。
要点总结
- 快速连接只需一键：您在 Bybit 上批准 Freya，现货和合约两把密钥就会自动添加。
- 快速连接无需 IP 白名单 — Bybit 亲自把密钥绑定到 Freya 的服务器，这也是它不会过期的原因。
- 手动连接仍然可用，并且在 Binance 和 OKX 上是唯一的方式。
- 无论用哪种方式，密钥都绝不会获得提现权限。Freya 无法转移您的资金。
- 重复连接不会产生重复密钥 — Bybit 按账户按平台只发放一把密钥，因此它只会刷新您已有的那把。
开始之前
有两件事值得先确认。
为要连接的账户注资。 机器人无法在空余额上开仓，而 Freya 会毫无怨言地连接一把没有任何资金可交易的密钥。如果您打算运行合约机器人，请确保资金在机器人将要使用的账户里。
使用浏览器。 两种方式在桌面和移动端浏览器上都可用。手动创建 API 密钥在 Bybit 一侧是只能在浏览器里完成的操作 — 他们的移动应用不提供 API 密钥页面。
快速连接
这是我们推荐的方式。如果您已登录 Bybit，全程大约十五秒。
- 在 Freya 中，打开**「设置 → API 密钥」并选择「添加 API 密钥」**。
- 选择 Bybit 作为交易所。**「快速连接」**标签页已经选中。
- 选择**「连接 Bybit」**。一个 Bybit 标签页随即打开。
- 登录 Bybit。 如果还没有账户，可以当场注册再回来 — 连接会等着您。
- 查看并批准。 Bybit 会准确显示 Freya 请求的内容。批准是唯一会授予任何权限的一步。
- 标签页自行关闭，您的密钥出现在 Freya 中，即刻可用。
一次批准同时涵盖现货和合约。您不需要按市场重复操作。
幕后发生了什么
当您批准时，Bybit 会创建一把与 Freya 经纪商注册绑定的 API 密钥，并把它直接发送到 Freya 的服务器。因为它以这种方式到达，所以从不经过您的浏览器、剪贴板或截图 — 而这些正是 API 密钥最常泄露的地方。
Bybit 还会亲自把这把密钥绑定到 Freya 的服务器。您因此获得两个好处：
- 无需 IP 白名单。 没有任何东西需要您复制或粘贴到 Bybit 的设置里。
- 密钥不会过期。 手动创建的密钥可能过期；经纪商绑定的密钥不会。
如果您改变主意
在 Bybit 的页面上拒绝是完全安全的。Bybit 上不会创建任何东西，Freya 中也不会有任何变化 — 您只会看到授权未完成的提示，之后随时可以再试。
没有做出决定就关闭 Bybit 标签页，效果相同。
更换 Bybit 密钥
有时您需要一把新密钥 — 您在 Bybit 上吊销了旧密钥、要换到另一个 Bybit 账户，或者客服请您重新连接。
使用快速连接时，重新连接即可。 打开**「设置 → API 密钥 → 添加 API 密钥」，选择 Bybit，然后像之前一样选择「连接 Bybit」**。Bybit 按账户按平台只发放一把密钥，因此重新连接会刷新您已有的密钥，而不是叠加第二份副本。您现有的机器人会在刷新后的凭证上继续运行。
以上适用于同一个 Bybit 账户。Freya 不会在已有连接之上连接另一个 Bybit 账户：如需更换账户，请先停止使用该连接的机器人，在 Freya 中删除 Bybit Spot 和 Bybit Futures 密钥，然后用新账户连接，并为您的机器人选择新密钥。
如果您先在 Bybit 一侧删除了密钥，重新连接同样是解决办法 — Bybit 会在批准后签发一把新的。
⚠️ 不要在机器人运行时删除您的 Freya 密钥，除非您打算停掉它们。一个失去有效凭证的运行中机器人，无法管理它已经打开的仓位。请先停止或关闭您的机器人，然后再重新连接。
手动连接
如果您更愿意自己创建密钥，或者要连接 Bybit 子账户，请使用这种方式。
在 Bybit 上创建密钥
- 在浏览器中登录 Bybit，打开账户的 API 板块。
- 创建一把系统生成的 API 密钥。
- 用途类型选择 API 交易 — 而不是只读。
- 授予合约交易和现货交易权限，外加读取权限。
- 绝不要授予提现权限。 Freya 不需要它，也无法使用它。
- 按 IP 限制该密钥，并输入 Freya 的地址 — 弹窗会显示该地址并允许您复制。
⚠️ Bybit 只会显示您的 Secret 一次。 请在关闭那个页面之前复制它。一旦丢失，密钥无法找回 — 您只能重新创建一把。
将密钥添加到 Freya
- 在 Freya 中，打开**「设置 → API 密钥 → 添加 API 密钥」**并选择 Bybit。
- 切换到**「手动连接」**标签页。
- 粘贴 API 密钥和 Secret，并为密钥起一个日后能认出的名字。
- 选择**「添加 API 密钥」**。Freya 会立即验证连接和权限。
如果验证失败，Freya 会准确告诉您是哪一部分失败了，而不是一条笼统的错误。每条提示及其解决方法请参阅修复交易所 API 密钥连接错误。
常见问题
我该用哪种方式？
快速连接 — 除非您有特别的理由不用它。它步骤更少，不会因为一个笔误出错，还彻底免去了 IP 白名单。手动连接是为想要自己创建和掌控密钥的人以及子账户准备的。
快速连接给 Freya 的访问权限比手动密钥更多吗？
不。两种方式生成的都是权限范围相同的交易密钥：读取和交易，绝无提现。区别在于由谁完成设置，而不在于密钥能做什么。
我需要把某个 IP 地址加入白名单吗？
只有手动连接需要。快速连接由 Bybit 自动把密钥绑定到 Freya 的服务器，这也是那把密钥不会过期的原因。
我可以分别连接 Bybit 的现货和合约吗？
用快速连接不需要 — 一次批准同时设置两者。用手动连接，如果您想把市场分开管理，可以分别添加密钥。
如果我连接了两次会怎样？
什么都不会坏，也不会产生重复。Bybit 按账户按平台只发放一把密钥，因此第二次连接会刷新现有的那把。
我可以用快速连接接入 Bybit 子账户吗？
子账户请使用手动连接。快速连接面向您的 Bybit 主账户。
密钥进入 Freya 之后安全吗？
它在到达的那一刻即被加密，此后不再显示 — 对您不显示，对客服也不显示。在 Freya 中删除它会移除存储的凭证，在 Bybit 上吊销它则从另一侧切断访问。完整说明请参阅我的资金在 Freya Finance 上安全吗？。
刚连接完 Freya 就提示我的密钥无效。为什么？
最常见的原因是密钥创建时没有交易权限，或者被限制到了不属于 Freya 的 IP。快速连接不会出现这两种情况，因此通过它重新连接通常是最快的解决办法。
相关阅读
- Bybit 快速连接：一键设置详解
- 如何将交易所连接到 Freya Finance — 也涵盖 Binance 和 OKX 的通用指南
- 修复交易所 API 密钥连接错误
- 交易所 API 安全与风险缓解