跳到主要内容

错误码与频率限制 (Errors & Rate Limits)

错误码说明​

ZTDX API 使用标准的 HTTP 状态码来表示请求的结果。

状态码含义详细描述
200OK请求成功。
400Bad Request请求参数错误或业务逻辑违规（如余额不足）。
401Unauthorized身份验证失败，请检查签名或时间戳。
403Forbidden无权限访问该资源。
404Not Found请求的资源不存在。
429Too Many Requests触发频率限制，请降低请求频率。
500Internal Error服务器内部错误，请稍后重试。

频率限制 (Rate Limits)​

为了保证系统的稳定性，我们对不同类型的请求实施了频率限制。

REST API 限制​

限制通常基于 IP 地址和用户 UID。

  • 公共接口: 20 次/秒 (每 IP)
  • 私有接口: 50 次/秒 (每 UID)
  • 订单创建: 10 次/秒 (每 UID)

WebSocket 限制​

  • 订阅数量: 每个连接最多支持 200 个订阅。
  • 连接速率: 每秒最多允许 5 个新的连接请求。

常见错误排查​

401 Unauthorized​

  • 检查 timestamp 是否与服务器时间同步（允许误差 ±30s）。
  • 确保 signature 按照身份验证中的流程生成。
  • 验证使用的私钥是否与 address 匹配。

400 Bad Request​

  • Insufficient Balance: 账户余额不足以支付下单金额或保证金。
  • Invalid Limit Price: 价格超过了该交易对允许的涨跌幅限制。
  • Min Amount Not Met: 下单数量低于市场规范要求的最小起投量。