WEEX API 密钥设置：如何安全连接第三方平台

要将第三方平台连接到 WEEX，请依次进入“账户”和“API 管理”创建 WEEX API 密钥，只授予平台所需的权限，然后将 API 密钥、密钥和通行短语粘贴到平台中。如果该平台是已注册的 WEEX 经纪商，点击“使用 WEEX 登录”按钮也能完成同样的操作，无需你经手任何密钥。本指南将介绍这两种连接方式、安全下第一笔订单的方法、大多数人会遇到的错误，以及决定密钥泄露后可能造成多大损失的安全设置。步骤和限制截至 2026 年 10 月 7 日有效。

快速连接还是手动设置 WEEX API 密钥：该选哪种方式

如果平台提供快速连接，请使用该方式；其他情况则使用手动密钥。

快速连接是 WEEX 的 OAuth 授权功能，于 2026 年 8 月 3 日公布。在合作平台上点击“使用 WEEX 登录”，进入 WEEX 授权页面，查看权限（交易和读取权限已预先选定），然后确认即可。随后，WEEX 会生成 API 密钥并将其发送到平台的后端。你不会看到或复制该密钥。WEEX 表示，整个流程只需低于10秒。

需要注意两点。授权页面位于 www.weex.com，因此在批准任何操作前，请先检查地址栏。另外，WEEX 的 OAuth 规则规定，每位用户在每个第三方平台只能创建一个密钥；因此，若要重新关联同一平台，必须先删除旧密钥。

手动密钥适用于任何支持 WEEX 的软件，包括非经纪商类工具，而且你可以完全控制权限和 IP 绑定。

逐步创建 WEEX API 密钥

1. 在网页端登录 WEEX。依次进入“账户”和“API 管理”，选择“创建 API 密钥”。WEEX API页面上也有一个“创建 API”按钮，点击后会打开同一页面。
2. 将密钥命名为对应的平台名称。
3. 使用字母和数字设置通行短语。WEEX 的常见问题说明不接受特殊字符。通行短语之后无法找回或更改。
4. 选择权限。新密钥默认仅有读取权限。只有在平台需要在相应市场下单时，才添加现货或合约权限。这两种交易权限彼此独立，因此合约机器人不需要现货权限。
5. 如果平台公布了其连接所用的 IP 地址，请绑定这些地址。
6. 完成安全验证。
7. 复制 API 密钥、密钥和通行短语，并妥善保存。HaasOnline 和 KoinX 的设置指南都提醒用户，密钥只会显示一次。

有三项限制值得了解。根据 WEEX 的集成准备指南，每个账户最多可创建 10 组 API 密钥。新建或编辑的密钥需要约 15 分钟才能在所有地方生效。此外，KoinX 的指南称，WEEX 可能会要求填写 API 激活问卷，并在密钥生效前发送确认邮件。因此，密钥在最初几小时内无法使用，并不一定意味着配置有误。

绑定密钥并下第一笔订单

不同平台对这三个值的称呼可能不同。HaasOnline 于 2026 年 8 月 22 日新增了对 WEEX 的支持，是一个典型例子：打开“交易所账户”，选择 WEEX 现货或合约，将 API 密钥填入公钥栏、将密钥填入私钥栏，再添加通行短语，然后点击平台的密钥测试按钮。“访问密钥”和“公钥”指的都是 API 密钥。

在启动交易策略之前，先通过该平台手动下单一次：

1. 选择一个流动性较好的交易对，并使用平台允许的最小下单数量，挂出一笔限价单，价格设在远离当前价格的位置。
2. 检查该订单是否显示在 WEEX 本身的未成交订单中。
3. 通过平台取消订单，并确认它已从 WEEX 上消失。

这一完整流程可以验证密钥、权限和交易对映射均正常，而且不会产生费用。

如果操作失败，原因通常是以下几种：

• 错误 -1052，权限不足。该密钥缺少合约权限，或者该交易对不受支持。
• 新建密钥出现权限错误。等待 15 分钟。
• HTTP 429。平台发送的请求过多。WEEX 的 REST 限制为每个 IP 每 10 秒 500 权重。
• 签名或通行短语错误。粘贴的三个值中有一个缺少字符或多了空格。
• 开启 IP 绑定后请求被拒绝。平台使用的连接地址不在你的地址列表中。

WEEX 的合约 API 常见问题列出了所有错误代码。

WEEX API 密钥安全：限制损失的六项设置

交易密钥不能提取资金，但仍可能导致亏损。在任何交易所，一种已知的滥用手法是：攻击者利用窃取的、仅有交易权限的密钥，从其控制的账户以虚高价格买入流动性差的代币。以下六个做法可以降低风险。

1. 只授予最低限度的权限。税务和投资组合工具只需要读取权限。KoinX 也只要求这一权限。只读密钥无法下单。
2. 只要平台支持，就绑定 IP。WEEX 的文档指出，未绑定 IP 的密钥“存在安全风险”。有些服务无法使用固定地址列表。KoinX 建议用户关闭 IP 限制。如果平台需要不受 IP 限制的密钥，请确保该密钥只有读取权限。
3. 每个平台使用一个密钥。最多可创建 10 组密钥，没有理由与其他平台共用。单独的密钥让你能够停用某一项服务而不影响其他服务，也便于判断是哪项服务发生了密钥泄露。
4. 将通行短语视为第三个机密信息。不要把它放进截图、聊天消息或客服工单中。WEEX 的提示十分明确：“切勿分享你的通行短语。”
5. 拒绝索要超出交易所需权限的请求。集成指南列出的自建密钥权限为读取、现货和合约。若平台索要你的 WEEX 登录密码或提币权限，那么它要求的并非交易所需权限。
6. 有疑虑就删除密钥。WEEX 建议立即删除已泄露的密钥。对于任何已停止使用的平台，也应采取同样的做法。

如何断开平台与 WEEX 的连接

先在平台内移除密钥，再到 WEEX 的“API 管理”中将其删除。第二步才是关键，因为如果只在平台设置中移除密钥，持有该密钥副本的人仍然可以使用它。

通过快速连接创建的密钥也适用同一规则。WEEX 的 OAuth 指南称，若要再次将账户关联到该平台，必须先删除现有密钥。

将平台连接到 WEEX 只需几分钟，但在这几分钟内作出的选择会决定密钥存续期间的风险：授予哪些权限、绑定哪些 IP，以及是否在不再需要时清理密钥。你可以通过 WEEX API 页面创建和管理密钥。

常见问题

1. 我可以在 WEEX 创建多少个 API 密钥？

根据 WEEX 的集成准备指南，每个账户最多可创建 10 组 API 密钥。数量足以为每个已连接的平台单独分配一个密钥，这样就可以撤销某项服务的权限，而不影响其他服务。

2. 丢失 WEEX API 通行短语后可以重置吗？

不可以。WEEX 的文档指出，丢失的通行短语无法找回或修改。请删除该密钥，使用新的通行短语创建密钥，并更新正在使用该密钥的平台。

3. 为什么我的新 WEEX API 密钥会返回权限错误？

通常有三个原因：缺少交易权限、该密钥的市场权限不涵盖相应交易对，以及生效时间未到。WEEX 表示，新建或修改后的密钥需要约 15 分钟才能生效；因此，在更改设置前，先等待一段时间再试。

4. WEEX 支持 TradingView 或 FIX 连接吗？

WEEX 的合约 API 常见问题将 TradingView 集成和 FIX API 均列为暂不支持。连接通过 REST 和 WebSocket 接口进行，可以直接连接，也可以通过已集成这些接口的平台连接。