跳到主要内容

基本信息

Rest 基本信息​

  • 部分接口可能需要用户的 API Key，如何创建API-KEY请参考这里
  • 本篇列出REST接口的baseurl https://api.prex.world
  • 所有接口的响应都是JSON格式
  • 响应中如有数组，数组元素以时间升序排列，越早的数据越提前。
  • 所有时间、时间戳均为UNIX时间，单位为毫秒，除非某字段明确注明单位为秒。
  • 所有数据类型采用JAVA的数据类型定义

Testnet API 信息​

  • 本篇接口亦可接入testnet测试平台使用
  • testnet的 REST baseurl 为 https://api.prex.world
  • testnet的 Websocket baseurl 为 wss://api.prex.world/ws

接口的基本信息​

  • GET方法的接口, 参数必须在query string中发送。
  • POST, PUT, 和 DELETE 方法的接口, 参数必须以 JSON 形式在 request body 中发送（Content-Type: application/json）。不支持表单编码请求体（application/x-www-form-urlencoded），query string 参数与 body 参数不能混用或合并。鉴权参数（timestamp、signature）是例外: 它们始终放在 query string 中。
  • 对参数的顺序不做要求。

时间戳与 recvWindow​

  • 签名请求必须携带 timestamp 参数（UNIX 毫秒时间）。
  • 服务端强制执行相对服务器时间固定的双向 ±60,000 毫秒窗口。recvWindow 参数会被接受但被忽略 — 它不会改变窗口大小。
  • 时间戳超出窗口的请求会在鉴权阶段被拒绝，返回 HTTP 401 及错误码 SIGNATURE_INVALID（见错误代码）。

访问限制​

  • 应用层不执行按接口的频率限制或请求权重。流量整形由前置的 nginx 层处理。
  • 不存在 429/418 封禁机制，也没有 X-MBX-USED-WEIGHT-* 响应头。
  • GET /fapi/v1/exchangeInfo 返回的 rateLimits 数组是为 SDK 兼容而保留的静态展示值，不反映实际执行的限制。

HTTP 返回代码​

  • HTTP 4XX 错误码用于指示错误的请求内容、行为、格式。
  • HTTP 401 表示鉴权失败（API key 无效、签名无效、或时间戳超出窗口）。
  • HTTP 403 表示客户端 IP 不在该 API key 的 IP 白名单中。
  • HTTP 404 可能在请求的资源（如某订单）不存在时返回。
  • HTTP 5XX 错误码用于指示服务器内部错误；可稍后重试请求。

接口错误代码​

每个接口都有可能抛出异常。 异常响应格式如下：

{
  "code": -1121,
  "msg": "Invalid symbol: XYZUSDT"
}

具体的错误码及其解释在错误代码