手动连接 OKX 比大多数交易所需要更多步骤。您需要创建 API 密钥、选择权限、设置口令、复制一个只会显示一次的密钥，然后将这三项无误地粘贴到 Freya 中。
使用快速连接则无需这些操作。Freya 是 OKX 的注册经纪商，OKX 可以在您的账户内创建密钥并直接交付给 Freya。您只需在 OKX 自己的页面上授权一次，Spot 和 Futures 连接就会同时出现在 Freya 中。
本文介绍该授权的具体操作、对您 OKX 账户的影响，以及当 OKX 或 Freya 显示提示信息而非绿色勾号时应如何处理。
要点总结
- 您在 OKX 自己的网站上授权 Freya。OKX 创建密钥，Freya 在其服务器上接收。
- 您无需查看、复制或输入密钥或口令。
- 一次授权同时设置 OKX Spot 和 OKX Futures。
- 密钥只能读取和交易。Freya 从不请求提现权限，并会拒绝任何可以提现的密钥。
- OKX 每个账户只允许一个 Freya 密钥，因此替换密钥需要先在 OKX 上移除旧密钥。
"一键"的实际含义
OKX 创建密钥，而非您自己。 在您授权后，OKX 会在您的 OKX 账户中为 Freya 创建一个 API 密钥。它会以 FreyaFinance 的名称显示在 OKX 中。
凭据不经过您的手。 密钥及其密钥值从 OKX 直接传输到 Freya 的服务器，并加密存储，连同密钥的口令。没有任何内容通过剪贴板、聊天消息或截图传递。而这些恰恰是 API 密钥最常泄露的途径。
无需创建口令，无需粘贴 IP。 OKX 的密钥始终有口令。使用快速连接时，Freya 会为您设置口令并与密钥一起存储，因此您无需记住任何内容。您也不需要在任何地方复制 IP 地址。
您授权的内容
快速连接创建的密钥可以：
- 读取您的余额、持仓和历史订单
- 下单、修改和撤销订单，这是机器人进行交易所需的权限
不可以：
- 提现或转移资金。 Freya 从不请求提现权限。如果收到的密钥具有提现能力，Freya 会拒绝并且不保存该密钥。
- 更改您的 OKX 密码或安全设置。
这与正确创建的手动密钥具有相同的访问权限。快速连接不会授予更多权限，只是省去了手动选择权限的步骤。
详细流程
- 打开 Settings → API Keys 并选择 Add API Key。
- 选择 OKX。默认选中 Fast Connection 标签页。
- 选择 Connect with OKX。页面在同一标签页中跳转到 OKX。
- 使用您的主账户登录 OKX，如果还没有 OKX 账户，请先创建一个。
- 查看请求并批准。
- 返回 Freya，您会看到 OKX connected：您的 OKX Spot 和 OKX Futures 密钥已添加。
请在开始操作的同一个浏览器中完成。 如果返回 Freya 的页面不是最初发起连接的页面，或者您在 OKX 上等待时间过长，您会看到 This attempt could not be matched。此时未创建任何内容，请从同一页面重新开始连接。
如果您拒绝授权
不会创建任何内容，也不会有任何更改。Freya 显示 Connection cancelled（You declined on OKX's screen, so no API key was created.），您可以随时重试。
如果 OKX 未创建密钥
偶尔 OKX 不允许通过连接创建密钥。您会看到 OKX did not create a key，且 OKX 账户中未添加任何内容。请改用 Manual Connection 标签页自行创建密钥连接。如何连接交易所提供了详细步骤。
连接对您 OKX 账户的影响
快速连接会准备好您的账户，使 Spot 和 Futures 机器人都能运行。可能会更改两项设置，在授权前了解这些信息很有帮助。
账户模式。 Futures 需要允许该功能的 OKX 账户模式。如果您的账户处于 Spot 模式，Freya 会为您切换到 Futures 模式。如果 OKX 不允许切换（例如因为有未平仓头寸或未成交订单），您的连接仍然适用于 Spot。Freya 会显示 Needs OKX Futures mode. Spot is ready 并说明解决方法：要运行 Futures 机器人，请在 OKX 的 Trade → Account mode 中将账户切换到 Futures 模式。
持仓模式。 Freya 的 Futures 机器人使用多空（对冲）模式，这样多头和空头仓位可以同时持有。Freya 会在连接时为您开启此模式。如果您有未平仓的单向持仓，切换会等到它们平仓后进行，您会看到 Will activate once your open One-Way positions close。
账户的其他设置不会变更，您的资金保持原位。
每个 OKX 账户一个 Freya 密钥
OKX 允许每个账户持有一个 Freya 密钥。您可能遇到的大多数提示信息都与此规则有关。
此账户已在此处连接。 再次连接不会产生变化：您会看到 This OKX account is already connected。这是为了保护您的机器人当前正在使用的密钥。
OKX 上已有 Freya 密钥。 之前连接的密钥仍在 OKX 上，因此 OKX 没有创建新密钥。Freya 显示 OKX already has a Freya key 并提供三个步骤：
- 使用 Freya 提供的按钮打开 OKX 授权页面。
- 在那里移除 FreyaFinance。其 API 密钥会一同被删除。您的其他 API 密钥不受影响。
- 返回并选择 Try Again。
密钥属于另一个 Freya 账户。 如果消息为 This OKX account is connected to another Freya account，请勿在 OKX 上移除任何内容：另一个账户上的机器人会停止运行。请改用 Manual Connection 将 OKX 添加到此账户。
Freya 无法确定谁在使用该密钥。 如果 Freya 要求您 check before you remove anything on OKX，请仅在确定没有 Freya 账户使用 FreyaFinance 时才将其移除。如果不确定，请使用 Manual Connection。
替换失效的密钥
- 停止使用您 OKX 密钥的机器人。Freya 不会删除运行中机器人仍在使用的密钥。
- 在 API Keys 页面删除 OKX Spot 和 OKX Futures。它们在 OKX 上共享同一个密钥。
- 在 OKX 的授权页面移除 FreyaFinance。仅在 Freya 中删除会让旧密钥留在 OKX 上。
- 重新使用快速连接，然后将机器人指向新密钥。
连接之后
您的密钥会以 OKX Spot 和 OKX Futures 的形式出现在 Settings → API Keys 中，您创建的任何机器人都可以立即使用它们。之前手动添加的密钥不会被触及，两者可以并存。
使用 OKX 登录。 一旦您的 OKX 主账户通过此方式连接，您还可以用它来登录。在 Settings → Profile Settings → Sign-in methods 中开启。只要连接保持有效，此功能就会正常工作：如果您移除了连接，开关会提示您先重新连接此 OKX 账户。
移除权限由您掌控。 在 Freya 中删除密钥会移除 Freya 的副本，但密钥仍保留在 OKX 上。Freya 会向您展示如何在 OKX 上移除。在 OKX 的授权页面移除 FreyaFinance 会删除 OKX 上的密钥，OKX Spot 和 OKX Futures 会同时停止工作。
常见问题
快速连接到 OKX 安全吗？
至少与手动创建密钥一样安全。OKX 在您的账户内生成密钥，密钥直接传输到 Freya 的服务器，因此密钥值永远不会出现在您的剪贴板或截图中。您在 OKX 自己的域名上授权，可以随时拒绝而不创建任何内容。
Freya 能看到我的 OKX 密码吗？
不能。您在 OKX 的网站上登录，而非 Freya 的。Freya 永远不会收到您的 OKX 登录凭据。
Freya 能提取我的资金吗？
不能。密钥仅具有读取和交易权限，Freya 会拒绝任何可以提现的密钥。您的资金只能通过您自己的操作离开 OKX 账户。
我需要创建口令吗？
不需要。OKX 的密钥始终有口令，使用快速连接时 Freya 会设置口令并与密钥一起存储。只有手动创建密钥时才需要自己设置口令。
需要分别为 Spot 和 Futures 操作吗？
不需要。一次授权同时添加 OKX Spot 和 OKX Futures。它们在 OKX 上共享同一个密钥。
连接会改变我的 OKX 账户设置吗？
可能会更改两项设置以使 Futures 机器人能够运行：如果您的账户处于 Spot 模式，会更改账户模式；持仓模式会切换为多空模式。如果任一项无法更改，Freya 会通知您。此外还会添加一个名为 FreyaFinance 的密钥，您可以随时在 OKX 的授权页面将其移除。
我可以使用 OKX 子账户吗？
快速连接适用于您的 OKX 主账户。对于子账户，请在该子账户中创建密钥并使用 Manual Connection。
如果我更喜欢手动连接，还可以吗？
可以。Manual Connection 标签页始终可用。请参阅如何将交易所连接到 Freya Finance 获取手动步骤（包括口令设置）。
相关阅读
- OKX 交易机器人：了解您可以在 OKX 上使用 Freya 自动化哪些交易
- 如何将交易所连接到 Freya Finance：每个交易所的手动连接方式
- 如何在 Freya Finance 上管理交易所 API 密钥
- 修复交易所 API 密钥连接错误
- 快速连接到 Bybit
- 我的资金在 Freya Finance 上安全吗？