跳到主要内容
版本：V3(BETA)

签名

ACCESS-SIGN的请求头是对 timestamp + method.toUpperCase() + requestPath + "?" + queryString + body 字符串(+表示字符串连接)使用 HMAC SHA256 方法加密，通过BASE64 编码输出而得到的。

时间戳

请求签名中的 ACCESS-TIMESTAMP 单位是毫秒。请求时间戳必须在 API 服务时间的 30 秒内，否则请求将被视为过期并被拒绝。如果本地服务器时间和 API 服务器时间之间存在较大偏差，建议通过查询 API 服务器时间来更新 HTTP Header。

请求格式

当前支持以下请求方法：

  • GET：参数通过 queryString 在路径中传输到服务器。
  • POST：参数按照 JSON 格式通过 body 传输到服务器。
  • DELETE：参数按照接口说明通过 queryString 或 JSON body 传输到服务器。

参与签名时，请按照实际请求内容拼接 requestPath、queryString 和 body。

签名各字段说明

  • timestamp：与 ACCESS-TIMESTAMP 请求头相同。
  • method：请求方法（GET/POST/DELETE），字母全部大写。
  • requestPath：请求接口路径。
  • queryString：请求URL中(?后的请求参数)的查询字符串。
  • body：请求主体对应的字符串，如果请求没有主体则 body 可省略。

queryString为空时，签名格式

  • timestamp + method.toUpperCase() + requestPath + body

queryString不为空时，签名格式

  • timestamp + method.toUpperCase() + requestPath + "?" + queryString + body

举例说明

获取深度信息，以 btcusdt 为例:

  • Timestamp = 1591089508404
  • Method = "GET"
  • requestPath = "/api/v3/market/depth"
  • queryString= "symbol=BTCUSDT&limit=20"

生成待签名的字符串:

  • '1591089508404GET/api/v3/market/depth?symbol=BTCUSDT&limit=20'

下单，以 btcusdt 为例:

  • Timestamp = 1561022985382

  • Method = "POST"

  • requestPath = "/api/v3/order"

  • body =

    {"symbol":"BTCUSDT","side":"BUY","type":"LIMIT","timeInForce":"GTC","quantity":"1","price":"68900","newClientOrderId":"my-order-001"}

生成待签名的字符串:

  • '1561022985382POST/api/v3/order{"symbol":"BTCUSDT","side":"BUY","type":"LIMIT","timeInForce":"GTC","quantity":"1","price":"68900","newClientOrderId":"my-order-001"}'

生成最终签名的步骤

  1. 将待签名字符串使用私钥secretkey进行hmac sha256加密
    • Signature = hmac_sha256(secretkey, Message)
  2. 对于Signature进行base64编码
    • Signature = base64.encode(Signature)