FAQs
更新时间： 2026-03-31
文档摘要： 本指南旨在协助开发者快速接入 WEEX API，解决权限配置、频率限制及交易过程中的常见技术问题。
1. 账号与权限配置
为什么我的 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. 常见技术问题 (Q&A)
Q1: 为什么下单返回 -1052 (Insufficient permissions)？
答： 该错误通常由以下原因引起：
- 权限勾选： 未在 API 管理页面勾选对应的“合约”或“现货”交易权限。
- 交易对不支持： 部分代币（如 TIA 等新币）目前暂不支持 API 下单。
- 接口版本： 建议优先使用 V3 接口，V1/V2 将下架。
Q2: 为什么 WebSocket 连接返回 403 错误？
答： 建立 WebSocket 连接时，必须在 Header 中包含 User-Agent 信息（内容可自定义）。若缺少该字段，请求将被防火墙拦截。
Q3: 如何获取全部可交易的 Symbol（币对）？
答：
现货 (Spot)： 访问 获取现货交易对接口。
合约 (Futures)： 访问 获取合约交易对接口 。
4: WEEX 是否提供 API 测试网 (Testnet)？
答： 目前 WEEX 不提供 独立的 API 测试环境。网页端的“演示交易 (Demo Trading)”目前也不支持 API 接入。建议在正式环境使用极小额资金进行逻辑调试。
4. 更多支持
如果您在开发过程中遇到无法解决的技术难题，可以通过以下渠道获取支持：
- 官方 API 文档： WEEX API Documentation
- 技术对接： 请联系您的客户经理，申请进入专属 WEEX API 技术对接群。
提示
- API 交易涉及高风险，请务必在代码中做好完善的错误处理逻辑。
- 严禁将 API Key 和 Secret Key 泄露给第三方。
- 本文档内容可能随系统升级而调整，请以最新的官方 API 文档为准。