更新日志

2023-10-19

币安期权在进行Websocket服务升级，升级影响以下逻辑：

• 升级前：

  • 服务端每5分钟会发送ping帧，客户端应当在15分钟内回复pong帧，否则服务端会主动断开链接。允许客户端发送不成对的pong帧(即客户端可以以高于15分钟每次的频率发送pong帧保持链接)
    
  • 无信息流订阅连接Websocket服务：
  • 升级前， 用户可以用以下方式连接:
    • wss://nbstream.binance.com/eoptions/ws
    • wss://nbstream.binance.com/eoptions/stream
    • wss://nbstream.binance.com/eoptions/ws/
      
    • wss://nbstream.binance.com/eoptions/stream/

• 升级后

  • 服务端每3分钟会发送ping帧，客户端应当在10分钟内回复pong帧，否则服务端会主动断开链接。允许客户端发送不成对的pong帧(即客户端可以以高于10分钟每次的频率发送pong帧保持链接)
    
  • 无信息流订阅连接Websocket服务：
  • 升级后，用户可以用以下方式连接:
    • wss://nbstream.binance.com/eoptions/ws
      
    • wss://nbstream.binance.com/eoptions/stream
    • / 在url结尾不再支持
  • 带信息流订阅连接Websocket服务:
    • 不支持如下类型的stream:wss://nbstream.binance.com/eoptions/illegal_parameter/stream?steams=<streamName>或wss://nbstream.binance.com/eoptions/illegal_parameter/ws/<streamName>，请移除 /ws 和 /stream前的illegal_parameter/
      

---

2023-08-29

REST

• GET /eapi/v1/account: 新增字段riskLevel显示账户风险等级
• GET /eapi/v1/marginAccount: 新增字段riskLevel显示账户风险等级

Websocket用户信息流

• 新增更新时间RISK_LEVEL_CHANGE以显示账户风险等级变化

---

2023-07-21

REST

• 新增接口GET /eapi/v1/income/asyn 获取期权流水历史下载id
• 新增接口GET /eapi/v1/income/asyn/id 通过下载id获取期权流水历史下载链接

---

2023-07-13

Websocket Market Streams

• 下面更新将在2023-7-14生效：
  • 在数据流<symbol>@ticker, <underlyingAsset>@ticker@<expirationDate>新增参数T显示交易时间
  • 在数据流<symbol>@depth<levels>新增参数E显示事件时间

---

2023-05-30

General Information on Endpoints

• GET方法的接口, 参数必须在query string中发送且HTTP头中不设置content type.

---

2023-02-02

REST

• 接口POST /eapi/v1/transfer不再使用.

---

2023-01-11

REST

• 增加GET /eapi/v1/order以查询单个订单状态

---

2022-12-13

WEBSOCKET

• 在<symbol>@depth1000中新增字段u和pu以获取增量orderbook更新

---

2022-12-09

REST

• 在GET /eapi/v1/depth中新增更新id字段u
• 在GET /eapi/v1/exerciseHistory中增加入参underlying

---

2022-11-18

REST

• 新增接口GET /eapi/v1/openInterest用来获取特定标的资产特定到期日的期权持仓量

WEBSOCKET

• 增加数据流<underlyingAsset>@openInterest@<expirationDate>用来获取特定标的资产期权持仓量

---

2022-11-16

WEBSOCKET

• 增加交易数据流<underlyingAsset>@trade用来获取特定标的资产的所有期权交易
• 调整数据流option_pair输出格式

---

2022-11-03

REST

• 将于2022-11-07日新增做市商倒计时自动取消接口:
  • POST /eapi/v1/countdownCancelAll：设置倒计时取消所有订单配置
  • GET /eapi/v1/countdownCancelAll：获得倒计时自动取消所有订单配置
  • POST /eapi/v1/countdownCancelAllHeartBeat：重置倒计时取消所有订单心跳

---

2022-09-20

WEBSOCKET

• 新增数据流 <underlyingAsset>@markPrice 和 <underlyingAsset>@ticker@<expirationDate>
• 数据流 <!miniTicker@arr> 将于2022/10/30弃用

---

2022-09-14

REST

• 修改GET /eapi/v1/exchangeInfo中strikePrice,makerFeeRate,takerFeeRate,minQty,maxQty,initialMargin,maintenanceMargin,minInitialMargin,minMaintenanceMargin为string
• GET /eapi/v1/historyOrders中仅保留最近5天订单

---

2022-09-05

REST

• 修改DELETE /eapi/v1/allOpenOrdersByUnderlying中response的格式

---

2022-08-22

REST

• GET /eapi/v1/exchangeInfo中新增 rateLimits 信息 in endpoint
• GET /eapi/v1/userTrades中参数 symbol 改为非必传

---

基本信息

Rest 基本信息

• 接口可能需要用户的 API Key，如何创建API-KEY请参考这里
• 本篇列出REST接口的baseurl https://eapi.binance.com
• 所有接口的响应都是JSON格式
• 响应中如有数组，数组元素以时间升序排列，越早的数据越提前。
• 所有时间、时间戳均为UNIX时间，单位为毫秒

HTTP 返回代码

• HTTP 4XX 错误码用于指示错误的请求内容、行为、格式。
• HTTP 403 错误码表示违反WAF限制(Web应用程序防火墙)。
• HTTP 429 错误码表示警告访问频次超限，即将被封IP
• HTTP 418 表示收到429后继续访问，于是被封了。
• HTTP 5XX 错误码用于指示Binance服务侧的问题。
  
• HTTP 503 表示三种可能：
  1. 如果返回内容里包含了报错信息 "Unknown error, please check your request or try again later."，则表示API服务端已经向业务核心提交了请求但未能获取响应，特别需要注意的是其不代表请求失败，而是未知。很可能已经得到了执行，也有可能执行失败，需要做进一步确认。
  2. 如果返回内容里包含了报错信息 "Service Unavailable."，则表示本次API请求失败。这种情况下可能是服务暂不可用，您需要稍后重试。
  3. 如果返回内容里包含了报错信息 "Internal error; unable to process your request. Please try again."，则表示本次API请求失败。这种情况下您如果需要的话可以选择立即重试。

接口错误代码

• 每个接口都有可能抛出异常

异常响应格式如下：

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

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

接口的基本信息

• GET方法的接口, 参数必须在query string中发送且HTTP头中不设置content type.
• POST, PUT, 和 DELETE 方法的接口, 参数可以在 query string中发送，也可以在 request body中发送(content type application/x-www-form-urlencoded)。允许混合这两种方式发送参数。但如果同一个参数名在query string和request body中都有，query string中的会被优先采用。
• 对参数的顺序不做要求。

访问限制

• 在 /eapi/v1/exchangeInfo接口中rateLimits数组里包含有REST接口(不限于本篇的REST接口)的访问限制。包括带权重的访问频次限制、下单速率限制。本篇枚举定义章节有限制类型的进一步说明。
• 违反上述任何一个访问限制都会收到HTTP 429，这是一个警告.

IP 访问限制

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

下单频率限制

• 每个下单请求回报将包含一个X-MBX-ORDER-COUNT-(intervalNum)(intervalLetter)的头，其中包含当前账户已用的下单限制数量。
• 被拒绝或不成功的下单并不保证回报中包含以上头内容。
• 下单频率限制是基于每个账户计数的。

接口鉴权类型

• 每个接口都有自己的鉴权类型，鉴权类型决定了访问时应当进行何种鉴权
• 如果需要 API-key，应当在HTTP头中以X-MBX-APIKEY字段传递
• API-key 与 API-secret 是大小写敏感的
• 可以在网页用户中心修改API-key 所具有的权限，例如读取账户信息、发送交易指令、发送提现指令

鉴权类型	描述
NONE	不需要鉴权的接口
TRADE	需要有效的API-KEY和签名
USER_DATA	需要有效的API-KEY和签名
USER_STREAM	需要有效的API-KEY
MARKET_DATA	需要有效的API-KEY

需要签名的接口 (TRADE 与 USER_DATA)

• 调用这些接口时，除了接口本身所需的参数外，还需要传递signature即签名参数。
• 签名使用HMAC SHA256算法. API-KEY所对应的API-Secret作为 HMAC SHA256 的密钥，其他所有参数作为HMAC SHA256的操作对象，得到的输出即为签名。
• 签名大小写不敏感。
• 当同时使用query string和request body时，HMAC SHA256的输入query string在前，request body在后

时间同步安全

• 签名接口均需要传递timestamp参数, 其值应当是请求发送时刻的unix时间戳(毫秒)
• 服务器收到请求时会判断请求中的时间戳，如果是5000毫秒之前发出的，则请求会被认为无效。这个时间窗口值可以通过发送可选参数recvWindow来自定义。
• 另外，如果服务器计算得出客户端时间戳在服务器时间的‘未来’一秒以上，也会拒绝请求。

逻辑伪代码：

  if (timestamp < (serverTime + 1000) && (serverTime - timestamp) <= recvWindow) {
    // process request
  } else {
    // reject request
  }

关于交易时效性 互联网状况并不100%可靠，不可完全依赖,因此你的程序本地到币安服务器的时延会有抖动. 这是我们设置recvWindow的目的所在，如果你从事高频交易，对交易时效性有较高的要求，可以灵活设置recvWindow以达到你的要求。

POST /eapi/v1/order 的示例

以下是在linux bash环境下使用 echo openssl 和curl工具实现的一个调用接口下单的示例 apikey、secret仅供示范

Key	Value
apiKey	dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83
secretKey	2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9

参数	取值
symbol	BTC-210129-40000-C
side	BUY
type	LIMIT
timeInForce	GTC
quantity	1
price	2000
recvWindow	5000
timestamp	1611825601400

示例 1: 所有参数通过 query string 发送

示例1:

HMAC SHA256 签名:

    $ echo -n "symbol=BTC-210129-40000-C&side=BUY&type=LIMIT&quantity=1&price=2000&timeInForce=GTC&recvWindow=5000&timestamp=1611825601400" | openssl dgst -sha256 -hmac "2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9"
    (stdin)= 3c661234138461fcc7a7d8746c6558c9842d4e10870d2ecbedf7777cad694af9

curl 调用:

    (HMAC SHA256)
    $ curl -H "X-MBX-APIKEY: dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83" -X POST 'https://eapi.binance.com/eapi/v1/order?symbol=BTC-210129-40000-C&side=BUY&type=LIMIT&quantity=1&price=9000&timeInForce=GTC&recvWindow=5000&timestamp=1611825601400&signature= 3c661234138461fcc7a7d8746c6558c9842d4e10870d2ecbedf7777cad694af9'

• queryString:

  symbol=BTC-210129-40000-C
  &side=BUY
  &type=LIMIT
  &timeInForce=GTC
  &quantity=1
  &price=2000 &recvWindow=5000
  &timestamp=1611825601400

示例 2: 所有参数通过 request body 发送

示例2:

HMAC SHA256 签名:

    $ echo -n "symbol=BTC-210129-40000-C&side=BUY&type=LIMIT&quantity=1&price=9000&timeInForce=GTC&recvWindow=5000&timestamp=1611825601400" | openssl dgst -sha256 -hmac "2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9"
    (stdin)= 3c661234138461fcc7a7d8746c6558c9842d4e10870d2ecbedf7777cad694af9

curl 调用:

    (HMAC SHA256)
    $ curl -H "X-MBX-APIKEY: dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83" -X POST 'https://eapi.binance.com/eapi/v1/order' -d 'symbol=BTC-210129-40000-C&side=BUY&type=LIMIT&quantity=1&price=9000&timeInForce=GTC&recvWindow=5000&timestamp=1611825601400&signature= 3c661234138461fcc7a7d8746c6558c9842d4e10870d2ecbedf7777cad694af9'

• requestBody:

  symbol=BTC-210129-40000-C
  &side=BUY
  &type=LIMIT
  &timeInForce=GTC
  &quantity=1
  &price=2000
  &recvWindow=5000
  &timestamp=1611825601400

示例 3: 混合使用 query string 与 request body

示例3:

HMAC SHA256 签名:

    $ echo -n "symbol=BTC-210129-40000-C&side=BUY&type=LIMIT&quantity=1&price=2000&timeInForce=GTC&recvWindow=5000&timestamp=1611825601400" | openssl dgst -sha256 -hmac "2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9"
    (stdin)= 3c661234138461fcc7a7d8746c6558c9842d4e10870d2ecbedf7777cad694af9

curl 调用:

    (HMAC SHA256)
    $ curl -H "X-MBX-APIKEY: dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83" -X POST 'https://eapi.binance.com/eapi/v1/order?symbol=BTC-210129-40000-C&side=BUY&type=LIMIT&timeInForce=GTC' -d 'quantity=1&price=2000&recvWindow=5000&timestamp=1611825601400&signature=3c661234138461fcc7a7d8746c6558c9842d4e10870d2ecbedf7777cad694af9'

• queryString: symbol=BTC-210129-40000-C&side=BUY&type=LIMIT&timeInForce=GTC
• requestBody: quantity=1&price=2000&recvWindow=5000&timestamp= 1611825601400

请注意，示例3中的签名有些许不同，在"GTC"和"quantity=1"之间没有"&"字符。

公开API参数

术语解释

• symbol 指期权合约的合约交易对名
• underlying 指期权合约标的资产的交易对名
• quote asset 指一个期权交易对的定价资产
• settleAsset 指期权行权时的结算资产

枚举定义

期权方向 (side):

• CALL 看涨期权
• PUT 看跌期权

订单方向 (side):

• BUY 买入
• SELL 卖出

持仓方向:

• LONG 多头
• SHORT 空头

有效方式 (timeInForce):

• GTC - Good Till Cancel 成交为止
• IOC - Immediate or Cancel 无法立即成交(吃单)的部分就撤销
• FOK - Fill or Kill 无法全部立即成交就撤销

响应类型 (newOrderRespType)

• ACK
• RESULT

订单状态 (order status):

• ACCEPTED 撮合收到的新建订单
• PARTIALLY_FILLED 部分成交
• FILLED 全部成交
• CANCELLED 已撤销
• REJECTED 订单被拒绝

订单种类 (orderTypes, type):

• LIMIT 限价单

K线间隔:

m -> 分钟; h -> 小时; d -> 天; w -> 周; M -> 月

• 1m
• 3m
• 5m
• 15m
• 30m
• 1h
• 2h
• 4h
• 6h
• 8h
• 12h
• 1d
• 3d
• 1w
• 1M

限制种类 (rateLimitType)

REQUEST_WEIGHT javascript { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400 }

ORDERS javascript { "rateLimitType": "ORDERS", "interval": "MINUTE", "intervalNum": 1, "limit": 1200 }

• REQUESTS_WEIGHT 单位时间请求权重之和上限

• ORDERS 单位时间下单(撤单)次数上限

限制间隔

• MINUTE

过滤器

过滤器，即Filter，定义了一系列交易规则。 共有两类，分别是针对交易对的过滤器symbol filters，和针对整个交易所的过滤器exchange filters(暂不支持)

交易对过滤器

PRICE_FILTER 价格过滤器

/exchangeInfo 响应中的格式:

  {
    "filterType": "PRICE_FILTER",
    "minPrice": "0.00000100",
    "maxPrice": "100000.00000000",
    "tickSize": "0.00000100"
  }

价格过滤器用于检测order订单中price参数的合法性

• minPrice 定义了 price 允许的最小值
• maxPrice 定义了 price 允许的最大值。
• tickSize 定义了 price 的步进间隔，即price必须等于minPrice+(tickSize的整数倍) 以上每一项均可为0，为0时代表这一项不再做限制。

逻辑伪代码如下：

• 卖单price >= minPrice
• 买单price <= maxPrice
• (price-minPrice) % tickSize == 0

LOT_SIZE 订单尺寸

/exchangeInfo 响应中的格式:*

  {
    "filterType": "LOT_SIZE",
    "minQty": "0.0100000",
    "maxQty": "1000.00000000",
    "stepSize": "0.00100000"
  }

lots是拍卖术语，这个过滤器对订单中的quantity也就是数量参数进行合法性检查。包含三个部分：

• minQty 表示 quantity 允许的最小值.
• maxQty 表示 quantity 允许的最大值
• stepSize 表示 quantity允许的步进值。

逻辑伪代码如下：

• quantity >= minQty
• quantity <= maxQty
• (quantity-minQty) % stepSize == 0

行情接口

测试服务器连通性 PING

GET /eapi/v1/ping

响应:

{}

测试能否联通

权重: 1

参数: NONE

获取服务器时间

响应:

{
  "serverTime": 1592387156596 // 当前的系统时间
}

GET /eapi/v1/time

获取服务器时间

权重: 1

参数: NONE

获取交易规则和交易对

响应:

{
  "timezone": "UTC",                    // 服务器时区
  "serverTime": 1592387337630,          // 请忽略。如果需要获取当前系统时间，请查询接口 “GET /eapi/v1/time”
  "optionContracts": [                  // 期权合约底层资产信息
    {
      "id": 1,
      "baseAsset": "BTC",               // 标的资产
      "quoteAsset": "USDT",             // 报价资产
      "underlying": "BTCUSDT",          // 期权合约底层资产
      "settleAsset": "USDT"             // 结算资产
    }
  ],
  "optionAssets": [                     // 期权系统支持资产
    {
      "id": 1,
      "name": "USDT"                    // 资产名
    }
  ],
  "optionSymbols": [                    // 期权交易对信息
    {
        "contractId": 2,
        "expiryDate": 1660521600000,    // 到期时间
        "filters": [
            {
                "filterType": "PRICE_FILTER",
                "minPrice": "0.02",
                "maxPrice": "80000.01",
                "tickSize": "0.01"
            },
            {
                "filterType": "LOT_SIZE",
                "minQty": "0.01",
                "maxQty": "100",
                "stepSize": "0.01"
            }
        ],
        "id": 17,
        "symbol": "BTC-220815-50000-C",   // 交易对
        "side": "CALL",                   // 期权方向
        "strikePrice": "50000",           // 行权价
        "underlying": "BTCUSDT",          // 合约底层资产
        "unit": 1,                        // 合约单位, 单一合约代表的底层资产数量 
        "makerFeeRate": "0.0002",         // 被动成交手续费率 
        "takerFeeRate": "0.0002",         // 主动成交手续费率
        "minQty": "0.01",                 // 最小下单数量
        "maxQty": "100",                  // 最大下单数量
        "initialMargin": "0.15",          // 初始保证金率
        "maintenanceMargin": "0.075",     // 维持保证金率
        "minInitialMargin": "0.1",        // 最低初始保证金率
        "minMaintenanceMargin": "0.05",   // 最低维持保证金率
        "priceScale": 2,                  // 价格精度
        "quantityScale": 2,               // 数量精度 
        "quoteAsset": "USDT"              // 报价资产
    },
  ],
  "rateLimits": [
    {
        "rateLimitType": "REQUEST_WEIGHT",
        "interval": "MINUTE",
        "intervalNum": 1,
        "limit": 2400
    },
    {
        "rateLimitType": "ORDERS",
        "interval": "MINUTE",
        "intervalNum": 1,
        "limit": 1200
    },
    {
        "rateLimitType": "ORDERS",
        "interval": "SECOND",
        "intervalNum": 10,
        "limit": 300
    }
  ]
}

GET /eapi/v1/exchangeInfo

获取交易规则和交易对

权重: 1

参数: NONE

深度信息

响应:

{
   "T": 1589436922972,   // 撮合引擎时间
   "u": 37461            // 更新id
   "bids": [             // 买单
    [
      "1000",            // 价格
      "0.9"              // 数量
    ]
  ],
  "asks": [              // 卖单
    [
      "1100",            // 价格
      "0.1"              // 数量
    ]
  ]
}  

GET /eapi/v1/depth

权重:

limit	权重
5, 10, 20, 50	2
100	5
500	10
1000	20

参数:

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
limit	INT	NO	默认 100; 可选值:[10, 20, 50, 100, 500, 1000]

近期成交

响应:

[
  { 
    "id":"1",             // ID
    "symbol": "BTC-220722-19000-C",
    "price": "1000",      // 成交价格
    "qty": "-0.1",        // 成交量
    "quoteQty": "-100",   // 成交额
    "side": -1            // 主动成交方方向
    "time": 1592449455993,// 时间
  }
]  

GET /eapi/v1/trades

获取近期订单簿成交

权重: 5

参数:

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
limit	INT	NO	默认:100，最大500

查询历史成交(MARKET_DATA)

响应:

[
  {
    "id":"1",             // Id
    "tradeId": "159244329455993",    // 成交ID
    "price": "1000",      // 成交价格
    "qty": "-0.1",        // 成交量
    "quoteQty": "-100",   // 成交额
    "side": -1            // 主动成交方方向
    "time": 1592449455993,// 时间
  }
]

GET /eapi/v1/historicalTrades

查询订单簿历史成交

权重: 20

参数:

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
limit	INT	NO	默认值:100 最大值:500.
fromId	LONG	NO	从哪一条成交id开始返回. 缺省返回最近的成交记录

K线数据

响应:

[
  {
      "open": "950",              // 开盘价
      "high": "1100",             // 最高价
      "low": "900",               // 最低价
      "close": "1000",            // 收盘价(当前K线未结束的即为最新价)
      "volume": "100"             // 成交额    
      "amount": "2",              // 成交量
      "interval": "5m",           // 时间区间
      "tradeCount": 10,           // 成交笔数
      "takerVolume": "100",       // 主动买入成交额
      "takerAmount": "10000",     // 主动买入成交量
      "openTime": 1499040000000,  // 开盘时间
      "closeTime": 1499644799999, // 收盘时间
  }
]

GET /eapi/v1/klines

每根K线的开盘时间可视为唯一ID

权重: 1

参数:

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
interval	ENUM	YES	时间间隔
startTime	LONG	NO	起始时间
endTime	LONG	NO	结束时间
limit	INT	NO	默认值:500 最大值:1500.

• 缺省返回最近的数据

查询期权标记价格

响应:

[
  {
    "symbol": "BTC-200730-9000-C",// 交易对
    "markPrice": "1343.2883",     // 标记价格
    "bidIV": "1.40000077",        // 买一隐含波动率
    "askIV": "1.50000153",        // 卖一隐含波动率
    "markIV": "1.45000000"        // 标记价格隐含波动率
    "delta": "0.55937056",        // delta
    "theta": "3739.82509871",     // theta
    "gamma": "0.00010969",        // gamma
    "vega": "978.58874732",       // vega
    "highPriceLimit": "1618.241", // 买最高限价
    "lowPriceLimit": "1068.3356"  // 卖最低限价
  }
]

GET /eapi/v1/mark

权重: 5

参数:

名称	类型	是否必需	描述
symbol	STRING	NO	交易对

24hr价格变动情况

响应:

[
  {
    "symbol": "BTC-200730-9000-C",
    "priceChange": "-16.2038",        //24小时价格变动
    "priceChangePercent": "-0.0162",  //24小时价格变动百分比
    "lastPrice": "1000",              //最近一次成交价
    "lastQty": "1000",                //最近一次成交额
    "open": "1016.2038",              //24小时内第一次成交的价格
    "high": "1016.2038",              //24小时最高价
    "low": "0",                       //24小时最低价
    "volume": "5",                    //成交额
    "amount": "1",                    //成交量
    "bidPrice":"999.34",              //最优买价
    "askPrice":"1000.23",             //最优卖价
    "openTime": 1592317127349,        //24小时内，第一笔交易的发生时间
    "closeTime": 1592380593516,       //24小时内，最后一笔交易的发生时间
    "firstTradeId": 1,                //首笔成交ID
    "tradeCount": 5,                  //成交笔数
    "strikePrice": "9000",            //行权价
    "exercisePrice": "3000.3356"      //行权前半小时返回预估结算价，其他时刻返回指数价格
  }
]

GET /eapi/v1/ticker

24小时价格变动

权重: 5

参数:

名称	类型	是否必需	描述
symbol	STRING	NO	交易对

• 不发送交易对参数，则会返回所有交易对信息

标的最新价格

响应:

{
   "time": 1656647305000,
   "indexPrice": "9200" // Current spot index price
}

GET /eapi/v1/index

返回最近指数价格

权重: 1

参数:

名称	类型	是否必需	描述
underlying	STRING	YES	现货交易对如BTCUSDT

历史行权记录

响应:

[
  { 
    "symbol": "BTC-220121-60000-P",            // 交易对  
    "strikePrice": "60000",                    // 行权价
    "realStrikePrice": "38844.69652571",       // 行权结算价格
    "expiryDate": 1642752000000,               // 行权时间
    "strikeResult": "REALISTIC_VALUE_STRICKEN" // 行权结果
  }
]

GET /eapi/v1/exerciseHistory

REALISTIC_VALUE_STRICKEN 行权 EXTRINSIC_VALUE_EXPIRED 未行权

权重: 3

参数:

名称	类型	是否必需	描述
underlying	STRING	NO	标的资产如BTCUSDT
startTime	LONG	NO	开始时间
endTime	LONG	NO	结束时间
limit	INT	NO	默认值:100 最大值:100.

合约持仓量

响应:

[
    {
        "symbol": "ETH-221119-1175-P",
        "sumOpenInterest": "4.01",
        "sumOpenInterestUsd": "4880.2985615624",
        "timestamp": "1668754020000"
    }
]

GET /eapi/v1/openInterest

获取期权持仓量。

参数:

名称	类型	是否必需	描述
underlyingAsset	STRING	YES	标的资产，如ETH或BTC
expiration	STRING	YES	到期日，如221225

账户和交易接口

账户信息 (TRADE)

响应:

{
  "asset": [                  
    {
      "asset": "USDT",                   // 资产类型
      "marginBalance": "1877.52214415",  // 账户余额
      "equity": "617.77711415",          // 账户权益
      "available": "0",                  // 账户可用
      "locked": "2898.92389933",         // 保证金锁定
      "unrealizedPNL": "222.23697000",   // 未实现盈亏   
   }
  ], 
  "greek": [
    {
      "underlying":"BTCUSDT"            // 标的资产
      "delta": "-0.05"                  // delta
      "gamma": "-0.002"                 // gamma
      "theta": "-0.05"                  // theta
      "vega": "-0.002"                  // vega  
    }
  ], 
  "riskLevel": "NORMAL",                // 账户风险等级
  "time": 1592449455993                 // 时间  
}

GET /eapi/v1/account (HMAC SHA256)

现有账户信息。

权重: 3

参数:

名称	类型	是否必需	描述
recvWindow	LONG	NO
timestamp	LONG	YES

资金划转 (TRADE)

资金划转， 详情参考这里.

下单 (TRADE)

响应ACK:

{
  "orderId": 4611875134427365377,     // 订单Id
  "clientOrderId": ""                 // 用户订单Id
  "symbol": "BTC-200730-9000-C",      // 交易对
  "price": "100",                     // 订单价格
  "quantity": "1",                    // 订单数量
  "side": "BUY",                      // 订单方向
  "type": "LIMIT",                    // 订单类型
  "createDate": 1592465880683,        // 订单时间
  "updateTime": 1566818724722,        // 更新时间
}

响应RESULT:

{
  "orderId": 4611875134427365377,     // 订单Id
  "symbol": "BTC-200730-9000-C",      // 交易对
  "price": 100,                       // 订单价格
  "quantity": 1,                      // 订单数量
  "executedQty": 0,                   // 执行数量
  "fee": 0,                           // 手续费 
  "side": "BUY",                      // 订单方向
  "type": "LIMIT",                    // 订单类型
  "timeInForce": "GTC",               // 有效时间
  "reduceOnly": false,                // 仅减仓
  "postOnly": false,                  // 仅做maker
  "createTime": 1592465880683,        // 订单创建时间
  "updateTime": 1566818724722,        // 订单更新时间
  "status": "ACCEPTED",               // 订单状态
  "avgPrice": "0",                    // 平均价格
  "clientOrderId": ""，               // 用户自定义订单Id
  "priceScale": 2,                    // 价格精度 
  "quantityScale": 2,                 // 数量精度  
  "optionSide": "CALL",               // 期权类型
  "quoteAsset": "USDT",               // 报价资产
  "mmp": false                        // 是否为MMP单
}

POST /eapi/v1/order (HMAC SHA256)

下单。

参数:

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
side	ENUM	YES	买卖方向 SELL, BUY
type	ENUM	YES	订单类型 LIMIT
quantity	DECIMAL	YES	下单数量
price	DECIMAL	NO	委托价格
timeInForce	ENUM	NO	有效时间
reduceOnly	STRING	NO	仅减仓true, false
postOnly	STRING	NO	仅做makertrue, false
newOrderRespType	ENUM	NO	"ACK", "RESULT", 默认 "ACK"
clientOrderId	STRING	NO	用户自定义的订单号，不可以重复出现在挂单中。如空缺系统会自动赋值。
isMmp	BOOLEAN	NO	是否为MMP订单true/false
recvWindow	LONG	NO
timestamp	LONG	YES

根据 order type的不同，某些参数强制要求，具体如下:

Type	强制要求的参数
LIMIT	timeInForce, quantity, price

批量下单 (TRADE)

响应:

[
    {
        "orderId": 4612288550799409153,  // 订单号
        "symbol": "ETH-220826-1800-C",   // 交易对
        "price": "100",                  // 订单价格
        "quantity": "0.01",              // 订单数量
        "side": "BUY",                   // 订单方向
        "type": "LIMIT",                 // 订单类型
        "reduceOnly": false,             // 仅减仓
        "postOnly": false,               // 仅做maker
        "clientOrderId": "1001",         // 用户订单id
        "mmp": false                     // 做市商保护     
    }
]

POST /eapi/v1/batchOrders (HMAC SHA256)

批量下单。

权重: 5

参数:

名称	类型	是否必需	描述
orders	LIST	YES	订单列表，最多支持5个订单
recvWindow	LONG	NO
timestamp	LONG	YES

其中batchOrders应以list of JSON格式填写订单参数

• 例子: /eapi/v1/batchOrders?orders=[{"symbol":"BTC-210115-35000-C", "price":"100","quantity":"0.0002","side":"BUY","type":"LIMIT"}]

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
side	ENUM	YES	买卖方向 SELL, BUY
type	ENUM	YES	订单类型 LIMIT
quantity	DECIMAL	YES	下单数量
price	DECIMAL	NO	委托价格
timeInForce	ENUM	NO	有效时间
reduceOnly	STRING	NO	仅减仓true, false
postOnly	STRING	NO	仅减仓true, false
newOrderRespType	ENUM	NO	"ACK", "RESULT", 默认 "ACK"
clientOrderId	STRING	NO	用户自定义的订单号，不可以重复出现在挂单中。如空缺系统会自动赋值。必须满足正则规则 ^[\.A-Z\:/a-z0-9_-]{1,36}$
isMmp	BOOLEAN	NO	是否为MMP订单true/false

• 具体订单条件规则，与普通下单一致
• 批量下单采取并发处理，不保证订单撮合顺序
• 批量下单的返回内容顺序，与订单列表顺序一致

查询单个订单 (TRADE)

响应:

{
  "orderId": 4611875134427365377,     // 订单号
  "symbol": "BTC-200730-9000-C",      // 交易对
  "price": "100",                     // 订单价格
  "quantity": "1",                    // 订单数量
  "executedQty": "0",                 // 执行数量
  "fee": "0",                         // 手续费 
  "side": "BUY",                      // 订单方向
  "type": "LIMIT",                    // 订单类型
  "timeInForce": "GTC",               // 有效时间
  "reduceOnly": false,                // 仅减仓
  "postOnly": false,                  // 仅做maker
  "createTime": 1592465880683,        // 下单时间
  "updateTime": 1566818724722,        // 更新时间
  "status": "ACCEPTED",               // 订单状态
  "avgPrice": "0",                    // 成交均价
  "source": "API",                    // 订单来源
  "clientOrderId": ""                 // 自定义id
  "priceScale": 2,
  "quantityScale": 2,
  "optionSide": "CALL",
  "quoteAsset": "USDT",
  "mmp": false
}

无订单响应:

{
    "code": -2013,
    "msg": "Order does not exist"
}

GET /eapi/v1/order (HMAC SHA256)

查询订单状态。

权重: 1

• 以下订单无法找到:
  • 订单状态为 CANCELED or REJECTED， AND
  • 订单没有成交记录， AND
  • 订单生成时间 + 3天 < 当前时间

参数:

名称	类型	是否必需	描述
symbol	STRING	YES	交易对如：BTC-200730-9000-C
orderId	LONG	NO	订单id
clientOrderId	STRING	NO	用户自定义的订单号
recvWindow	LONG	NO
timestamp	LONG	YES

• 至少需要发送 orderId 或 clientOrderId

撤销订单 (TRADE)

响应:

{
  "orderId": 4611875134427365377,     // 订单Id
  "symbol": "BTC-200730-9000-C",      // 交易对
  "price": "100",                     // 订单价格
  "quantity": "1",                    // 订单数量
  "executedQty": "0",                 // 已经成交数量
  "fee": "0",                         // 手续费
  "side": "BUY",                      // 订单方向
  "type": "LIMIT",                    // 订单类型
  "timeInForce": "GTC",               // 有效时间
  "reduceOnly": false,                // 仅减仓
  "postOnly": false,                  // 仅做maker
  "createDate": 1592465880683,        // 订单创建时间
  "updateTime": 1566818724722,        // 订单更新时间
  "status": "ACCEPTED",               // 订单状态
  "avgPrice": "0",                    // 平均成交价
  "source": "API",                    // 订单来源
  "clientOrderId": "",                // 用户自定义的订单号
  "priceScale": 4,                    // 价格精度
  "quantityScale": 4,                 // 数量精度
  "optionSide": "CALL",               // 期权类型
  "quoteAsset": "USDT",               // 报价资产
  "mmp": false                        // 是否为MMP单
}

DELETE /eapi/v1/order (HMAC SHA256)

撤销订单。

权重: 1

Parameters:

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
orderId	LONG	NO	系统订单号
clientOrderId	STRING	NO	用户自定义的订单号
recvWindow	LONG	NO
timestamp	LONG	YES

orderId 与 origClientOrderId 必须至少发送一个

批量撤销订单 (TRADE)

响应:

[
  {
    "orderId": 4611875134427365377,     // 订单Id
    "symbol": "BTC-200730-9000-C",      // 交易对
    "price": "100",                     // 订单价格
    "quantity": "1",                    // 订单数量
    "executedQty": "0",                 // 已经成交数量
    "fee": "0",                         // 手续费 
    "side": "BUY",                      // 订单方向
    "type": "LIMIT",                    // 订单类型
    "timeInForce": "GTC",               // 有效时间
    "createTime": 1592465880683,        // 订单创建时间
    "status": "ACCEPTED",               // 订单类型
    "avgPrice": "0",                    // 平均成交价
    "reduceOnly": false,                // 仅减仓
    "clientOrderId": ""                 // 用户自定义的订单号
    "updateTime": 1566818724722,        // 订单更新时间
  }
]

DELETE /eapi/v1/batchOrders (HMAC SHA256)

批量撤销订单。

权重: 1

Parameters:

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
orderIds	LIST<LONG>	NO	系统订单号 比如 [4611875134427365377,4611875134427365378]
clientOrderIds	LIST<STRING>	NO	用户自定义的订单号 比如["my_id_1","my_id_2"] 需要encode双引号。逗号后面没有空格。
recvWindow	LONG	NO
timestamp	LONG	YES

orderIds 与 clientOrderIds 必须至少发送一个，不可同时发送

撤销单交易对全部订单 (TRADE)

响应:

{
    "code": 0, 
    "msg": "success"
}

DELETE /eapi/v1/allOpenOrders (HMAC SHA256)

取消一个交易对上所有订单。

权重: 1

Parameters:

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
recvWindow	LONG	NO
timestamp	LONG	YES

撤销特定标的全部订单 (TRADE)

响应:

{
    "code": 0,
    "msg": "success",
    "data": 0
}

DELETE /eapi/v1/allOpenOrdersByUnderlying (HMAC SHA256)

取消特定标的上所有订单。

权重: 1

Parameters:

名称	类型	是否必需	描述
underlying	STRING	YES	标的资产如BTCUSDT
recvWindow	LONG	NO
timestamp	LONG	YES

查询当前挂单 (USER_DATA)

响应:

[
  {
    "orderId": 4611875134427365377,     // 订单Id
    "symbol": "BTC-200730-9000-C",      // 交易对
    "price": "100",                     // 订单价格
    "quantity": "1",                    // 订单数量
    "executedQty": "0",                 // 已经成交的交易量
    "fee": "0",                         // 手续费 
    "side": "BUY",                      // 订单方向
    "type": "LIMIT",                    // 订单类型
    "timeInForce": "GTC",               // 有效时间
    "reduceOnly": false,                // 仅减仓
    "postOnly": false,                  // 仅做maker
    "createTime": 1592465880683,        // 订单创建时间
    "updateTime": 1592465880683,        // 订单更新时间
    "status": "ACCEPTED",               // 订单状态
    "avgPrice": "0",                    // 已成交平均价
    "clientOrderId": ""                 // 用户自定义订单id       
    "priceScale": 2,                    // 价格精度  
    "quantityScale": 2,                 // 数量精度
    "optionSide": "CALL",               // 期权类型
    "quoteAsset": "USDT",               // 报价资产
    "mmp": false                        // 是否为MMP订单
  }
]

GET /eapi/v1/openOrders (HMAC SHA256)

查询当前挂单（包含状态为ACCEPTED/ PARTIALLY_FILLED的订单）

权重: 带symbol 1，不带40

参数:

名称	类型	是否必需	描述
symbol	STRING	NO	交易对(不传返回所有订单)
orderId	LONG	NO	只返回此orderID及之后的订单，缺省返回最近的订单
startTime	LONG	NO	开始时间
endTime	LONG	NO	结束时间
limit	INT	NO	返回数量，默认100 最大1000
recvWindow	LONG	NO
timestamp	LONG	YES

查询历史订单 (USER_DATA)

响应:

[
  {
    "orderId": 4611875134427365377,     // 订单Id
    "symbol": "BTC-200730-9000-C",      // 交易对
    "price": 100,                       // 订单价格
    "quantity": 1,                      // 订单数量
    "executedQty": 0,                   // 已经成交的交易量
    "fee": 0,                           // 手续费 
    "side": "BUY",                      // 订单方向
    "type": "LIMIT",                    // 订单类型
    "timeInForce": "GTC",               // 有效时间
    "reduceOnly": false,                // 仅减仓
    "postOnly": false,                  // 仅做maker
    "createTime": 1592465880683,        // 订单创建时间
    "updateTime": 1592465880683,        // 订单更新时间
    "status": "ACCEPTED",               // 订单状态
    "avgPrice": "0",                    // 已成交平均价
    "source": "API",                    // 订单来源
    "clientOrderId": ""                 // 用户自定义订单id       
    "priceScale": 2,                    // 价格精度  
    "quantityScale": 2,                 // 数量精度
    "optionSide": "CALL",               // 期权类型
    "quoteAsset": "USDT",               // 报价资产
    "mmp": false                        // 是否为MMP订单
  }
]

GET /eapi/v1/historyOrders (HMAC SHA256)

查询5天内的历史订单，订单的最终状态为 CANCELED 或者 FILLED 或者 REJECTED

权重: 3

Parameters:

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
orderId	LONG	NO	只返回此orderID及之后的订单，缺省返回最近的订单
startTime	LONG	NO	起始时间
endTime	LONG	NO	结束时间
limit	INT	NO	返回的结果集数量 默认值:500 最大值:1000
recvWindow	LONG	NO
timestamp	LONG	YES

仓位信息 (USER_DATA)

Response:

[
  {
    "entryPrice": "1000",             // 开仓均价
    "symbol": "BTC-200730-9000-C",    // 交易对
    "side": "SHORT",                  // 仓位方向
    "quantity": "-0.1",               // 仓位数量
    "reducibleQty": "0",              // 可减仓数量
    "markValue": "105.00138",         // 期权价值
    "ror": "-0.05",                   // 收益率
    "unrealizedPNL": "-5.00138",      // 未实现盈亏
    "markPrice": "1050.0138",         // 期权标记价格
    "strikePrice": "9000",            // 行权价
    "expiryDate": 1593511200000       // 行权时间
    "positionCost": "1000.0000",      // 仓位成本
    "priceScale": 2,                  // 价格精度 
    "quantityScale": 2,               // 数量精度
    "optionSide": "CALL",             // 期权方向
    "quoteAsset": "USDT"              // 报价资产
   }
]

GET /eapi/v1/position (HMAC SHA256)

获取仓位信息。

Weight: 5

Parameters:

名称	类型	是否必需	描述
symbol	STRING	NO	交易对如BTC-200730-9000-C
recvWindow	LONG	NO
timestamp	LONG	YES

账户成交历史 (USER_DATA)

响应:

[
  {
    "id": 4611875134427365377,          // id
    "tradeId": 239,                     // 交易id
    "orderId": 4611875134427365377,     // 订单id
    "symbol": "BTC-200730-9000-C",      // 交易对
    "price": "100",                     // 成交价
    "quantity": "1",                    // 成交量
    "fee": "0",                         // 手续费
    "realizedProfit": "0.00000000",     // 已实现盈亏
    "side": "BUY",                      // 订单方向
    "type": "LIMIT",                    // 订单类型 
    "volatility": "0.9",                // 隐含波动率
    "liquidity": "TAKER",               // TAKER or MAKER      
    "quoteAsset": "USDT",               // 报价资产
    "time": 1592465880683               // 交易时间
    "priceScale": 2,                    // 价格精度
    "quantityScale": 2,                 // 数量精度 
    "optionSide": "CALL",               // 期权种类
    "quoteAsset": "USDT"                // 报价资产
  } 
]

GET /eapi/v1/userTrades (HMAC SHA256)

获取某交易对的成交历史

权重: 5

参数:

名称	类型	是否必需	描述
symbol	STRING	NO	交易对
fromId	LONG	NO	返回该fromId及之后的成交，缺省返回最近的成交
startTime	LONG	NO	起始时间
endTime	LONG	NO	结束时间
limit	INT	NO	返回的结果集数量 默认值:100 最大值:1000.
recvWindow	LONG	NO
timestamp	LONG	YES

用户行权历史(USER_DATA)

Response:

[
    {
        "id": "1125899906842624042",        
        "currency": "USDT",                  // 结算资产
        "symbol": "BTC-220721-25000-C",      // 交易对
        "exercisePrice": "25000.00000000",   // 行权价
        "markPrice": "25000.00000000",       // 结算标记价格
        "quantity": "1.00000000",            // 数量
        "amount": "0.00000000",              // 金额
        "fee": "0.00000000",                 // 手续费
        "createDate": 1658361600000,         // 行权时间
        "priceScale": 2,                     // 价格精度
        "quantityScale": 2,                  // 数量精度
        "optionSide": "CALL",                // 期权种类
        "positionSide": "LONG",              // 仓位方向
        "quoteAsset": "USDT"                 // 报价资产
    }
] 

GET /eapi/v1/exerciseRecord (HMAC SHA256)

获取用户行权历史.

Weight: 5

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO	交易对如 BTC-200730-9000-C
startTime	LONG	NO	起始时间如1593511200000
endTime	LONG	NO	结束时间如1593512200000
limit	INT	NO	默认1000, 最大1000
recvWindow	LONG	NO
timestamp	LONG	YES

获取账户资金流水(USER_DATA)

响应:

[
  {
    "id": 1125899906842624000,
    "asset": "USDT",              // 资产类型
    "amount": "-0.552",           // 数量 (正数为流入，负数为流出)
    "type": "FEE",                // 类型 (手续费)
    "createDate": 1592449456000,  // 时间
  },
  {
    "id": 1125899906842624000,
    "asset": "USDT",              // 资产类型
    "amount": "100",              // 数量 (正数为流入，负数为流出)
    "type": "CONTRACT",           // 类型(买卖合约)
    "createDate": 1592449456000,  // 时间
  },
  {
    "id": 1125899906842624000,
    "asset": "USDT",              // 资产类型
    "amount": "10000",            // 数量 (正数为流入，负数为流出)
    "type": "TRANSFER",           // 类型（资金划转）
    "createDate": 1592448410000,  // 时间
  }
]

GET /eapi/v1/bill (HMAC SHA256)

权重: 1

参数:

名称	类型	是否必需	描述
currency	STRING	YES	资产类型如USDT
recordId	LONG	NO	返回该recordId及之后的成交，缺省返回最近的成交
startTime	LONG	NO	起始时间如1593511200000
endTime	LONG	NO	结束时间如1593512200000
limit	INT	NO	默认100 最大1000
recvWindow	LONG	NO
timestamp	LONG	YES

获取期权资金流水下载Id (USER_DATA)

响应:

{
    "avgCostTimestampOfLast30d":7241837, //过去30天平均数据下载时间
    "downloadId":"546975389218332672",   //下载Id
}

GET /eapi/v1/income/asyn (HMAC SHA256)

权重: 5

参数:

名称	类型	是否必需	描述
startTime	LONG	YES	起始时间，ms格式时间戳
endTime	LONG	YES	结束时间，ms格式时间戳
recvWindow	LONG	NO
timestamp	LONG	YES

• 存在每月10次的请求限制，网页端和Rest接口下载次数共用。
• startTime与endTime间隔不能超过1年

通过下载Id获取合约资金流水下载链接 (USER_DATA)

响应:

{
    "downloadId":"545923594199212032", // 下载Id
    "status":"completed",     // 状态，枚举类型：completed 已完成，processing 处理中
    "url":"www.binance.com",  // 适配该笔ID请求的下载链接       
    "notified":true,          // 忽略
    "expirationTimestamp":1645009771000,  // 晚于该时间戳之后链接将自动失效
    "isExpired":null,
}

或 (服务器仍在处理中会返回)

{
    "downloadId":"545923594199212032",
    "status":"processing",
    "url":"", 
    "notified":false,
    "expirationTimestamp":-1
    "isExpired":null,
}

GET /eapi/v1/income/asyn/id (HMAC SHA256)

权重: 5

参数:

名称	类型	是否必需	描述
downloadId	STRING	YES	通过下载id 接口获取
recvWindow	LONG	NO
timestamp	LONG	YES

• 下载链接有效期：24小时。

Websocket 行情推送

• Base Url：wss://nbstream.binance.com/eoptions/
• 订阅单一stream格式为 /ws/<streamName>
• 组合streams的URL格式为 /stream?streams=<streamName1>/<streamName2>/<streamName3>

• 连接样例：

  • wss://nbstream.binance.com/eoptions/ws/BTC-210630-9000-P@ticker
  • wss://nbstream.binance.com/eoptions/stream?streams=BTC-210630-9000-P@trade/BTC-210630-9000-P@ticker

• 订阅组合streams时，事件payload会以这样的格式封装 {"stream":"<streamName>","data":<rawPayload>}

• 订阅stream的交易对需要大写

• 每个链接有效期不超过24小时，请妥善处理断线重连。

• 服务端每5分钟会发送ping帧，客户端应当在15分钟内回复pong帧，否则服务端会主动断开链接。允许客户端发送不成对的pong帧(即客户端可以以高于15分钟每次的频率发送pong帧保持链接)。

• Websocket服务器每秒最多接受10个订阅消息。

• 如果用户发送的消息超过限制，连接会被断开连接。反复被断开连接的IP有可能被服务器屏蔽。

• 单个连接最多可以订阅 200 个Streams。

实时订阅/取消数据流

• 以下数据可以通过websocket发送以实现订阅或取消订阅数据流。示例如下。
• 响应内容中的id是无符号整数，作为往来信息的唯一标识。

订阅一个信息流

响应

  {
    "result": null,
    "id": 1
  }

• 请求

  {
  "method": "SUBSCRIBE",
  "params":
  [
  "BTC-210630-9000-P@ticker",
  "BTC-210630-9000-P@depth"
  ],
  "id": 1
  }

取消订阅一个信息流

响应

  {
    "result": null,
    "id": 312
  }

• 请求

{
"method": "UNSUBSCRIBE",
"params":
[
"BTC-210630-9000-P@ticker"
],
"id": 312
}

已订阅信息流

响应

  {
    "result": [
      "BTC-210630-9000-P@ticker"
    ],
    "id": 3
  }

• 请求

{
"method": "LIST_SUBSCRIPTIONS",
"id": 3
}

设定属性

当前，唯一可以设置的属性是设置是否启用combined("组合")信息流。
当使用/ws/("原始信息流")进行连接时，combined属性设置为false，而使用 /stream/进行连接时则将属性设置为true。

响应

  {
    "result": null
    "id": 5
  }

• 请求

{
"method": "SET_PROPERTY",
"params":
[
"combined",
true
],
"id": 5
}

检索属性

响应

  {
    "result": true, // Indicates that combined is set to true.
    "id": 2
  }

• 请求

{
"method": "GET_PROPERTY",
"params":
[
"combined"
],
"id": 2
}

错误信息

错误信息	描述
{"code": 0, "msg": "Unknown property"}	SET_PROPERTY 或 GET_PROPERTY中应用的参数无效
{"code": 1, "msg": "Invalid value type: expected Boolean"}	仅接受true或false
{"code": 2, "msg": "Invalid request: property name must be a string"}	提供的属性名无效
{"code": 2, "msg": "Invalid request: request ID must be an unsigned integer"}	参数id未提供或id值是无效类型
{"code": 2, "msg": "Invalid request: unknown variant %s, expected one of SUBSCRIBE, UNSUBSCRIBE, LIST_SUBSCRIPTIONS, SET_PROPERTY, GET_PROPERTY at line 1 column 28"}	错字提醒，或提供的值不是预期类型
{"code": 2, "msg": "Invalid request: too many parameters"}	数据中提供了不必要参数
{"code": 2, "msg": "Invalid request: property name must be a string"}	未提供属性名
{"code": 2, "msg": "Invalid request: missing field method at line 1 column 73"}	数据未提供method
{"code":3,"msg":"Invalid JSON: expected value at line %s column %s"}	JSON 语法有误.

最新交易

Payload:

{
    "e":"trade",                  // 事件类型  
    "E":1591677941092,            // 事件时间   
    "s":"BTC-200630-9000-P",      // 交易对  
    "t":1,                        // 交易ID   
    "p":"1000",                   // 交易价格   
    "q":"-2",                     // 交易数量   
    "b":4611781675939004417,      // 买单ID   
    "a":4611781675939004418,      // 卖单ID   
    "T":1591677567872,            // 交易时间  
    "S":"-1"                      // 方向 -1为主动卖出，1位主动买入  
}

交易流推出特定交易对或特定标的资产的最新成交信息。如ETH@trade

Stream Name:
<symbol>@trade or <underlyingAsset>@trade

Update Speed: 50ms

指数价格

** Payload: **

{
    "e":"index",         // 事件类型
    "E":1661415480351,   // 事件时间
    "s":"ETHUSDT",       // 标的资产
    "p":"1707.89008607"  // 指数价格
}

标的资产指数价格(如ETHUSDT).

Stream Name:
<symbol>@index

Update Speed: 1000ms

标记价格

** Payload: **

[
    {
      "e":"markPrice",         // 事件类型
      "E":1663684594227,       // 事件时间
      "s":"ETH-220930-1500-C", // 交易对
      "mp":"30.3"              // 指数价格
    },
    {
      "e":"markPrice",
      "E":1663684594228,
      "s":"ETH-220923-1000-C",
      "mp":"341.5"
    }
】

单一标的的所有期权交易对标记价格。如ETH@markPrice

Stream Name:
<underlyingAsset>@markPrice

Update Speed: 1000ms

K线

Payload:

{
    "e":"kline",                        // 事件类型
    "E":1638747660000,                  // 事件时间
    "s":"BTC-200630-9000-P",            // 交易对  
    "k":{                             
        "t":1638747660000,              // 这根K线的起始时间
        "T":1638747719999,              // 这根K线的结束时间
        "s":"BTC-200630-9000-P",        // 交易对  
        "i":"1m",                       // K线间隔
        "F":0,                          // 这根K线期间第一笔成交ID
        "L":0,                          // 这根K线期间末一笔成交ID
        "o":"1000",                     // 这根K线期间第一笔成交价   
        "c":"1000",                     // 这根K线期间末一笔成交价   
        "h":"1000",                     // 这根K线期间最高成交价    
        "l":"1000",                     // 这根K线期间最低成交价   
        "v":"0",                        // 这根K线期间成交量   
        "n":0,                          // 这根K线期间成交笔数
        "x":false,                      // 这根K线是否完结(是否已经开始下一根K线)
        "q":"0",                        // 这根K线期间成交额
        "V":"0",                        // 主动买入的成交额
        "Q":"0"                         // 主动买入的成交量
    }
}

K线stream逐秒推送所请求的K线种类(最新一根K线)的更新。推送间隔1000毫秒(如有刷新)

订阅Kline需要提供间隔参数，最短为分钟线，最长为月线。支持以下间隔:

m -> 分钟; h -> 小时; d -> 天; w -> 周; M -> 月

• 1m
• 3m
• 5m
• 15m
• 30m
• 1h
• 2h
• 4h
• 6h
• 8h
• 12h
• 1d
• 3d
• 1w
• 1M

Stream Name:
<symbol>@kline_<interval>

Update Speed: 1000ms

按交易对的Ticker

Payload:

{  
  "e":"24hrTicker",           // 事件类型
  "E":1657706425200,          // 事件时间
  "T":1657706425220,          // 交易时间
  "s":"BTC-220930-18000-C",   // 交易对   
  "o":"2000",                 // 24小时前开始第一笔成交价格
  "h":"2020",                 // 24小时内最高成交价
  "l":"2000",                 // 24小时内最低成交价
  "c":"2020",                 // 最新成交价格
  "V":"1.42",                 // 交易量
  "A":"2841",                 // 交易额
  "P":"0.01",                 // 价格变动比例
  "p":"20",                   // 价格变动
  "Q":"0.01",                 // 最近交易成交额
  "F":"27",                   // 第一笔交易id
  "L":"48",                   // 最后一笔交易id
  "n":22,                     // 交易笔数
  "bo":"2012",                // 买一价
  "ao":"2020",                // 卖一价
  "bq":"4.9",                 // 买一数量
  "aq":"0.03",                // 卖一数量
  "b":"0.1202",               // 买一隐含波动率
  "a":"0.1318",               // 卖一隐含波动率
  "d":"0.98911",              // delta
  "t":"-0.16961",             // theta 
  "g":"0.00004",              // gamma  
  "v":"2.66584",              // vega
  "vo":"0.10001",             // 隐含波动率
  "mp":"2003.5102",           // 标记价格
  "hl":"2023.511",            // 买最高限价
  "ll":"1983.511",            // 卖最低限价
  "eep":"0"                   // 结算前半小时返回预估结算价
} 

按Symbol刷新的24小时ticker信息.

Stream Name:
`<symbol>@ticker

Update Speed: 1000ms

按标的资产和到期日的Ticker

Payload:

[
    {  
      "e":"24hrTicker",           // 事件类型
      "E":1657706425200,          // 事件时间
      "T":1657706425220,          // 交易时间
      "s":"ETH-220930-1600-C",    // 交易对   
      "o":"2000",                 // 24小时前开始第一笔成交价格
      "h":"2020",                 // 24小时内最高成交价
      "l":"2000",                 // 24小时内最低成交价
      "c":"2020",                 // 最新成交价格
      "V":"1.42",                 // 交易量
      "A":"2841",                 // 交易额
      "P":"0.01",                 // 价格变动比例
      "p":"20",                   // 价格变动
      "Q":"0.01",                 // 最近交易成交额
      "F":"27",                   // 第一笔交易id
      "L":"48",                   // 最后一笔交易id
      "n":22,                     // 交易笔数
      "bo":"2012",                // 买一价
      "ao":"2020",                // 卖一价
      "bq":"4.9",                 // 买一数量
      "aq":"0.03",                // 卖一数量
      "b":"0.1202",               // 买一隐含波动率
      "a":"0.1318",               // 卖一隐含波动率
      "d":"0.98911",              // delta
      "t":"-0.16961",             // theta 
      "g":"0.00004",              // gamma  
      "v":"2.66584",              // vega
      "vo":"0.10001",             // 隐含波动率
      "mp":"2003.5102",           // 标记价格
      "hl":"2023.511",            // 买最高限价
      "ll":"1983.511",            // 卖最低限价
      "eep":"0"                   // 结算前半小时返回预估结算价
    },
    {
      "e":"24hrTicker",
      "E":1663685112123,
      "s":"ETH-220930-1500-C",
      "o":"34.9",
      "h":"44.6",
      "l":"26.8",
      "c":"26.8",
      "V":"11.84",
      "A":"444.37",
      "P":"-0.232",
      "p":"-8.1",
      "Q":"0",
      "F":"91",
      "L":"129",
      "n":39,
      "bo":"26.8",
      "ao":"33.9",
      "bq":"0.65",
      "aq":"0.01",
      "b":"0.88790536",
      "a":"0.98729014",
      "d":"0.2621153",
      "t":"-3.44806807",
      "g":"0.00158298",
      "v":"0.7148147",
      "vo":"0.93759775",
      "mp":"30.3",
      "hl":"228.7",
      "ll":"0.1",
      "eep":"0"
    } 
]    

按期权标的资产和到期日的Ticker。E.g.ETH@ticker@220930

Stream Name:
`<underlyingAsset>@ticker@<expirationDate>

Update Speed: 1000ms

合约持仓量

Payload:

[
    {
      "e":"openInterest",       // 事件类型
      "E":1668759300045,        // 事件时间
      "s":"ETH-221125-2700-C",  // 交易对
      "o":"1580.87",            // 持仓量（以张数计）
      "h":"1912992.178168204"   // 持仓量（以USDT计）
    }
]

特定标的资产特定到期日的期权合约持仓量。如ETH@openInterest@221125

Stream Name:
<underlyingAsset>@openInterest@<expirationDate>

Update Speed: 60s

新增交易对信息推送

Payload:

{
    "e":"OPTION_PAIR",        //事件类型   
    "E":1668573571842,        //事件时间  
    "id":652,                 //option id
    "cid":2,                  //合约标的id
    "u":"BTCUSDT",            //标的资产 
    "qa":"USDT",              //计价资产  
    "s":"BTC-221116-21000-C", //交易对
    "unit":1,                 //一张合约代表的标的数量
    "mq":"0.01",              //最小交易数量
    "d":"CALL",               //期权类型
    "sp":"21000",             //行权价格
    "ed":1668585600000        //行权时间 
  }

新增交易对推送。

Stream Name:
option_pair

Update Speed: 50ms

有限档深度信息

Payload:

{
    "e":"depth",                    // 时间类型
    "E":1591695934010,              // 事件时间
    "T":1591695934000,              // 撮合时间
    "s":"BTC-200630-9000-P",        // 交易对
    "u":162,                                    // update id in event
    "pu":162,                                   // same as update id in event 
    "b":[                           // 买单
      [
          "200",                    // Price
          "3",                      // quantity
      ],
      [
          "101",
          "1"
      ],
      [
          "100",
          "2"
      ]
    ],
    "a":[                           // 卖单  
        [
            "1000",
            "89"
        ]
    ]
}

推送有限档深度信息。levels表示几档买卖单信息, 可选10/20/50/100/1000档

Stream Names: <symbol>@depth<levels> 或 <symbol>@depth<levels>@100ms 或 <symbol>@depth<levels>@1000ms.

Update Speed: 100ms 或 1000ms, 500ms（不传update speed时）

Websocket 账户信息推送

• 本篇所列出REST接口的baseurl https://eapi.binance.com
• 用于订阅账户数据的 listenKey 从创建时刻起有效期为60分钟
• 可以通过PUT一个listenKey延长60分钟有效期
• 可以通过DELETE一个 listenKey 立即关闭当前数据流，并使该listenKey 无效
• 在具有有效listenKey的帐户上执行POST将返回当前有效的listenKey并将其有效期延长60分钟

• websocket接口的连接方式如下：

  • Base Url: wss://nbstream.binance.com/eoptions/
  • 订阅账户数据流的stream名称为 /ws/<listenKey>
  • 连接样例：
  • wss://nbstream.binance.com/eoptions/ws/XaEAKTsQSRLZAGH9tuIu37plSRsdjmlAVBoNYPUITlTAko1WI22PgmBMpI1rS8Yh

• 每个链接有效期不超过24小时，请妥善处理断线重连。

• 考虑到剧烈行情下, RESTful接口可能存在查询延迟，我们强烈建议您优先从Websocket user data stream推送的消息来获取订单，仓位等信息。

生成listenKey (USER_STREAM)

响应:

{
  "listenKey": "pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s61cv6a81va65sdf19v8a65a1"
}

POST /eapi/v1/listenKey

创建一个新的user data stream，返回值为一个listenKey，即websocket订阅的stream名称。如果该帐户具有有效的listenKey，则将返回该listenKey并将其有效期延长60分钟。

权重: 1

参数: None

延长listenKey有效期 (USER_STREAM)

响应:

{}

PUT /eapi/v1/listenKey

有效期延长至本次调用后60分钟

权重: 1

参数: None

关闭listenKey (USER_STREAM)

响应:

{}

DELETE /eapi/v1/listenKey

关闭某账户数据流

权重: 1

参数: None

追加保证金通知

Payload:

 {
    "e":"RISK_LEVEL_CHANGE", //事件类型  
    "E":1587727187525,       //事件时间
    "s":"REDUCE_ONLY",       //风险等级
    "mb":"1534.11708371",    //保证金余额
    "mm":"254789.11708371"   //维持保证金
}  

• 每当账户风险等级发生变化时进行更新。以下是可能的状态：

  • NORMAL
  • REDUCE_ONLY

• 需要注意的是，风险等级变化仅适用于VIP和市场做市商用户帐户。如果VIP和某些市场做市商账户的保证金余额不足以满足其维持保证金义务，系统将自动将其风险等级更改为仅减少模式（REDUCE_ONLY）。一旦风险等级被设置为仅减少模式（REDUCE_ONLY），系统将在以下事件发生时重新评估风险等级：

  • 资金转账
  • 成交填充
  • 期权到期

Update Speed: 50ms

Account数据更新推送

Payload:

 {
    "e":"ACCOUNT_UPDATE",                 // 事件类型
    "E":1591696384141,                    // 事件时间
    "B":[
        {
          "b":"100007992.26053177",       // 账户余额
          "m":"0",                        // 仓位价值 
          "u":"458.782655111111",         // 未实现盈亏  
          "U":200,                        // 多仓未实现盈利
          "M":"-15452.328456",            // 维持保证金
          "i":"-18852.328456",            // 初始保证金
          "a":"USDT",                     // 保证金资产  
        }
    ],
    "G":[
        {
         "ui":"SOLUSDT",                  // 标的资产 
         "d":-33.2933905,                 // Delta  
         "t":35.5926375,                  // Theta 
         "g":-14.3023855,                 // Gamma 
         "v":-0.1929375                   // Vega    
        }
    ],
    "P":[
      {
       "s":"SOL-220912-35-C",             // 交易对   
       "c":"-50",                         // 仓位数量   
       "r":"-50",                         // 可减数量  
       "p":"-100",                        // 仓位价值
       "a":"2.2",                         // 仓位均价   
      }
    ],
    "uid":1000006559949
}  

账户更新事件的 event type 固定为 ACCOUNT_UPDATE

• 当账户信息有变动时，会推送此事件：
  • 仅当账户信息有变动时(包括资金、仓位发生变化)，才会推送此事件；
  • 账户Greek变动定期推送
  • 如果没有仓位变化，P不会推出

Update Speed: 50ms

订单/交易 更新推送

Payload:

{
  "e":"ORDER_TRADE_UPDATE",           // 事件类型
  "E":1657613775883,                  // 事件时间
  "o":[
    {
      "T":1657613342918,              // 订单创建时间
      "t":1657613342918,              // 订单更新时间
      "s":"BTC-220930-18000-C",       // 交易对
      "c":"",                         // 用户订单id
      "oid":"4611869636869226548",    // 订单id
      "p":"1993",                     // 订单价格
      "q":"1",                        // 订单数量
      "stp":0,                        // 忽略
      "r":false,                      // 只减仓
      "po":true,                      // 仅做maker
      "S":"PARTIALLY_FILLED",         // 订单状态
      "e":"0.1",                      // 交易量     
      "ec":"199.3",                   // 交易额
      "f":"2",                        // 手续费 
      "tif": "GTC",                   // 有效时间
      "oty":"LIMIT",                  // 订单类型 目前仅limit
      "fi":[
        {
          "t":"20",                   // 交易id
          "p":"1993",                 // 交易价格
          "q":"0.1",                  // 交易数量
          "T":1657613774336,          // 交易时间
          "m":"MAKER",                // 是否为主动交易
          "f":"0.0002"                // 交易手续费
        }
      ]
    }
  ]
}

当有新订单创建、订单有新成交或者新的状态变化时会推送此类事件 事件类型统一为 ORDER_TRADE_UPDATE

Update Speed: 50ms

做市商接口

做市商接口仅做市商可用，其他用户调用会返回错误。

保证金账户信息

Response:

 {
  "asset": [                  
    {
      "asset": "USDT",                    // 资产
      "marginBalance": "10099.448"        // 账户余额
      "equity": "10094.44662",            // 账户权益
      "available": "8725.92524",          // 账户可用
      "initialMargin": "1084.52138",      // 初始保证金
      "maintMargin": "151.00138",         // 维持保证金
      "unrealizedPNL": "-5.00138",        // 未实现盈亏
      "lpProfit": "-5.00138",             // 多仓未实现盈利
     }
  ], 
  "greek": [
    {
      "underlying":"BTCUSDT"              // 标的资产
      "delta": "-0.05"                    // delta
      "gamma": "-0.002"                   // gamma
      "theta": "-0.05"                    // theta
      "vega": "-0.002"                    // vega  
    }
  ],
  "riskLevel": "NORMAL",                  // 账户风险等级
  "time": 1592449455993                   // 时间  
}  

GET /eapi/v1/marginAccount (HMAC SHA256)

获取保证金账户信息

权重: 3

Parameters:

名称	类型	是否必需	描述
recvWindow	LONG	NO
timestamp	LONG	NO

设置MMP规则

Response:

{
    "underlyingId": 2,
    "underlying": "BTCUSDT",
    "windowTimeInMilliseconds": 3000,
    "frozenTimeInMilliseconds": 300000,
    "qtyLimit": "2",
    "deltaLimit": "2.3",
    "lastTriggerTime": 0

}

POST /eapi/v1/mmpSet (HMAC SHA256)

设置MMP参数。 做市商保护(Market Maker Protection) 是一种为期权做市商设计的保护机制，该机制能够防止做市商的订单在短时间大量成交。一旦某个账户在短时间内的总交易额超过了配置的限额，该账户的做市商保护将被触发。当做市商保护被触发时，账户现有的做市商保护订单（被标记为做市商保护的订单）将被撮合自动取消，而该账户新的做市商保护订单将在冻结期被拒绝。用户可以利用这段时间重新评估行情并修改报价。

权重: 1

Parameters:

名称	类型	是否必需	描述
underlying	STRING	YES	标的资产如BTCUSDT
windowTimeInMilliseconds	LONG	YES	MMP监控时间窗口（毫秒），在(0,5000]之间
frozenTimeInMilliseconds	LONG	NO	MMP冻结时间（毫秒），设置为0后代表账号为冻结状态，需要手动重置
qtyLimit	DECIMAL	NO	数量限制
deltaLimit	DECIMAL	NO	净delta限制
recvWindow	LONG	NO
timestamp	LONG	NO

获取MMP规则

Response:

{
    "underlyingId": 2,
    "underlying": "BTCUSDT",
    "windowTimeInMilliseconds": 3000,
    "frozenTimeInMilliseconds": 300000,
    "qtyLimit": "2",
    "deltaLimit": "2.3",
    "lastTriggerTime": 0

}

GET /eapi/v1/mmpSet (HMAC SHA256)

获取MMP参数

权重: 1

Parameters:

名称	类型	是否必需	描述
underlying	STRING	YES	标的资产如BTCUSDT
recvWindow	LONG	NO
timestamp	LONG	NO

重置MMP状态

Response:

{
    "underlyingId": 2,
    "underlying": "BTCUSDT",
    "windowTimeInMilliseconds": 3000,
    "frozenTimeInMilliseconds": 300000,
    "qtyLimit": "2",
    "deltaLimit": "2.3",
    "lastTriggerTime": 0

}

POST /eapi/v1/mmpReset (HMAC SHA256)

MMP冻结后重置MMP，重新开启MMP下单

Parameters:

名称	类型	是否必需	描述
underlying	STRING	YES	标的资产如BTCUSDT
recvWindow	LONG	NO
timestamp	LONG	NO

设置倒计时取消所有订单配置 (TRADE)

响应:

{
  "underlying": "ETHUSDT",
  "countdownTime": 100000
}

POST /eapi/v1/countdownCancelAll (HMAC SHA256)

此接口用于设置倒计时取消所有订单（包括做市商保护订单与普通订单）配置，即在倒计时结束前心跳没有更新，特定标的资产的所有订单会被取消。若倒计时结束前心跳没有更新，所有的订单将会被取消，同时新订单会返回错误代码-2010。可以通过设置countdownTime为0取消此功能。   权重: 1

参数:

名称	类型	是否必须	描述
underlying	STRING	YES	期权标的资产， 如 BTCUSDT
countdownTime	LONG	YES	以毫秒计量倒计时长 (1000代表1秒)。 设为0时关闭倒计时。最小设为5000（负值无效）
recvWindow	LONG	NO
timestamp	LONG	YES

• 本接口用于配置网络中断情况下自动取消已有订单。
• 使用样例：对特定的标的资产调用本接口（使用参数countdownTime = 10000，10秒）打开自动取消所有订单功能。如果功能开启后任意10秒内没有对该标的资产调用countdownCancelAllHeartBeat接口，则该标的资产上所有订单被去取消。如果调用接口时传参countdownTime = 0，倒计时自动取消订单功能关闭。
• 请注意，系统每隔1000ms（1s）倒计时是否结束，使用此功能时应考虑足够的时间冗余。 我们不建议将倒计时时间设置得太精确或太小。  

获得倒计时自动取消所有订单配置 (TRADE)

响应:

{
  "underlying": "ETHUSDT",
  "countdownTime": 100000
}

GET /eapi/v1/countdownCancelAll (HMAC SHA256)

本接口用于获得倒计时自动取消所有订单配置。接口仅返回有效的自动取消参数，如果标的资产的countdownTime设置为0，该标的资产对应的参数不会被返回。

权重: 1

参数:  

名称	类型	是否必须	描述
underlying	STRING	YES	期权标的资产， 如BTCUSDT
recvWindow	LONG	NO
timestamp	LONG	YES

• 当countdownTime = 0时倒计时取消所有订单功能关闭

重置倒计时取消所有订单心跳 (TRADE)

响应:

{
 "underlyings":["BTCUSDT","ETHUSDT"]
}

POST /eapi/v1/countdownCancelAllHeartBeat (HMAC SHA256)

本接口用户更新倒计时取消所有订单心跳。本接口需要作为心跳更新被频繁调用。将多个标的资产以list形式传入underlyings可以同时更新多个标的资产的心跳。

权重: 10

参数:

名称	类型	是否必须	描述
underlyings	STRING	YES	期权标的资产， 如BTCUSDT
recvWindow	LONG	NO
timestamp	LONG	YES

• 响应仅包含心跳已被更新的标的资产

错误代码

error JSON payload:

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

错误由两部分组成：错误代码和消息。 代码是通用的，但是消息可能会有所不同。

10xx -常规服务器或网络问题

-1000 UNKNOWN

• 处理请求时发生未知错误。

-1001 DISCONNECTED

• 内部错误; 无法处理您的请求。 请再试一次.

-1002 UNAUTHORIZED

• 您无权执行此请求。

-1008 TOO_MANY_REQUESTS

• 排队的请求过多。
• 请求权重过多； 请使用websocket获取实时更新。
• 请求权重过多； 当前限制为每分钟％s请求权重。 请使用websocket进行实时更新，以避免轮询API。
• 请求权重过多； IP被禁止，直到％s。 请使用websocket进行实时更新，以免被禁。

-1014 UNKNOWN_ORDER_COMPOSITION

• 不支持的订单组合。

-1015 TOO_MANY_ORDERS

• 新订单太多。
• 新订单太多； 当前限制为每％s ％s个订单。

-1016 SERVICE_SHUTTING_DOWN

• 该服务不可用。

-1020 UNSUPPORTED_OPERATION

• 不支持此操作。

-1021 INVALID_TIMESTAMP

• 此请求的时间戳在recvWindow之外。
• 此请求的时间戳比服务器时间提前1000毫秒。

-1022 INVALID_SIGNATURE

• 此请求的签名无效。

11xx - 2xxx Request issues

-1100 ILLEGAL_CHARS

• 在参数中发现非法字符。
• 在参数中发现非法字符。％s
• 在参数％s中发现非法字符； 合法范围是％s。

-1101 TOO_MANY_PARAMETERS

• 为此端点发送的参数太多。
• 参数太多； 预期为％s并收到了％s。
• 检测到的参数值重复。

-1102 MANDATORY_PARAM_EMPTY_OR_MALFORMED

• 未发送强制性参数，该参数为空/空或格式错误。
• 强制参数％s未发送，为空/空或格式错误。
• 必须发送参数％s或％s，但两者均为空！

-1103 UNKNOWN_PARAM

• 发送了未知参数。

-1104 UNREAD_PARAMETERS

• 并非所有发送的参数都被读取。
• 并非所有发送的参数都被读取； 读取了％s参数，但被发送了％s。

-1105 PARAM_EMPTY

• 参数为空。
• 参数％s为空。

-1106 PARAM_NOT_REQUIRED

• 不需要时已发送参数。
• 不需要时发送参数％s。

-1111 BAD_PRECISION

• 精度超过为此资产定义的最大值。

-1115 INVALID_TIF

• 无效 timeInForce.

-1116 INVALID_ORDER_TYPE

• 无效订单类型。

-1117 INVALID_SIDE

• 无效买卖方向。

-1118 EMPTY_NEW_CL_ORD_ID

• 新的客户订单ID为空。

-1119 EMPTY_ORG_CL_ORD_ID

• 客户自定义的订单ID为空。

-1120 BAD_INTERVAL

• 无效时间间隔。

-1121 BAD_SYMBOL

• 无效的交易对。

-1125 INVALID_LISTEN_KEY

• 该listenKey不存在。

-1127 MORE_THAN_XX_HOURS

• 查询间隔太大。
• 从开始时间到结束时间之间超过％s小时。

-1128 BAD_CONTRACT

• 无效的期权合约标的。

-1129 BAD_CURRENCY

• 无效的资产类型。

-1130 INVALID_PARAMETER

• 发送的参数为无效数据。
• 发送参数％s的数据无效。

-1131 BAD_RECV_WINDOW

• recvWindow 必须小于 60000

-2010 NEW_ORDER_REJECTED

• 新订单被拒绝

-2013 NO_SUCH_ORDER

• 订单不存在。

-2014 BAD_API_KEY_FMT

• API-key 格式无效。

-2015 INVALID_API_KEY

• 无效的API密钥，IP或操作权限。

-2018 BALANCE_NOT_SUFFICIENT

• 余额不足。

-2027 OPTION_MARGIN_NOT_SUFFICIENT

• 期权可用余额不足。

3xxx-5xxx Filters and other issues

-3029 TRANSFER_FAILED

• 资金划转失败。

-4001 PRICE_LESS_THAN_ZERO

• 价格小于0。

-4002 PRICE_GREATER_THAN_MAX_PRICE

• 价格超过最大值。

-4003 QTY_LESS_THAN_ZERO

• 数量小于0。

-4004 QTY_LESS_THAN_MIN_QTY

• 数量小于最小值。

-4005 QTY_GREATER_THAN_MAX_QTY

• 数量大于最大值。

-4013 PRICE_LESS_THAN_MIN_PRICE

• 价格小于最小价格。

-4029 INVALID_TICK_SIZE_PRECISION

• 价格精度小数点位数不正确。

-4030 INVALID_QTY_PRECISION

• 数量精度小数点位数不正确。

-4055 AMOUNT_MUST_BE_POSITIVE

• 金额必须大于零。

-5005 BLACK_COUNTRY

• 此国家在黑名单上。

-5008 KYC_NOT_PASS

• 用户未通过KYC。

-5009 IP_COUNTRY_BLACK

• IP地址在禁止国家。

-5010 NOT_ENOUGH_POSITION

• 用户没有足够的仓位卖出。