FAQs
更新时间： 2026-04-14
文档摘要： 本指南旨在协助开发者快速接入 WEEX API，解决权限配置、频率限制及交易过程中的常见技术问题。
1. 账号与权限配置
API Key 权限类型说明
在创建 API Key 时，请根据您的业务需求勾选对应的权限选项：
| 权限名称 | 描述 | 适用场景 |
|---|---|---|
| Readonly | 只读权限。仅允许调用查询类接口（如获取余额、持仓、成交历史）。无法进行任何交易操作。 | 资产监控、账单同步、行情分析。 |
| Spot | 现货交易权限。仅允许在现货市场进行下单、撤单及查询现货资产。 | 现货量化机器人、自动化补仓。 |
| Futures | 合约交易权限。仅允许在合约（U本位/币本位）市场开平仓、设置止盈止损及查询合约仓位。 | 合约对冲、高频合约策略。 |
注：三种权限相互独立，如需同时操作现货与合约，请确保同时勾选或创建多个 Key 隔离使用。
为什么我的 API 权限被禁用或报错 API Restricted？
- 风控触发： 若账户触发平台安全风控（如异常登录、高频无效请求），API 权限可能被自动禁用。
- 解禁流程： 请联系客服。
- 生效时间： 新创建或修改权限后的 API Key，通常需要 15 分钟 左右在系统全局生效。
创建 API Key 时的安全建议
- Passphrase (口令)： 设置 API Passphrase 时 不可包含特殊符号（仅限字母+数字）。
- IP 白名单： 建议开启 IP 白名单以增强安全性。
2. 频率限制 (Rate Limits)
WEEX 对不同类型的接口设有严格的权重限制，以确保系统稳定性。若超过限制，系统将返回 HTTP 429 错误。
| 业务类型 | 操作类型 | 频率限制 |
|---|---|---|
| 现货交易 | 撤单 (Cancel) | 10秒 80次 / 1分钟 200次 |
| 现货交易 | 下单 (Order) | 100次 / 分钟 |
| 网络连接 | REST/WS 连接 | 300次 / 5分钟 / 每IP |
| WebSocket | 频道订阅 | 240次 / 小时 / 每连接 |
3. 接口规则调整 (2026/04)
官方已完善 V3 代理/返佣接口 的时间范围校验逻辑，请开发者及时调整代码：
涉及接口：
具体规则：
- 查询范围：
startTime必须在最近 365 天 内。 - 跨度限制： 单次查询的时间跨度（Start 到 End）最大为 90 天。
- 默认逻辑： 若不传参数，系统默认查询最近 90 天 的数据。
4. 模拟下单接口 (NEW: Paper Trading)
为了方便开发者进行策略调试及对冲模式测试，WEEX 已正式上线 模拟下单接口。您可以在不消耗真实资产的情况下，全面模拟交易流程。
新增 Demo 接口列表：
- 获取账户余额：查看账户模拟资金 (SUSDT)。
GET /capi/v3/sim/balance - 获取全部持仓：支持查看多空双向（对冲模式）持仓。
GET /capi/v3/sim/position/allPosition - 下单接口：支持市价、限价等多种下单指令。
POST /capi/v3/sim/order - 获取历史订单：追踪及分析历史模拟交易记录。
GET /capi/v3/sim/order/history
5. 常见技术问题 (Q&A)
Q1: 为什么下单返回 -1052 (Insufficient permissions)？
答： 该错误通常由以下原因引起：
- 权限勾选： 未在 API 管理页面勾选对应的“合约”或“现货”交易权限。
- 交易对不支持： 部分代币（如 TIA 等新币）目前暂不支持 API 下单。
- 接口版本： 建议优先使用 V3 接口，V1/V2 将下架。
Q2: 为什么 WebSocket 连接返回 403 错误？
答： 建立 WebSocket 连接时，必须在 Header 中包含 User-Agent 信息（内容可自定义）。若缺少该字段，请求将被防火墙拦截。
Q3:撤单返回 -1054？
答： 订单不存在。通常是撤单时提供的单号错误。
Q4: 如何获取全部可交易的 Symbol（币对）？
答：
现货 (Spot)： 访问 获取现货交易对接口。
合约 (Futures)： 访问 获取合约交易对接口 。
Q5: 请求返回 404？
答： 检查路径。例如获取所有仓位应使用 GET /capi/v3/account/position/allPosition。
Q6: 更改杠杆会触发 WebSocket 推送吗？
答： 会。仅下单、平仓和调整保证金会触发更新。
Q7: 支持 TradingView 或 FIX API 吗？
答： 目前均不支持。
6. 更多支持 (Technical Support)
如果您在开发过程中遇到无法解决的技术难题，可以通过以下渠道获取支持：
- 官方 API 文档： WEEX API Documentation
- Telegram 技术对接群：
开发者提示
- API 交易涉及高风险，请务必在代码中做好完善的错误处理逻辑。
- 严禁将 API Key 和 Secret Key 泄露给第三方。
- 本文档内容可能随系统升级而调整，请以最新的官方 API 文档为准。