OKX怎么接Altrady？多账户交易与订单核验

欧易OKX

2026年10月14日

Altrady 连接 OKX 的核心不是"一键绑定"，而是一次 API 权限的精确配置。你需要在 OKX 创建一组只读+交易的密钥，把 Altrady 的 20 个 IP 地址填进白名单，然后在 Altrady 端选择正确的 API 版本（www.okx.com 还是 my.okx.com）。多账户管理在 Altrady 端是原生支持的，每个 OKX 账户或子账户对应一个独立的 Trading Account，通过标签区分。

欧易OKX交易所
全球领先的加密货币平台，适合新手与进阶交易者
新手福利：注册即享20% 交易手续费减免！

立即注册 APP下载

创建 OKX API 密钥：权限和白名单是关键

你需要在 OKX 网页端完成这一步，App 端也能创建，但手动填 IP 白名单在电脑上更方便。

登录 OKX 后，进入 个人资料 > API，点击"创建 API"。填写名称后，选择要连接的是主账户还是某个子账户。权限方面，只勾选"交易"（Trade），不要勾"提现"（Withdraw）。Altrady 官方文档明确写了它只请求只读和交易权限，从不请求提现权限。如果你勾了提现，反而扩大了密钥暴露后的风险。

IP 白名单是这一步最需要留意的。Altrady 提供了 20 个 IP 地址，你需要在 OKX 开启"受信任的 IP 访问"后全部粘贴进去。如果你跳过白名单直接创建，后续 Altrady 可能无法连接，OKX 也会因为"密钥与第三方软件绑定类型不兼容"而报错 50110。白名单加上后，即使密钥泄露，攻击者没有 Altrady 的 IP 也无法调用。

还需要创建一个 Passphrase（密码短语），这是 OKX API 特有的第三项凭证，和 API Key、Secret Key 一起使用。三样东西都要保存好，Passphrase 丢失后无法找回，只能删掉密钥重建。

有一个容易被忽略的细节：在 OKX 创建密钥时，Markets 那一栏要勾选"现货和杠杆"，如果将来要交易合约也勾上。官方指南特别指出，如果跳过这个步骤，OKX 后续会拒绝每一笔订单，报错 50123。

在 Altrady 端连接

创建好密钥后，在 Altrady 的 Settings > Exchange Account API Keys 中点击"+ Connect Account"，选择 OKX。

连接方式选 Manual Connect（手动连接），不要选 Fast Connect。Fast Connect 虽然更自动化，但它不支持 EEA 地区的 OKX 账户（因为 EEA 账户运行在 my.okx.com 而非 www.okx.com），而且一个 OKX 账户只能创建一个 Fast Connect 密钥，如果你之前已经连过，会直接报错。

在 Altrady 的连接表单中，API 版本要和你实际使用的 OKX 站点一致。OKX 有三个域名：全球用户用 www.okx.com，EEA 用户用 my.okx.com，美国用户用 us.okx.com。选错版本会触发 50119 错误（API key does not exist），因为密钥和域名的区域不匹配。不确定的话可以选"Auto detect"，但手动指定更可靠。

把 API Key、Secret Key 和 Passphrase 分别粘贴进去，点击 Connect。Altrady 会开始同步余额和账户数据。

多账户管理：每个连接都是一个 Trading Account

Altrady 把每个连接的交易所账户称为 Trading Account。如果你在 OKX 有主账户和多个子账户，每个都需要单独创建 API 密钥，然后在 Altrady 中分别连接。

连接时给每个账户起一个清晰的标签，比如"OKX 主账户""OKX 子账户 A"。Altrady 在所有界面都用这个标签来区分账户。切换到不同账户的方式是在 Trading Account 字段的下拉菜单中选择。选中后，Trading 组件显示该账户的余额和钱包，图表显示该账户的挂单和已完成交易，My Orders 也只显示该账户的订单。

如果你的资金在 OKX 的资金账户（Funding） 而不是交易账户（Trading），Altrady 不会识别。连接前需要确保资金已经划转到交易账户。

订单核验：在 Altrady 的 My Orders 里看状态

订单执行后，去 My Orders 组件查看。这个组件显示每个订单的日期时间、市场、类型（市价/限价）、方向、价格、数量、已成交数量、总额和状态。

订单状态有几个阶段：Pending 表示 Altrady 暂扣订单等待条件触发（比如止盈在入场成交前一直 pending）；Open 表示订单已经到达交易所订单簿等待成交；Closed 表示完全成交；Canceled 表示被取消。如果你在 OKX 上直接开的仓位，Altrady 同步后会显示为 manual position，不会有 Altrady 的自动止盈止损管理。

核验时注意同步延迟。Altrady 从交易所拉取数据，延迟取决于交易所本身。如果你刚在 OKX 下了一单，Altrady 可能需要几秒到几十秒才显示。如果觉得通知延迟，可以点 Resync 箭头手动刷新，但不要频繁点击以免触发限流。

常见连接失败的原因

如果 Altrady 连接 OKX 时报错，先检查这几项：API 密钥的权限是否只有"读取"和"交易"（没有提现）；IP 白名单是否完整填入了 Altrady 的 20 个地址；API 版本是否匹配你使用的 OKX 域名；资金是否在交易账户而非资金账户。

OKX 对 API 密钥还有 AUM 门槛：某些地区的账户需要 AUM > 100 USD 才能创建 API 密钥。如果你资金量低于这个数，创建密钥的入口可能不可用。