跳到主要内容
版本：V3(BETA)

FAQs

更新时间： 2026-04-14
文档摘要： 本指南旨在协助开发者快速接入 WEEX 现货 API，解决权限配置、频率限制及交易过程中的常见技术问题。

1. 账号与权限配置​

API Key 权限类型说明​

在创建 API Key 时，请根据您的业务需求勾选对应的权限选项：

权限名称描述适用场景
Readonly只读权限。仅允许调用查询类接口（如获取余额、成交历史）。无法进行任何交易操作。资产监控、账单同步、行情分析。
Spot现货交易权限。仅允许在现货市场进行下单、撤单及查询现货资产。现货量化机器人、自动化补仓。

注：权限相互独立，如需进行现货交易操作，请确保已勾选 Spot 权限。

为什么我的 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)？​

答： 该错误通常由以下原因引起：

  1. 权限勾选： 未在 API 管理页面勾选“现货”交易权限。
  2. 交易对不支持： 部分代币目前暂不支持 API 下单。
  3. 接口版本： 建议优先使用 V3 接口，V1/V2 将下架。

Q2: 为什么 WebSocket 连接返回 403 错误？​

答： 建立 WebSocket 连接时，必须在 Header 中包含 User-Agent 信息（内容可自定义）。若缺少该字段，请求将被防火墙拦截。

Q3: 撤单返回 -1054？​

答： 订单不存在。通常是撤单时提供的单号错误。

Q4: 如何获取全部可交易的 Symbol（币对）？​

答： 访问 获取现货交易对接口。

Q5: 支持 TradingView 或 FIX API 吗？​

答： 目前均不支持。

4. 常见问题​

  • Q1：如何获取API相关问题的技术支持？

    A : 可以加入官方API技术支持群来反馈API问题，管理员会答复您。https://t.me/+7jac6zttXxZjOTRl

  • Q2：下单时，我应该传 BTCUSDT_SPBL 还是 BTCUSDT？

    A : 下单接口的所有 symbol 参数应使用/products接口返回的值。

  • Q3：API接口的限频规则是什么？

    A : 1. 各api端口频率限制规则在文档有标注；2. 各API接口的限频互相独立计算；

  • Q4：API 接口中的 symbol 是否区分大小写？

    A : symbol 区分大小写，必须全部使用大写。

  • Q5：如果我忘记了API key的passphrase怎么办？

    A : API key的passphrase不支持更改。需要您重新创建API key。

5. 更多支持 (Technical Support)​

如果您在开发过程中遇到无法解决的技术难题，可以通过以下渠道获取支持：

开发者提示
  1. API 交易涉及高风险，请务必在代码中做好完善的错误处理逻辑。
  2. 严禁将 API Key 和 Secret Key 泄露给第三方。
  3. 本文档内容可能随系统升级而调整，请以最新的官方 API 文档为准。