错误码与频率限制 (Errors & Rate Limits)
错误码说明
ZTDX API 使用标准的 HTTP 状态码来表示请求的结果。
| 状态码 | 含义 | 详细描述 |
|---|---|---|
| 200 | OK | 请求成功。 |
| 400 | Bad Request | 请求参数错误或业务逻辑违规（如余额不足）。 |
| 401 | Unauthorized | 身份验证失败，请检查签名或时间戳。 |
| 403 | Forbidden | 无权限访问该资源。 |
| 404 | Not Found | 请求的资源不存在。 |
| 429 | Too Many Requests | 触发频率限制，请降低请求频率。 |
| 500 | Internal 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: 下单数量低于市场规范要求的最小起投量。