跳到主要内容

概览

Rest 基本信息​

  • 現貨接口的baseurl: https://api.binance.com
  • 合約接口的baseurl: https://fapi.binance.com
  • 所有接口的响应都是JSON格式
  • 响应中如有数组，数组元素以时间升序排列，越早的数据越提前。
  • 所有时间、时间戳均为UNIX时间，单位为毫秒
  • HTTP 4XX 错误码用于指示错误的请求内容、行为、格式。
  • HTTP 403 错误码表示违反WAF限制(Web应用程序防火墙)。
  • HTTP 429 错误码表示警告访问频次超限，即将被封IP
  • HTTP 418 表示收到429后继续访问，于是被封了。
  • HTTP 5XX 错误码用于指示Binance服务侧的问题。
  • HTTP 504 表示API服务端已经向业务核心提交了请求但未能获取响应，特别需要注意的是504代码不代表请求失败，而是未知。很可能已经得到了执行，也有可能执行失败，需要做进一步确认。
  • 每个接口都有可能抛出异常，异常响应格式如下：
{
  "code": -1121,
  "msg": "Invalid symbol."
}
  • GET方法的接口, 参数必须在query string中发送.
  • POST, PUT, 和 DELETE 方法的接口, 参数可以在 query string中发送，也可以在 request body中发送(content type application/x-www-form-urlencoded)。允许混合这两种方式发送参数。但如果同一个参数名在query string和request body中都有，query string中的会被优先采用。
  • 对参数的顺序不做要求。

IP 访问限制​

  • 每个请求将包含一个X-MBX-USED-WEIGHT-(intervalNum)(intervalLetter)的头，其中包含当前IP所有请求的已使用权重。
  • 每个路由都有一个“权重”，该权重确定每个接口计数的请求数。较重的接口和对多个交易对进行操作的接口将具有较重的“权重”。
  • 收到429时，您有责任作为API退回而不向其发送更多的请求。
  • 如果屡次违反速率限制和/或在收到429后未能退回，将导致API的IP被禁（http状态418）。
  • 频繁违反限制，封禁时间会逐渐延长 ，对于重复违反者，将会被封从2分钟到3天。
  • 访问限制是基于IP的，而不是API Key

接口鉴权类型​

  • 每个接口都有自己的鉴权类型，鉴权类型决定了访问时应当进行何种鉴权。
  • 如果需要 API-keys，应当在HTTP头中以 X-MBX-APIKEY字段传递。
  • API-keys 与 secret-keys 是大小写敏感的。
  • API-keys可以被配置为只拥有访问一些接口的权限。 例如, 一个 API-key 仅可用于发送交易指令, 而另一个 API-key 则可访问除交易指令外的所有路径。
  • 默认 API-keys 可访问所有鉴权路径.
鉴权类型描述
TRADE需要有效的 API-Key 和签名
USER_DATA需要有效的 API-Key 和签名

备注说明​

请求参数​

Email地址​

  • Email地址作为请求参数，需要转译(encode)。比如 alice@test.com 转换成 alice%40test.com
  • Email地址作为请求参数，应为小写。