WEEX 跟单交易 API：端点、限制与 5 个错误代码

WEEX 跟单交易 API 于 2026 年 6 月 23 日（UTC+8）正式上线，其范围比通用合约 API 更窄且更严格——这正是您在编写任何代码前需要仔细阅读细则的原因。带单交易员拥有一个专用密钥，无法操作现货，无法交易跟单白名单以外的交易对，且止盈止损行为被强制统一。跟单者则拥有大多数交易所不提供的功能：一个用于写入自身跟单配置的 REST 端点，包括滑点上限和各币种杠杆。

本指南涵盖了跟单交易 API 的实际功能、双方的端点列表、跟单者风险设置的真实参数范围、会导致首次集成失败的错误代码，以及该接口与 Binance 和 Bybit 发布的功能对比。

WEEX 跟单交易 API 的功能与限制

跟单交易 API 是一个仅限合约的接口，分为两个角色。带单交易员使用专用的跟单交易 API 密钥下单，WEEX 会自动将执行信号推送给跟单者——您无需自行编写分发逻辑。跟单者使用常规 API 密钥来配置和管理跟单关系。

跟单交易账户中的资金、持仓和风险比率与常规合约账户是隔离的。这种隔离在操作上非常有用：您在自主交易中的失误不会导致跟单者所镜像的仓位被强平。这也是一项对账工作，因为当使用跟单密钥调用 /capi/v3/account/position/allPosition 时返回的是跟单持仓，而使用常规密钥调用时返回的是常规合约持仓。路径相同，但根据您签名的凭证不同，返回结果也不同。

谁可以创建跟单交易 API 密钥，以及为什么只能拥有一个

只有通过 WEEX 精英交易员审核的账户才能创建跟单交易 API 密钥。您可以通过 精英交易员计划 进行申请——截至 2026 年 7 月，WEEX 在 150 多个国家/地区拥有超过 5,000 名精英交易员，并设有 2,000,000 美元的精英交易员基金。审核通过后，密钥将在“用户中心”→“API 管理”→“跟单交易 API”下创建，并受您的资金密码和双重验证保护。

对您的部署计划至关重要的限制是：每个交易员账户仅限一个跟单交易密钥。没有第二个密钥可供轮换，这排除了大多数量化团队用于零停机凭证轮换的蓝绿密钥切换方案。如果您进行轮换，您的策略将在切换期间中断——且在中断期间，跟单者将保持在现有的持仓中。请像安排数据库迁移一样安排轮换，而不是将其作为后台琐事处理。

身份验证采用标准的 WEEX 合约方案：ACCESS-KEY、ACCESS-SIGN、ACCESS-PASSPHRASE 和 ACCESS-TIMESTAMP 标头，其中签名是对 timestamp + METHOD + requestPath + "?" + queryString + body 进行 HMAC SHA256 加密，然后进行 Base64 编码。请绑定 IP 白名单。对于一个可以动用跟单者资金的密钥，未绑定的密钥比个人合约密钥面临的风险要大得多。

带单交易员端点复用合约订单栈

没有单独的“下单跟单交易”调用。带单交易员访问标准的 V3 合约端点，WEEX 会根据密钥类型推断跟单身份：

有三个读取端点是跟单特有的：GET /capi/v3/copy/trader/pairs（权重 1，无需授权）、GET /capi/v3/copy/trader/openOrders（权重 10）和 GET /capi/v3/copy/trader/historyOrders（权重 10，最长 90 天范围，通过 nextKeyId 和 nextKeyTime 进行游标分页）。

值得监测的字段是每个跟踪订单上的 followCount。它告诉您有多少跟单者关联到该特定仓位，这是您获得自身市场影响力的实时衡量指标。一个带单交易员以 3 名跟单者进入一个流动性较差的山寨币永续合约，与同一交易员以 300 名跟单者进入，运行的并不是同一个策略——后者通过跟单分发正在进行自我抢单。如果您的平均入场滑点随着 followCount 的增加而恶化，这就是机制所在，解决方法是调整仓位大小，而不是寻找更好的限价。

跟单者端点：WEEX 在哪些方面超越了大多数跟单 API

这是 API 中真正不寻常的部分。跟单者可以通过 REST 获得对其自身跟单配置的写入权限：

注意权重的非对称性：closePos 权重为 50，是该集合中其他所有端点的五倍。WEEX 为每个 IP 加权端点提供每 10 秒 500 的独立预算，因此该权重意味着每 10 秒大约可调用 10 次 closePos，而权重为 10 的端点则约为 50 次。一个逐个关闭跟踪订单的循环会迅速触发限流，且 429 错误意味着您有义务退避而不是重试。如果您在快速行情中平掉跟单账本，stopCopy 加上对剩余敞口的一个决定，比在每个仓位上迭代 closePos 更划算——而且当简单的循环因速率限制错误而卡住时，它仍然可以响应。

跟单交易风险参数及其真实范围

POST /capi/v3/copy/follower/settings 接受跨交易对列表的 unified 配置或 per_symbol 数组。以下是实际接受的值——这些数字决定了您的配置请求是否成功：

其中两个参数会造成资金损失。slippageRatio: 0 看起来像是表中安全的值，实际上却是最危险的：它完全禁用了滑点上限，因此跟单订单会在信号到达时以账本提供的任何价格成交。如果您想要保护，范围是 0.001 到 0.01（0.1% 到 1%），并且您必须明确说明。

第二个是隐藏在允许值注释中的设计权衡：在 per_symbol 模式下，marginType 仅接受 trader。选择细粒度的每交易对控制，您将继承带单交易员在所有交易对上的保证金模式。如果您想在一个波动较大的交易对上使用逐仓，而带单交易员使用全仓，per_symbol 无法表达——unified 可以。大多数集成倾向于使用 per_symbol，因为它听起来更精确，但为了达到这一目的却放弃了保证金模式的控制权。

还有一个会困扰任何构建读-改-写循环的人的问题：此路径上的 GET 和 POST 不共享字段名称。读取设置返回 settingMode、maxHoldSize 和 takeProfitRatio；写入它们需要 settingType、maxHoldQty 和 stopProfitRatio。GET 还需要一个 traderId 并返回一个数组——unified 为一项，per_symbol 则为每个交易对一项。将响应对象直接回传到 POST 中将导致参数验证失败，因此请明确映射字段，而不是假设对称性。

跟单交易 API 支持哪些交易对，以及为什么不应该硬编码它们

GET /capi/v3/copy/trader/pairs 在 2026 年 7 月 30 日检查时返回了 124 个交易对，全部为 USDT 本位——从 BTCUSDT 和 ETHUSDT 到 ASTERUSDT、PUMPUSDT 和 STBLUSDT 等较新的上市币种。没有币本位合约，没有现货。

此列表会变动，发布材料中流传的静态版本已经过时。WEEX 跟单交易 API 手册中的静态交易对表包含 74 个代码；与 2026 年 7 月 30 日的实时端点核对，STXUSDT 和 IPUSDT 在该表中但未出现在 API 响应中，而 BTCUSDT、XRPUSDT 和 DOGEUSDT 是活跃的但未出现在表中。如果您从文档中构建白名单，您的机器人将拒绝比特币，同时接受两个不再跟单的交易对。

请改为轮询该端点。它的权重为 1——是整个跟单交易接口中最便宜的调用——且无需身份验证，因此除了交易会话外没有理由缓存它。在启用交易对之前，请检查合约本身：BTC/USDT 永续合约页面 显示了您的跟单仓位将结算的实时标记价格、资金费率和倒计时。

会导致首次集成失败的五个错误代码

50xx 代码块是跟单交易特有的，也是移植代码容易失败的地方：

-5003 和 -5004 是真正的移植隐患。通过部分止盈缩减仓位，或设置限价止盈的策略代码，在常规合约密钥上运行良好，但在使用跟单密钥的每次调用中都会失败。跟单止盈止损是全有或全无且仅限市价的，因为部分或限价退出无法在持仓大小不同的跟单者之间连贯地镜像。请围绕该约束规划退出逻辑，而不是在实时会话中才发现它。

此外，还要为 -1046（时间戳过期——同步您的时钟，不要盲目重试）、-1056（ILLEGAL_IP，意味着请求来自您的白名单之外）和 -1059（HIGH_FREQUENCY_ORDER_LIMITED，与权重预算分开的订单突发限制，很容易因聊天信号生成器而触发）做好预算。-5000 完善了 50xx 代码块，只是告诉您联系 WEEX。

WEEX 跟单交易 API 与 Binance 和 Bybit 的对比

“跟单交易 API”的含义因平台而异，在假设可移植性之前，差异值得核实：

整个行业的模式是交易所暴露带单交易员端，而将跟单者端保留在应用程序内。WEEX 发布跟单者端写入端点是意义重大的差异：这意味着第三方工具、投资组合仪表板或风险覆盖层可以以编程方式调整或终止跟单关系，而无需屏幕抓取。如果您正在构建面向跟单者的工具而不是带单交易员策略，这就是决定性功能，这也是为什么跟单 API 对集成商的价值比“我们有一个跟单交易 API”这一标题所暗示的要高。

参数细节在如此新的接口上可能会在没有太多预告的情况下更改，因此请将 官方跟单交易 API 参考 作为事实来源，并在每次发布前将其与您的集成进行差异对比。

下一步该做什么

WEEX 跟单交易 API 是一个小型、有主见的接口：10 个从合约 API 复用的订单端路径、3 个带单交易员读取端点、7 个跟单者端点、每个交易员一个密钥，以及一个编码了其大部分约束的 50xx 错误块。在您的第一个实时信号之前，需要做对的三件事是交易对列表（轮询它，不要硬编码它）、slippageRatio（除非您指的是无限制，否则永远不要将其保留为 0）以及全仓市价止盈止损。其他一切都是标准的 WEEX 合约集成。

如果您想带单而不是集成，跟单交易 API 仅在精英交易员审核通过后才可用——请先从 WEEX 跟单交易中心 开始，在自动化之前查看产品在 UI 中的行为，因为 API 镜像了这些语义而不是替换它们。

常见问题解答

1. 谁可以使用 WEEX 跟单交易 API？

只有被批准为 WEEX 精英交易员的账户才能创建跟单交易 API 密钥并以编程方式下达跟单订单。跟单者不需要特殊密钥——他们使用常规 API 密钥配置和控制跟单。

2. 我可以创建多少个跟单交易 API 密钥？

每个交易员账户一个。没有第二个密钥用于轮换，因此请将凭证更改计划为预定的维护窗口。

3. WEEX 跟单交易 API 支持现货交易吗？

不支持。它仅限合约，且仅适用于跟单交易白名单上的交易对——截至 2026 年 7 月 30 日为 124 个 USDT 本位交易对。现货调用和非白名单交易对将被拒绝。

4. 跟单者可以通过 API 更改跟单设置吗？

可以。POST /capi/v3/copy/follower/settings 写入跟单配置，包括仓位模式、最大持仓数量、止盈止损比率、滑点上限、保证金类型和杠杆。跟单者还可以调用 closePos 和 stopCopy。

5. 为什么我的止盈订单在使用跟单交易 API 密钥时失败？

几乎可以肯定是 -5003 或 -5004。跟单密钥仅接受全仓止盈止损（quantity 必须为 0），并按市价执行（executePrice 必须为 null 或 0）。部分或限价退出将被拒绝。

6. 跟单交易 API 的速率限制是多少？

跟单端点按 IP 加权，每个 IP 受限端点都有每 10 秒 500 的独立预算。权重不同——closePos 为 50，而大多数其他端点为 10，因此每 10 秒大约分别对应 10 次和 50 次调用。超出限制将返回 429，且 -1059 是对订单突发的单独限流。

7. 跟单交易资金与我的常规合约账户分开吗？

是的。资金、持仓和风险比率是完全隔离的，因此两个账户无法互相强平。请注意，/capi/v3/account/position/allPosition 返回与您签名的密钥相匹配的账户。

风险提示

加密资产波动剧烈，交易它们可能导致部分或全部资本损失。WEEX 跟单交易 API 增加了超出普通合约交易的风险。跟单仓位的杠杆默认为 10 倍，且可以设置得更高，这压缩了强平所需的波动空间。将 slippageRatio 设置为 0 会完全移除滑点上限，因此在波动条件下，跟单订单可能会在远离带单交易员价格的位置成交。作为跟单者，您面临来自带单交易员的对手方和行为风险，其策略可能会在没有通知的情况下更改，且其过往业绩不能预测未来表现；作为带单交易员，不断增加的 followCount 可能会通过市场影响恶化您自己的成交。自动化系统增加了操作风险：过时的交易对白名单、过期的时间戳、速率限制封禁或未处理的错误代码可能会导致仓位在没有主动管理的情况下保持开启。单密钥限制意味着受损或轮换的凭证会让您没有后备路径。跟单交易并不能消除对您能够承受损失的仓位大小的需求。此处内容不构成投资建议——在部署资金前，请根据当前的 WEEX API 文档验证所有参数，并确认该服务在您的司法管辖区内可用。