通用信息

本页涵盖了适用于所有 BigONE API 端点的通用信息。

频率限制 (Rate Limits)

为了确保服务稳定性，BigONE 对 API 请求实施频率限制。

默认限制

类型	限制
HTTP 请求	500 次请求 / 10 秒 / IP
WebSocket 连接	5 个连接 / 用户

超出频率限制

如果超出频率限制，您将收到 429 Too Many Requests 响应。请在您的应用程序中实现指数退避 (exponential backoff) 策略以妥善处理此问题。

最佳实践

1. 缓存公共数据 — 像 Ticker 和订单簿这样的市场数据可以缓存几秒钟
2. 使用 WebSocket — 对于实时数据，请使用 WebSocket 而不是轮询 REST 端点
3. 批量请求 — 尽可能使用批量端点（例如：批量下单）
4. 实现退避策略 — 如果被限频，请在重试之前等待

HTTP 状态码

BigONE API 遵循 RFC HTTP 标准。

代码	描述
200	OK — 请求成功
400	Bad Request — 参数无效
401	Unauthorized — 认证失败
403	Forbidden — 权限不足
404	Not Found — 资源不存在
429	Too Many Requests — 超出频率限制
500	Internal Server Error — 服务器端错误
503	Service Unavailable — 服务暂时不可用

响应格式

所有 API 响应都遵循一致的 JSON 结构。

成功响应

{
  "code": 0,
  "data": {
    // 响应数据
  }
}

分页响应

对于返回列表的端点，分页通过 page_token 处理：

{
  "code": 0,
  "data": [
    // 项目列表
  ],
  "page_token": "dxvf..."
}

要获取下一页，请在下次请求中将 page_token 作为查询参数包含在内。

错误响应

{
  "code": 40004,
  "message": "Unauthorized"
}

code 字段包含错误代码（非零表示错误），message 提供描述。

时间戳

• 除非另有说明，API 中的所有时间戳均为自 UNIX 纪元以来的 毫秒数
• JWT Token 中的 nonce 字段使用 纳秒数
• 服务器时间可以通过 /ping 端点获取

精度

• 价格和数量以 字符串 形式返回以保持精度
• 处理加密货币金额时，请始终使用十进制库（不要使用浮点数）
• 每个交易对都有特定的精度要求 — 请查看 asset pair info 端点

请求头 (Request Headers)

私有 API 必需的请求头

请求头	值
Authorization	Bearer <JWT_TOKEN>
Content-Type	application/json (用于 POST/PUT 请求)

可选请求头

请求头	描述
Accept-Language	错误信息的首选语言 (en, zh-Hans)

下一步

• 错误代码 — 所有错误代码的完整参考
• API 参考 — 开始探索 API 端点