如何连接你的 OKX API 密钥并解决错误 50119

你的 OKX API 密钥可能有效，却仍然返回 “API 密钥不存在。” 如果 EEA 密钥被发送到全球 API，而不是 OKX Europe 的基础设施，重新创建密钥也解决不了问题。我会带你连接 OKX API 密钥，选择正确的账户区域，并在更换凭据之前诊断错误。

关键是核对凭据与区域端点的组合。 正确复制的密钥如果被发送到错误的区域主机，可能在尚未涉及权限时就失败。

有效的 OKX API 密钥也可能在错误的区域端点连接失败

连接失败时，很容易想到重新生成密钥、再次粘贴，再试着增加权限。这种做法把每一次身份验证失败都当成了凭据问题。

OKX 的区域架构让这种假设站不住脚。

OKX Europe Limited 是独立的 MiCA 受监管实体，由 Malta 的 MFSA 授予许可。 EEA 账户位于 my.okx.com，其 API 密钥仅对 OKX Europe 的 API 基础设施有效。

把完全有效的 EEA 密钥发送到全球 www.okx.com API，返回的结果可能是 50119：“API 密钥不存在。” 密钥确实存在，但请求到达了错误的区域端点。

US 账户有自己的区域主机：us.okx.com。这类账户的连接也需要使用对应的区域基础设施。

巴西 OKX 账户使用全球平台和相同的 API，因此请选择 Global。 在当地开展业务，并不自动意味着拥有独立的 API 区域。

我从这里开始排查，因为修改 API 口令或扩大权限都无法纠正区域不匹配。请求必须到达能够识别该密钥的基础设施。

如何创建具备所需权限的 OKX API 密钥

连接获得的访问权限，应足以完成预定任务。为了让错误消失而授予额外权限，不是可靠的诊断方法。

查看投资组合时，使用 Read。只有打算使用会下单的机器人时，才添加 Trade。

绝不要为此连接启用 Withdrawal。

OKX API 密钥设置步骤

1. 打开 OKX 账户中的 API 管理页面。

登录你想连接的账户，进入其 API 管理区域。在创建密钥前，确认该账户属于 Global、EEA 还是 US。

1. 为此连接创建专用 API 密钥。

给它取一个容易辨认的名称，方便以后审查访问权限时识别其用途。专用密钥也让你更容易单独修改或撤销此连接的访问权限。

1. 创建时设置 API 口令。

这是你为 API 密钥自行设置的口令。它不是你的 OKX 账户密码，连接时需要将它与 API 密钥和密钥 Secret 一起提供。

1. 启用 Read，以查看投资组合。

如果你的目的是查看投资组合信息，从 Read 权限开始。只用于查看的连接不需要交易权限。

1. 仅为需要下单的机器人添加 Trade。

Trade 权限授权交易活动。只有确实需要这项功能时才启用它，不要为了排查身份验证错误而试着开启。

1. 保持 Withdrawal 关闭。

查看投资组合和机器人下单都不需要提现权限。不要为了完成设置而授予该权限。请记住，关闭提现并不能避免交易亏损：拥有 Trade 权限的密钥仍然可以提交导致亏损的订单，因此，应限制交易连接能够访问的账户中的资金。

1. 条件允许时，将密钥绑定到连接使用的 IP 地址。

使用发起 API 请求的服务所指定的 IP 地址。确保该配置与你实际使用的连接一致。

1. 安全保存 API 密钥、密钥 Secret 和 API 口令。

将它们作为敏感凭据保管。在连接表单中输入时，检查每个值是否完整，并确认它们属于同一个 API 密钥。

创建密钥只是设置的一部分。接收这些凭据的连接还必须知道该使用哪个区域主机。

为什么 IP 白名单很重要

IP 绑定会限制密钥可以从哪里使用。它也会影响密钥的生命周期：OKX 可能删除未绑定 IP 且长期未使用的 API 密钥，所以你创建后一直没用的密钥，等你再次使用时可能已不存在。

不要因为还保存着凭据，就假设密钥仍然有效。到 OKX API 管理页面检查其状态。

还有一个需要留意的独立配置问题：即使密钥处于有效状态，如果请求方的 IP 不在白名单中，请求也可能被拒绝。这会产生与 IP 有关的错误，此时应该检查 IP 设置，而不是重新创建密钥。

为什么有效的密钥也会让 OKX 返回“API 密钥不存在”

这句话听起来像是定论。但从诊断角度看，它所能说明的范围比表面上更窄。

对于 EEA 账户，错误 50119 可能意味着全球端点无法识别一个在 OKX Europe 基础设施上有效的密钥。 如果一份连接指南从不询问你的账户属于哪个实体，就无法识别这种情况。

区域划分有文档依据，并非对凭据问题的猜测

OKX EEA API 常见问题文档说明了 my.okx.com 的区域背景，以及密钥仅在 EEA 区域有效的限制。Freqtrade、CCXT 和 Hummingbot 中的公开问题报告也印证了这种现象：当集成使用全球主机时，EEA 用户会收到“API 密钥不存在”的错误。

这些报告支持优先检查区域端点。但它们不能证明每次出现该错误都是同一个原因。

我的诊断结论很明确：在替换 OKX 仍列为有效状态的密钥之前，先核实账户区域。 如果连接器假定所有账户都使用全球 API，反复创建密钥也不会改变这个假设。

错误 50119 的其他原因仍需检查

区域不匹配并非唯一解释。同样的错误还可能涉及：

• 模拟交易密钥被用于错误的环境。 确认凭据与连接所要求的环境匹配。
• 密钥被自动删除。 检查该密钥是否仍存在于 OKX API 管理页面中。
• 粘贴内容被截断。 确保输入了完整的 API 密钥。
• 密钥确实无法识别。 确认凭据来自你打算连接的账户。

我会依次检查这些可能性，而不是同时修改所有设置。如果你一次性更换凭据、权限、环境和区域，即使重试成功，也很难知道究竟哪里出了问题。

真正有用的问题是：对于这个账户和环境，这个端点能识别这个仍然有效的密钥吗？

重试之前，先读懂 OKX 错误代码

连接失败是一种症状。OKX 错误代码才是更有用的证据。

公开的 OKX API 错误代码参考文档区分了无法识别的密钥、错误的 API 口令、无效签名和 IP 限制。每一种都指向连接中的不同环节。

错误代码	含义	应检查什么
50119	API 密钥不存在	账户区域和区域主机；模拟环境与预期环境是否匹配；密钥是否被删除；粘贴的密钥是否完整
50105	API 口令错误	使用创建此 API 密钥时设置的口令，而不是账户密码
50113	签名无效	检查密钥 Secret，以及集成中的请求签名实现
50110	请求 IP 不在白名单中	检查请求方的 IP 是否包含在该密钥允许的 IP 配置中

错误 50105：检查 API 口令

API 口令是独立的凭据。在该字段中输入 OKX 登录密码，无法满足验证要求。

还要检查 API 口令是否与 API 密钥及密钥 Secret 属于同一组凭据。混用不同创建记录中的凭据，可能让每个值单独看起来都没问题，但组合在一起却无法使用。

错误 50113：排查请求签名

签名无效指向请求上的身份验证签名。检查密钥 Secret；如果你负责维护集成，还应检查其签名实现。

如果你使用连接表单，请查阅连接器的技术文档或联系其支持渠道，以排查请求签名。启用 Trade 或 Withdrawal 不能修复无效签名。

错误 50110：检查 IP 白名单

这个错误指向允许访问的 IP 配置。核实发起请求的服务所使用的 IP，再将其与密钥的白名单进行比较。

盲目重试同一个请求，不会消除不匹配。再次测试之前，先纠正相关设置。

如何将 OKX 连接到 Anny

我的连接表单包含账户区域选择器，提供 Global、EEA 和 US 选项。该选择可确保密钥在对应的区域主机上进行验证。

连接流程如下：

1. 打开添加交易所的表单，选择 OKX。

准备好 API 密钥、密钥 Secret 和 API 口令。

1. 选择账户区域。

OKX Europe 账户选择 EEA，OKX US 账户选择 US，全球平台上的账户选择 Global。巴西账户选择 Global。

1. 输入相互匹配的凭据。

粘贴完整的 API 密钥和密钥 Secret，然后输入创建密钥时设置的 API 口令。

1. 确认权限符合你的用途。

使用 Read 查看投资组合。仅为机器人添加 Trade，并保持 Withdrawal 关闭。

1. 验证连接。

如果失败，根据返回的错误代码决定下一步检查什么。遇到 50119 时，先重新检查区域，再考虑创建另一个密钥。

将 OKX 连接到 Anny

选择区域是身份验证的要求，不是显示偏好。 它决定凭据在哪里接受验证。

排查问题时，如何使用 OKX API 文档

如果你通过现有表单连接，区域选择器和错误代码表就是实际的排查起点。如果你负责维护集成，则应结合区域指南阅读身份验证文档。

OKX API 文档的相关部分回答的是不同问题：

• 区域 API 指南： 这个账户的请求应该发送到哪套基础设施？
• 身份验证指南： 需要哪些凭据，请求必须如何签名？
• 错误代码参考： 提交的请求中，哪个部分被拒绝了？

正确的签名实现仍然可能将请求发送到错误的区域主机。正确的区域主机仍然可能拒绝错误的 API 口令。

我把这些检查分开，因为它们对应不同的修正措施。成功连接需要端点、凭据、环境、权限和 IP 配置相互匹配。

OKX API 连接常见问题

OKX API 密钥会过期吗？

不要假设 API 密钥会一直可用。OKX 可能删除未绑定 IP 且长期未使用的密钥，因此，如果之前保存的凭据无法使用，请检查 API 管理页面。

条件允许时，将密钥绑定到连接指定的 IP 地址，并在排查 API 口令或权限之前，确认密钥仍然有效。

为什么我的 OKX API 密钥有效，却提示不存在？

有效密钥被发送到错误的区域端点时，也可能返回 50119。尤其是 EEA 密钥，应在 OKX Europe 的基础设施上使用；将其发送到全球 www.okx.com API，可能触发“API 密钥不存在”。

还应检查是否存在模拟环境不匹配、密钥被自动删除或粘贴不完整的情况。

OKX 交易机器人需要哪些权限？

使用 Read 查看投资组合，在机器人需要下单时添加 Trade。绝不要为此连接启用 Withdrawal。

额外权限无法解决区域不匹配、API 口令错误、签名无效或 IP 白名单错误。

OKX API 口令和我的密码一样吗？

不一样。API 口令在创建 API 密钥时设置，与你的 OKX 账户密码相互独立。

请输入与该特定密钥关联的 API 口令。

巴西 OKX 账户应该选择哪个区域？

选择 Global。OKX Brazil 在全球平台上运营，并使用相同的 API。

每次连接失败，我都应该创建新密钥吗？

不应该。先阅读错误代码，再检查它所指向的设置。

对于 50119，确认区域主机、环境、密钥是否有效，以及粘贴的值是否完整。如果连接一直将密钥发送到错误的区域端点，新密钥也无法修复它。

下一步真正有用的行动是诊断，而不是又一次原样重试。 从区域入手，读懂代码，再修改证据所指向的设置。

本文仅用于教育目的，不构成财务建议。过往表现 ≠ 未来结果。Anny 是 AI 驱动的分析平台，并非注册投资顾问。