跳到主要内容

更新日志

2024-10-08

COIN-M 期货

  • 请求以下接口时,默认返回最近7天的数据。这些接口的查询时间段必须小于7天:

    • 获取 /dapi/v1/allOrders
    • 获取 /dapi/v1/userTrades
  • 以下接口将进行调整,仅保留最近三个月的数据:

    • 获取 /dapi/v1/order
    • 获取 /dapi/v1/allOrders

2024-09-27

USDⓈ-M 期货

  • 下列websocket用户信息请求被停止使用:
    • listenkey@account
    • listenkey@balance
    • listenkey@position

COIN-M 期货

  • 下列websocket用户信息请求被停止使用:
    • listenkey@account
    • listenkey@balance
    • listenkey@position

2024-09-19

Portfolio Margin

  • 新增杠杆账户还款接口: POST /papi/v1/margin/repay-debt

2024-09-06

Portfolio Margin

  • Portfolio Margin/Trade接口更新(Release date 2024-09-06):

    • POST /papi/v1/um/order: 新增入参priceMatch以支持下单
    • POST/papi/v1/um/conditional/order: 新增入参priceMatch以支持条件单下单
    • PUT /papi/v1/um/order: 新增入参priceMatch以支持改单
  • 以下接口新增返回 priceMatch:

    • POST /papi/v1/um/order
    • POST/papi/v1/um/conditional/order
    • PUT /papi/v1/um/order
    • GET /papi/v1/um/orderAmendment
    • GET /papi/v1/um/order
    • GET /papi/v1/um/openOrder
    • GET /papi/v1/um/openOrders
    • GET /papi/v1/um/allOrders
    • GET /papi/v1/um/conditional/openOrder
    • GET /papi/v1/um/conditional/openOrders
    • GET /papi/v1/um/conditional/orderHistory
    • GET /papi/v1/um/conditional/allOrders
    • DELETE /papi/v1/um/order
    • DELETE /papi/v1/um/conditional/order
  • WEBSOCKET

    • ORDER_TRADE_UPDATECONDITIONAL_ORDER_TRADE_UPDATE 新增pm推送以支持priceMatch

2024-09-05

Portfolio Margin Pro

  • 新增查询统一账户专业版资产阶梯质押率信息的接口:
    • GET /sapi/v2/portfolio/collateralRate

2024-09-03

USDⓈ-M 期货

  • 账户信息推送中新增新增TRADE_LITE事件类型。TRADE_LITE旨在通过精简用户信息数据和仅推送用户已成交的TRADE数据流,从而降低用户数据推送的延迟。相比于现有的ORDER_TRADE_UPDATE事件类型,TRADE_LITE将提供更加敏捷和高效的用户体验。

2024-08-26

USDⓈ-M 期货

  • 新增账户内资产转换接口:
    • GET /fapi/v1/convert/exchangeInfo
    • POST /fapi/v1/convert/getQuote
    • POST /fapi/v1/convert/acceptQuote
    • GET /fapi/v1/convert/orderStatus

2024-08-23

Portfolio Margin

  • 新增查询账户信息的接口:
    • POST /papi/v1/um/feeBurn: BNB UM合约交易抵扣开关。
    • GET /papi/v1/um/feeBurn: 获取UM合约交易 BNB 抵扣开关状态。
  • 新增查询交易信息的接口:
    • GET /papi/v1/um/accountConfig: 查询用户UM账户配置。
    • GET /papi/v1/um/symbolConfig: 查询用户UM交易对配置。
    • GET /papi/v2/um/account: 相较于GET /papi/v1/um/account,此接口仅返回用户有持仓或挂单的交易对。账户/交易对配置相关字段已被移除,现在可以通过 GET /papi/v1/um/symbolConfigGET /papi/v1/um/accountConfig 查询。V2接口还提供了更好的性能。

2024-08-07

USDⓈ-M 期货

  • 以下接口将在2024-09-03进行权重调整:

    • REST API:
      • GET /fapi/v2/balance: 5->10
      • GET /fapi/v2/account: 5->10
      • GET /fapi/v2/positionRisk: 5->10
    • Websocket API:
      • account.status: 5->10
      • account.balance: 5->10
      • account.position: 5->10
  • 将弃用以下WebSocket用户数据请求:

    • <listenKey>@account
    • <listenKey>@balance
    • <listenKey>@position

请参考以下公告进行接口替换和调整

2024-08-06

COIN-M 期货

因统一账户专业版移除notionalLimit限制,GET /dapi/v1/pmExchangeInfo 将于8月6日停用

2024-07-24

USDⓈ-M 期货

REST API

  • 新增查询账户信息的接口:

    • GET /fapi/v1/symbolConfig: 查询用户交易对配置。
    • GET /fapi/v1/accountConfig: 查询用户账户配置。
    • GET /fapi/v3/account: 相较于 GET /fapi/v2/account,此接口仅返回用户有持仓或挂单的交易对。账户/交易对配置相关字段已被移除,现在可以通过 GET /fapi/v1/symbolConfigGET /fapi/v1/accountConfig 查询。V3接口还提供了更好的性能。
    • GET /fapi/v3/balance: 查询用户账户余额。
  • 新增查询交易信息的接口:

    • GET /fapi/v3/positionRisk: 相较于 GET /fapi/v2/positionRisk,此接口仅返回用户有持仓或挂单的交易对。交易对配置相关字段已被移除,现在可以通过 GET /fapi/v1/symbolConfig 查询。V3接口还提供了更好的性能。

WebSocket API

  • 新增查询账户信息的接口:
    • v2/account.status: 相较于 account.status,此接口仅返回用户有持仓或挂单的交易对。配置相关字段已被移除,现在可以通过 GET /fapi/v1/symbolConfigGET /fapi/v1/accountConfig 查询。V2接口还提供了更好的性能。
    • v2/account.balance: 查询用户账户余额。
    • v2/account.position: 相较于 account.position,此接口仅返回用户有持仓或挂单的接口。配置相关字段已被移除,现在可以通过 GET /fapi/v1/symbolConfig 查询。V2接口还提供了更好的性能。

弃用通知:

  • 以下接口将在未来几个月内弃用(具体日期待定)。请切换到上述新接口:
    • REST API:
      • GET /fapi/v2/balance
      • GET /fapi/v2/account
      • GET /fapi/v2/positionRisk
    • Websocket API:
      • account.status
      • account.balance
      • account.position

2024-07-17

统一账户

REST API

  • GET /papi/v1/um/userTrades的响应字段marginAsset将在2024-07-17被移除

2024-06-19

U本位合约

REST API

  • GET /fapi/v1/userTrades的响应字段marginAsset将在2024-07-17被移除

2024-05-22

U本位合约

REST API & Websocket API

  • 新增BNB抵扣开关接口:
    • POST /fapi/v1/feeBurn BNB 合约交易抵扣开关。
    • GET /fapi/v1/feeBurn 获取 BNB 抵扣开关状态。

2024-04-19

U本位合约

REST API & Websocket API

  • 调用PUT /fapi/v1/listenKey或WebSocket api userDataStream.ping时会增加新的返回字段listenKey以显示有效期被延长的listenkey,改动将于2024-04-25生效。
{
"listenKey": "3HBntNTepshgEdjIwSUIBgB9keLyOCg5qv3n6bYAtktG8ejcaW5HXz9Vx1JgIieg"
}

2024-04-09

U本位合约/币本位合约/统一账户

WEBSOCKET API

  • Good-Till-Cancel(GTC)订单变为仅有一年的有效期。 超过一年的GTC订单将被自动取消。改动适用于所有订单类型,包括仅减仓订单(reduceOnly),但不影响部分成交订单或策略交易或跟单交易订单。

2024-04-01

U本位合约

WEBSOCKET API

  • Websocket API 现已推出,可通过以下 URL 访问:“wss://ws-fapi.binance.com/ws-fapi/v1”
  • WebSocket API 允许通过 WebSocket 连接下单、取消订单等。
  • WebSocket API 是独立于 WebSocket 市场数据流的服务。也就是说,下订单和收听市场数据需要两个独立的 WebSocket 连接。
  • WebSocket API 受与 REST API 相同的过滤器和速率限制规则的约束。
  • WebSocket API 和 REST API 在功能上是等效的:它们提供相同的功能,接受相同的参数,返回相同的状态和错误代码。

2024-03-11

U本位合约

REST

  • 新增账户接口:
    • GET /fapi/v1/rateLimit/order: 查询用户下单频率限制

2024-02-09

U本位合约

币安合约在进行 Websocket 服务升级,升级影响以下逻辑:

  • 升级前:

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

    • Websocket 服务器每 3 分钟发送 Ping 消息。
      • 如果 Websocket 服务器在 10 分钟之内没有收到 Pong 消息应答,连接会被断开。
      • 当客户收到 ping 消息,必需尽快回复 pong 消息,同时 payload 需要和 ping 消息一致。
      • 未经请求的 pong 消息是被允许的,但是不会保证连接不断开。对于这些 pong 消息,建议 payload 为空

2024-01-24

U本位合约

测试网 WEBSOCKET

  • testnet的 Websocket baseurl 更新为 "wss://fstream.binancefuture.com"

2024-01-19

统一账户

  • REST

    • 新增 PUT /papi/v1/um/orderPUT /papi/v1/cm/order 接口以支持合约限价订单修改功能
    • 新增 GET /papi/v1/um/orderAmendmentGET /papi/v1/cm/orderAmendment 接口以查询合约订单修改历史

2024-01-11

统一账户

  • 自成交保护(已发布)

  • U 本位合约系统中将支持 Self-Trade Prevention(STP)自成交保护。此功能将阻止订单与来自同一账户或者同一 tradeGroupId 账户的订单交易。详情请参考 FAQ

  • 合约所有交易对支持通过下单时设置selfTradePreventionMode为下面之一的 STP 模式:

    • NONE: 不设置自成交保护
    • EXPIRE_TAKER: 自成交过期 taker 订单
    • EXPIRE_MAKER: 自成交过期 maker 订单
    • EXPIRE_BOTH: 自成交过期 taker 和 maker 订单
  • REST 更新:

    • 新的订单状态:EXPIRED_IN_MATCH - 订单由于 STP 触发而过期

    • /papi/v1/um/account 中响应新增字段tradeGroupId显示用户的 tradeGroupId

    • 以下接口新增可选参数selfTradePreventionMode以设置该订单的自成交保护模式:

      • POST /papi/v1/um/order
      • POST/papi/v1/um/conditional/order
      • POST /papi/v1/margin/order
      • POST /papi/v1/margin/order/oco
    • 以下接口新增响应字段selfTradePreventionMode以显示订单的自成交保护模式:

      • POST /papi/v1/um/order

      • POST/papi/v1/um/conditional/order

      • GET /papi/v1/um/order

      • GET /papi/v1/um/openOrder

      • GET /papi/v1/um/openOrders

      • GET /papi/v1/um/allOrders

      • GET /papi/v1/um/conditional/openOrder

      • GET /papi/v1/um/conditional/openOrders

      • GET /papi/v1/um/conditional/orderHistory

      • GET /papi/v1/um/conditional/allOrders

      • DELETE /papi/v1/um/order

      • DELETE /papi/v1/um/conditional/order

      • DELETE /papi/v1/margin/order

      • DELETE /papi/v1/margin/allOpenOrders

      • DELETE /papi/v1/margin/orderList

      • GET /papi/v1/margin/order

      • GET /papi/v1/margin/allOrders

      • GET /papi/v1/margin/orderList

      • GET /papi/v1/margin/allOrderList

      • GET /papi/v1/margin/openOrderList

  • WEBSOCKET 账户信息推送更新:

    • ORDER_TRADE_UPDATECONDITIONAL_ORDER_TRADE_UPDATE中新增字段V显示用户订单的自成交保护模式
    • executionReport中新增以下字段
      • u - tradeGroupId
      • v - preventedMatchId
      • U - counterOrderId
      • A - preventedQuantity
      • B - lastPreventedQuantity
  • 有效方式 GTD(已发布)

  • U 本位合约系统中将支持有效方式 GTD(Good Till Date)。有效方式(TIF)为 GTD 的订单到goodTillDate时间仍未完结会被自动取消

  • REST 更新:

    • 以下接口新增响应字段goodTillDate以配置 GTD 订单过期时间: _ POST /papi/v1/um/order _ POST/papi/v1/um/conditional/order
    • 以下接口新增响应字段goodTillDate以显示 GTD 订单过期时间: _ POST /papi/v1/um/order _ POST/papi/v1/um/conditional/order _ GET /papi/v1/um/order _ GET /papi/v1/um/openOrder _ GET /papi/v1/um/openOrders _ GET /papi/v1/um/allOrders _ GET /papi/v1/um/conditional/openOrder _ GET /papi/v1/um/conditional/openOrders _ GET /papi/v1/um/conditional/orderHistory _ GET /papi/v1/um/conditional/allOrders _ DELETE /papi/v1/um/order _ DELETE /papi/v1/um/conditional/order
  • Websocket 账户信息推送更新:

    ORDER_TRADE_UPDATECONDITIONAL_ORDER_TRADE_UPDATE中新增字段 `goodTillDate`` 显示用户 GTD 订单的自动取消时间

  • 盈亏平衡价(已发布)

  • REST 更新

    • 以下接口返回新增breakEvenPrice字段代表仓位盈亏平衡价: _ GET /papi/v1/um/account _ GET /papi/v1/um/positionRisk _ GET /papi/v1/cm/account _ GET /papi/v1/cm/positionRisk
  • WEBSOCKET 更新

    • Position 更新推送 payloadACCOUNT_UPDATE 中 P 新增 bep 字段代表仓位盈亏平衡价

2024-01-08

U本位合约

REST

  • 账号与交易接口更新(将于 2023-01-11 更新):
    • PUT /fapi/v1/order: 新增入参priceMatch以支持改单价格保护
    • PUT /fapi/v1/batchOrders: 新增入参priceMatch以支持改单价格保护
    • 改单会保留该订单原有的selfTradePreventionMode

2023-12-12

U本位合约

WEBSOCKET

  • 行情推送!bookTicker的更新速度将从实时更改为每 5 秒一次,该更改将从 2023 年 12 月 20 日开始。单个交易对的 Book Ticker 流<symbol>@bookticker不会受到此次更新的影响。

2023-11-15

U本位合约

REST

  • 新增市场数据接口:
    • GET /fapi/v2/ticker/price: 查询最新价格 v2 接口。与GET /fapi/v1/ticker/price相比,v2 接口入参和响应相同,但接口延迟更低且占用限频更少。GET /fapi/v1/ticker/price将在未来被弃用,时间待定

WEBSOCKET

  • 币安合约将于 2023-12-15 06:00 停用wss://fstream-auth.binance.com域名,建议 API 用户在此时间前迁移 websocket 连接到wss://fstream.binance.com。需要特别注意的是,wss://fstream.binance.com的连接方法与wss://fstream-auth.binance.com不同,例如:
    • wss://fstream-auth.binance.com/ws/<ListenKey>?listenKey=<ListenKey> should change to wss://fstream.binance.com/ws/<ListenKey>

2023-11-01

币本位合约

REST

  • GET dapi/v1/fundingRate更新:
    • 增加返回字段markPrice以显示特定资金费对应的标记价格

2023-11-01

U本位合约

REST

  • 新增市场数据接口:
    • GET /futures/data/basis: 查询基差
  • GET /fapi/v1/fundingRate更新:
    • 增加返回字段markPrice以显示特定资金费对应的标记价格

2023-10-19

币本位合约

REST

  • 新增行情接口:
    • GET /futures/data/delivery-price: 查询季度合约历史交割价格
  • 调整下列接口限频为 1000/5min/IP:
    • GET /futures/data/openInterestHist
    • GET /futures/data/topLongShortAccountRatio
    • GET /futures/data/topLongShortPositionRatio
    • GET /futures/data/globalLongShortAccountRatio
    • GET /futures/data/takerlongshortRatio

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-10-19

U本位合约

REST

  • 新增行情接口:
    • GET /futures/data/delivery-price: 查询季度合约历史交割价格
  • 调整下列接口限频为 1000/5min/IP:
    • GET /futures/data/openInterestHist
    • GET /futures/data/topLongShortAccountRatio
    • GET /futures/data/topLongShortPositionRatio
    • GET /futures/data/globalLongShortAccountRatio
    • GET /futures/data/takerlongshortRatio
  • 调整下列接口限频为 500/5min/IP:
    • GET /fapi/v1/fundingRate
    • GET /fapi/v1/fundingInfo

2023-10-16

币本位合约

REST

  • 新增行情接口:
    • GET /dapi/v1/constituents: 查询指数成分

2023-10-16

U本位合约

REST

  • 新增行情接口:
    • GET /fapi/v1/constituents: 查询指数成分

2023-10-11

U本位合约

REST

  • 账户接口 IP 权重调整:
    • GET /fapi/v1/income/asyn: 5->1000
    • GET /fapi/v1/order/asyn: 5->1000
    • GET /fapi/v1/trade/asyn: 5->1000
    • GET /fapi/v1/income/asyn/id: 5->10
    • GET /fapi/v1/order/asyn/id: 5->10
    • GET /fapi/v1/trade/asyn/id: 5->10

2023-09-25

币本位合约

REST

  • 新增行情接口:
    • GET /dapi/v1/fundingInfo: 查询有调整的资金费率信息

2023-09-25

U本位合约

REST

  • 新增行情接口:
    • GET /fapi/v1/fundingInfo: 查询有调整的资金费率信息

2023-09-20

币本位合约

REST

  • GET /dapi/v1/ticker/bookTicker更新:

    • 增加返回字段lastUpdateId
  • GET /dapi/v1/account更新:

    • assets中增加返回字段updateTime

2023-09-20

U本位合约

REST

  • GET /fapi/v1/ticker/bookTicker更新:
    • 增加返回字段lastUpdateId

2023-09-19

U本位合约

{
"code": -1008,
"msg": "Server is currently overloaded with other requests. Please try again in a few minutes."
}
  • 新增 HTTP503可能的错误响应及错误码,下列接口在请求高峰期可能出现此响应:
    • POST /fapi/v1/order
    • PUT /fapi/v1/order
    • DELETE /fapi/v1/order
    • POST /fapi/v1/batchOrder
    • PUT /fapi/v1/batchOrder
    • DELETE /fapi/v1/batchOrder
    • POST /fapi/v1/order/test
    • DELETE /fapi/v1/allOpenOrders
  • 此响应表示本次 API 请求失败。这种情况下您如果需要的话可以选择立即重试。

2023-09-07

币本位合约

REST

  • 新增接口GET /dapi/v1/income/asyn 获取合约资金流水下载 id
  • 新增接口GET /dapi/v1/income/asyn/id 通过下载 id 获取合约资金流水下载链接

2023-09-05

U本位合约

  • 根据此公告,自成交保护(Self-Trade Prevention)已于 2023-09-05 发布。
  • 价格匹配/有效方式 GTD/盈亏平衡价等功能(详情见 2023-08-29 更新日志)已于2023-09-05 发布。

2023-09-04

统一账户

  • 接口字段更新:

    • GET /papi/v1/um/positionRisk: 新增响应字段liquidationPrice
    • GET /papi/v1/cm/positionRisk: 新增响应字段 liquidationPrice
    • GET /papi/v1/um/leverageBracket: 新增响应字段 notionalCoef
    • GET /papi/v1/cm/leverageBracket: 新增响应字段 notionalCoef
  • Websocket 账户信息推送字段更新:

    • outboundAccountPosition事件新增字段更新 IdU
    • balanceUpdate事件新增字段更新 IdU

2023-09-04

统一账户

2023-09-07 发布

  • papi 的 order ratelimit 从 2400 orders/min 降低为 1200 orders/min,受影响的接口:
    • POST /papi/v1/um/order
    • POST /papi/v1/cm/order
    • POST /papi/v1/margin/order
    • POST /papi/v1/margin/order/oco
    • POST /papi/v1/um/conditional/order
    • POST /papi/v1/cm/conditional/order

2023-08-31

币本位合约

币安合约在进行 Websocket 服务升级,升级影响以下逻辑:

  • 升级前:

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

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

2023-08-31

U本位合约

币安合约在进行 Websocket 服务升级,升级影响以下逻辑:

  • 升级前:

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

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

2023-08-29

欧式期权

REST

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

Websocket 用户信息流

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

2023-08-29

U本位合约

  • 自成交保护(发布时间待定)

  • U 本位合约系统中将支持 Self-Trade Prevention(STP)自成交保护。此功能将阻止订单与来自同一账户或者同一 tradeGroupId 账户的订单交易。详情请参考 FAQ

  • 合约所有交易对支持通过下单时设置selfTradePreventionMode为下面之一的 STP 模式:

    • NONE: 不设置自成交保护
    • EXPIRE_TAKER: 自成交过期 taker 订单
    • EXPIRE_MAKER: 自成交过期 maker 订单
    • EXPIRE_BOTH: 自成交过期 taker 和 maker 订单
  • REST 更新:

    • 新的订单状态:EXPIRED_IN_MATCH - 订单由于 STP 触发而过期
      • GET /fapi/v2/account中响应新增字段tradeGroupId显示用户的 tradeGroupId
    • 以下接口新增可选参数selfTradePreventionMode以设置该订单的自成交保护模式:
      • POST /fapi/v1/order
      • POST /fapi/v1/batchOrders
    • 以下接口新增响应字段selfTradePreventionMode以显示订单的自成交保护模式:
      • POST /fapi/v1/order
      • POST /fapi/v1/batchOrders
      • POST /fapi/v1/order
      • POST /fapi/v1/order
      • GET /fapi/v1/order
      • GET /fapi/v1/openOrders
      • GET /fapi/v1/allOrders
      • PUT /fapi/v1/order
      • PUT /fapi/v1/batchOrders
      • DELETE /fapi/v1/order
      • DELETE /fapi/v1/batchOrders
  • WEBSOCKET 账户信息推送更新:

    • ORDER_TRADE_UPDATE中新增字段V显示用户订单的自成交保护模式

2023-08-25

币本位合约

  • 币安合约在进行 Websocket 服务升级,升级影响以下连接方式:
    • 无信息流订阅连接 Websocket 服务:
      • 升级前, 用户可以用以下方式连接:
        • wss://dstream.binance.com/ws
        • wss://dstream.binance.com/stream
        • wss://dstream.binance.com/ws/
        • wss://dstream.binance.com/stream/
      • 升级后,用户可以用以下方式连接:
        • wss://dstream.binance.com/ws
        • wss://dstream.binance.com/stream
        • / 在 url 结尾不再支持
    • 带信息流订阅连接 Websocket 服务:
      • 不支持如下类型的 stream:wss://fstream.binance.com/illegal_parameter/stream?steams=<streamName>wss://fstream.binance.com/illegal_parameter/ws/<streamName>,请移除 /ws/stream前的illegal_parameter/

2023-08-19

U本位合约

  • 币安合约在进行 Websocket 服务升级,升级影响以下连接方式:
    • 无信息流订阅连接 Websocket 服务:
      • 升级前, 用户可以用以下方式连接:
        • wss://fstream.binance.com/ws
        • wss://fstream.binance.com/stream
        • wss://fstream.binance.com/ws/
        • wss://fstream.binance.com/stream/
      • 升级后,用户可以用以下方式连接:
        • wss://fstream.binance.com/ws
        • wss://fstream.binance.com/stream
        • / 在 url 结尾不再支持
    • 带信息流订阅连接 Websocket 服务:
      • 不支持如下类型的 stream:wss://fstream.binance.com/illegal_parameter/stream?steams=<streamName>wss://fstream.binance.com/illegal_parameter/ws/<streamName>,请移除 /ws/stream前的illegal_parameter/

2023-08-18

统一账户

  • 新增查询接口:
    • GET /papi/v1/margin/order: 杠杆下单
    • GET /papi/v1/margin/openOrders: 查询杠杆账户挂单记录
    • GET /papi/v1/margin/allOrders: 查询杠杆账户的所有订单
    • GET /papi/v1/margin/orderList: 查询杠杆账户 OCO
    • GET /papi/v1/margin/allOrderList: 查询特定杠杆账户所有 OCO
    • GET /papi/v1/margin/openOrderList: 查询杠杆账户 OCO 挂单
    • GET /papi/v1/margin/myTrades: 查询杠杆账户交易历史

2023-08-14

币本位合约

  • 更新账户和交易接口:
    • GET /dapi/v1/income:增加字段page用以分页

2023-08-14

U本位合约

  • 更新账户和交易接口:
    • GET /fapi/v1/income:增加字段page用以分页

2023-07-28

统一账户

  • 新增账户接口:
    • POST /papi/v1/asset-collection: 特定资产资金归集

2023-07-21

欧式期权

REST

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

2023-07-20

统一账户

  • 新增账户接口:
    • GET /papi/v1/um/adlQuantile: UM 持仓 ADL 队列估算
    • GET /papi/v1/cm/adlQuantile: CM 持仓 ADL 队列估算

2023-07-19

币本位合约

REST

  • GET /dapi/v2/leverageBracket 新增字段notionalCoef显示用户相对默认 bracket 的调整倍数

2023-07-18

统一账户

  • 新增统一账户账户接口:
    • POST /papi/v1/repay-futures-switch: 更改自动清还合约负余额模式
    • GET /papi/v1/repay-futures-switch: 查询自动清还合约负余额模式
    • POST /papi/v1/repay-futures-negative-balance: 清还合约负余额

2023-07-18

U本位合约

REST

  • GET /fapi/v1/leverageBracket 新增字段notionalCoef显示用户相对默认 bracket 的调整倍数

2023-07-13

欧式期权

Websocket Market Streams

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

2023-07-13

统一账户

  • 新增用户数据推送riskLevelChange(2023-7-14 生效)

2023-07-12

币本位合约

REST

  • 以下接口返回新增breakEvenPrice字段代表仓位盈亏平衡价:
    • GET /dapi/v1/account (HMAC SHA256)
    • GET /dapi/v1/positionRisk (HMAC SHA256)

WEBSOCKET

  • Position 更新推送 payload ACCOUNT_UPDATE中"P"新增bep字段代表仓位盈亏平衡价

2023-07-11

统一账户

REST

  • 增加新接口POST /papi/v1/ping 测试服务器连通性

2023-07-04

U本位合约

REST

  • 以下接口将改为仅保留最近 3 个月数据:
    • GET /fapi/v1/order(2023-07-27 生效)
    • GET /fapi/v1/allOrders(2023-07-27 生效)
    • GET /fapi/v1/userTrades(具体时间待定)
  • 请自行维护和保留 3 个月之前的历史数据或使用以下新接口获得历史订单/交易信息:
    • 新增接口GET /fapi/v1/order/asyn 获取合约订单历史下载 id
    • 新增接口GET /fapi/v1/order/asyn/id 通过下载 id 获取合约订单历史下载链接
    • 新增接口GET /fapi/v1/trade/asyn 获取合约交易历史下载 id
    • 新增接口GET /fapi/v1/trade/asyn/id 通过下载 id 获取合约交易历史下载链接

2023-06-28

U本位合约

注意:

REST

  • 以下接口将于 2023-07-15 后不再支持:
    • GET /fapi/v1/account
    • GET /fapi/v1/balance
    • GET /fapi/v1/positionRisk
  • 请及时替换为对应的 v2 接口:
    • GET /fapi/v2/account
    • GET /fapi/v2/balance
    • GET /fapi/v2/positionRisk

2023-06-22

币本位合约

注意:

WEBSOCKET

  • 订阅格式 /ws?<streamName> 不被支持, 如wss://dstream.binance.com/ws?btcusd@depth 会被认为是非法请求.
  • 发送带有不合法 JSON 格式的 websocket 消息将导致连接断开,返回错误{"error":{"code":3,"msg":"Invalid JSON: expected value at line 1 column 1"}}

2023-06-22

U本位合约

注意:

WEBSOCKET

  • 订阅格式 /ws?<streamName> 不被支持, 如wss://fstream.binance.com/ws?btcusdt@depth 会被认为是非法请求.
  • 发送带有不合法 JSON 格式的 websocket 消息将导致连接断开,返回错误{"error":{"code":3,"msg":"Invalid JSON: expected value at line 1 column 1"}}

2023-06-19

统一账户

REST

  • POST /papi/v1/um/conditional/orderPOST/papi/v1/cm/conditional/order新增参数CONTRACT_PRICEpriceProtect

2023-06-16

U本位合约

注意:

  • 建议使用标准的 HTTP 请求格式,fapi 中将不支持非标准请求格式。以下是一些正确的代码实践示例:

    • 不再支持使用 '\x22' 进行转义("),请改用标准的 '%22',需要对中括号[]和中括号内部的双引号进行 URL encode DELETE /fapi/v1/batchOrders?origClientOrderIdList= 不支持: [\x229151944646313025900\x22] 建议: ["9151944646313025900"] --经过 URL 编码后-- DELETE /fapi/v1/batchOrders?origClientOrderIdList=%5B%229151944646313025900%22%5D

    • 不支持非标准嵌套 JSON 格式

      POST /fapi/v1/batchOrders?batchOrders=

      不支持:

      ["{"type":"LIMIT","timeInForce":"GTC"}"]

      建议:

      [{"type":"LIMIT","timeInForce":"GTC"}]

      --经过 URL 编码后--

      POST /fapi/v1/batchOrders?batchOrders=%5B%7B%22type%22%3A%22LIMIT%22%2C%22timeInForce%22%3A%22GTC%22%7D%5D

    • 不支持使用不正确的数据类型

      DELETE /fapi/v1/batchOrders?orderIdList=

      由于 'orderIdList' 参数的数据类型为 LIST<LONG> 不支持:

      ["159856286502","159856313662"]

      建议:

      [159856286502,159856313662]

      --经过 URL 编码后--

      DELETE /fapi/v1/batchOrders?orderIdList=%5B159856286502%2C159856313662%5D

    • 不支持从请求参数中的无效空白字符

      不支持:

      POST symbol=BTCUSDT& price= 40000.0 & signature=2d24a314

      建议:

      POST symbol=BTCUSDT&&price=40000.0&signature=2d24a314

    • 不支持请求参数传空值

      不支持:

      GET symbol=BTCUSDT&orderId=&signature=2d24a314

      建议:

      GET symbol=BTCUSDT&signature=2d24a314


2023-06-14

币本位合约

WEBSOCKET

  • <symbol>@markPrice and <pair>@markPrice中新增指数i字段

2023-06-14

U本位合约

注意:

  • 新增市场信息流 !assetIndex@arrOR<assetSymbol>@assetIndex推送多资产模式资产指数价格

2023-06-01

统一账户

REST

  • 下列接口将于 2023-06-02 生效:
    • New endpoints GET /papi/v1/um/income and GET /papi/v1/cm/income to query portfolio margin UM/CM income history
    • New endpoints GET /papi/v1/um/account and GET /papi/v1/cm/account to query portfolio margin UM/CM account history

2023-05-31

U本位合约

WEBSOCKET

  • 新增账户信息流:
    • 新增推送 CONDITIONAL_ORDER_TRIGGER_REJECT 以显示被触发的止盈止损单被拒绝原因

2023-05-30

欧式期权

General Information on Endpoints

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

2023-05-24

U本位合约

REST

  • 因统一账户专业版移除notionalLimit限制,GET /fapi/v1/pmExchangeInfo将于 5 月 29 日停用

2023-05-05

U本位合约

REST

  • 新增 PUT /fapi/v1/orderPUT /fapi/v1/batchOrders 接口以支持限价订单修改功能
  • 新增 GET /fapi/v1/orderAmendment 接口以查询订单修改历史

WEBSOCKET

  • 订单/交易 更新推送 ORDER_TRADE_UPDATE 中本次事件的具体执行类型 x 新增 "AMENDMENT" 代表订单修改

2023-05-04

统一账户

  • 新增统一账户文档

2023-04-17

币本位合约

发布日期待确定

recvWindow 校验也将在订单到达撮合后进行。recvWindow 校验在下单相关接口更加精确。

{
"code": -4188,
"msg": "Timestamp for this request is outside of the ME recvWindow"
}

发布前 recvWindow 逻辑:

  • 下单类请求在 recvWindow + timestamp => REST API 服务器timestamp时有效

发布后 recvWindow 逻辑:

  • 新增校验:下单类请求在 recvWindow + timestamp => 撮合timestamp时有效

  • 受影响接口:

    • POST /dapi/v1/order (HMAC SHA256)
    • PUT /dapi/v1/order (HMAC SHA256)
    • POST /dapi/v1/batchOrders (HMAC SHA256)
    • PUT /dapi/v1/batchOrders (HMAC SHA256)

2023-04-17

U本位合约

发布日期 2023-04-18

recvWindow 校验也将在订单到达撮合后进行。recvWindow 校验在下单相关接口更加精确。

{
"code": -5028,
"msg": "Timestamp for this request is outside of the ME recvWindow"
}

发布前 recvWindow 逻辑:

  • 下单类请求在 recvWindow + timestamp => REST API 服务器timestamp时有效

发布后 recvWindow 逻辑:

  • 新增校验:下单类请求在 recvWindow + timestamp => 撮合timestamp时有效

  • 受影响接口:

    • POST /fapi/v1/order
    • PUT /fapi/v1/order
    • POST /fapi/v1/batchOrders
    • PUT /fapi/v1/batchOrders

2023-03-28

U本位合约

发布前推荐返佣逻辑:

  • 每笔交易实时返佣,用户会在 USER-DATA-STREAM 的 ACCOUNT_UPDATE 事件中收到如下推送:
{
"e": "ACCOUNT_UPDATE",
"T": 1679974782150,
"E": 1679974782155,
"a": {
"B": [
{
"a": "USDT",
"wb": "685.31478079",
"cw": "677.17212454",
"bc": "0.00258637"
}
],
"P": [],
"m": "ADMIN_DEPOSIT"
}
}

发布后推荐返佣逻辑:

  • 每 20 分钟聚合一次计算返佣上账,用户会在 USER-DATA-STREAM 的 ACCOUNT_UPDATE 事件中收到相同推送,余额变化为聚合后的返佣加总。

2023-03-08

U本位合约

发布日期 2023-03-22

发布前订单逻辑:

  • 下单时传参 timeInForceFOKGTX(Post-only),用户会收到订单返回 status = “NEW” 并收到推送 order_trade_update消息x = “NEW”, X = “NEW”。 如果订单不满足执行条件,用户会收到另一条 order_trade_update 消息,其x = “EXPIRED”, X = “EXPIRED”。 该订单可以在GET /fapi/v1/orderGET /fapi/v1/allOrders查到。
{
"code": -5021,
"msg": "Due to the order could not be filled immediately, the FOK order has been rejected. The order will not be recorded in the order history"
}

发布后订单逻辑:

  • 下单时传参 timeInForceFOKGTX(Post-only),如果该订单不满足执行条件,订单会被直接拒绝并收到报错信息,order_trade_update不会推送此订单的消息。该订单不能在GET /fapi/v1/orderGET /fapi/v1/allOrders中查到。
{
"code": -5022,
"msg": "Due to the order could not be executed as maker, the Post Only order will be rejected. The order will not be recorded in the order history"
}
  • 受影响接口:
    • POST /fapi/v1/order
    • POST /fapi/v1/batchOrders
    • GET /fapi/v1/order
    • GET /fapi/v1/allOrders

2023-02-02

欧式期权

REST

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

2023-01-11

欧式期权

REST

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

2023-01-04

U本位合约

WEBSOCKET

  • Order Update: 订单状态中删除NEW_INSURANCE风险保障基金(强平)与NEW_ADL自动减仓序列(强平)

2022-12-16

币本位合约

WEBSOCKET

  • 新增订阅信息流 !contractInfo 获取交易对信息更新

2022-12-16

U本位合约

WEBSOCKET

  • 新增订阅信息流 !contractInfo 获取交易对信息更新

2022-12-13

欧式期权

WEBSOCKET

  • <symbol>@depth1000中新增字段upu以获取增量 orderbook 更新

2022-12-09

欧式期权

REST

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

2022-11-29

币本位合约

WEB SOCKET USER DATA STREAM

  • USER-DATA-STREAM 中新增事件STRATEGY_UPDATE: 在策略交易创建、取消、失效等等时候更新。
  • USER-DATA-STREAM 中新增事件GRID_UPDATE: 在网格子订单有部份或是完全成交时更新。

2022-11-29

U本位合约

WEB SOCKET USER DATA STREAM

  • USER-DATA-STREAM 中新增事件STRATEGY_UPDATE: 在策略交易创建、取消、失效等等时候更新。
  • USER-DATA-STREAM 中新增事件GRID_UPDATE: 在网格子订单有部份或是完全成交时更新。

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-10-13

币本位合约

注意: 此变动会在 2022-10-17 生效

REST RATE LIMIT WEIGHT

接口 GET /dapi/v1/ticker/bookTicker

权重更新:

  • 单交易对2
  • 无交易对5

2022-10-13

U本位合约

注意: 此变动会在 2022-10-17 生效

REST RATE LIMIT WEIGHT

接口 GET /fapi/v1/ticker/bookTicker

权重更新:

  • 单交易对2
  • 无交易对5

2022-09-22

币本位合约

  • 新增统一账户接口:
    • GET /dapi/v1/pmAccountInfo:查询统一账户当前账户信息。

2022-09-22

U本位合约

  • 更新账户和交易接口:
    • GET /fapi/v1/income:支持更多收益类型
  • 新增统一账户接口:
    • GET /fapi/v1/pmAccountInfo:查询统一账户当前账户信息。

2022-09-20

欧式期权

WEBSOCKET

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

2022-09-14

欧式期权

REST

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

2022-09-05

欧式期权

REST

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

2022-07-27

币本位合约

REST RATE LIMIT WEIGHT

  • 接口 GET /dapi/v1/trades 的请求权重更新为 5

2022-07-27

U本位合约

REST RATE LIMIT WEIGHT

  • 接口 GET /fapi/v1/trades 的请求权重更新为 5

2022-06-28

币本位合约

REST

  • 新增接口 GET /dapi/v1/pmExchangeInfo 获取统一账户交易规则

2022-06-28

U本位合约

REST

  • 新增接口 GET /fapi/v1/pmExchangeInfo 获取统一账户交易规则

2022-04-28

币本位合约

REST

  • 新增 PUT /dapi/v1/orderPUT /dapi/v1/batchOrders 接口以支持限价订单修改功能
  • 新增 GET /dapi/v1/orderAmendment 接口以查询订单修改历史

WEBSOCKET

  • 订单/交易 更新推送 ORDER_TRADE_UPDATE 中本次事件的具体执行类型 x 新增 "AMENDMENT" 代表订单修改

2022-04-14

币本位合约

WEB SOCKET USER DATA STREAM

  • USER-DATA-STREAM 中新增事件ACCOUNT_CONFIG_UPDATE以获取交易对杠杆倍数变动更新

2022-03-01

U本位合约

REST

  • 新增接口GET /fapi/v1/income/asyn 获取合约资金流水下载 id
  • 新增接口GET /fapi/v1/income/asyn/id 通过下载 id 获取合约资金流水下载链接

2022-02-18

币本位合约

REST

  • 查询账户成交历史接口GET /dapi/v1/userTrades接口参数limit的最大值调整至 1000

2022-02-10

U本位合约

REST

  • 更新GET /fapi/v2/account接口:
    • 若用户开启多资产模式,totalInitialMargin``totalMaintMargin``totalWalletBalance``totalUnrealizedProfit``totalMarginBalance``totalPositionInitialMargin``totalOpenOrderInitialMargin``totalCrossWalletBalance``totalCrossUnPnl``availableBalance``maxWithdrawAmount 计入各种资产并转化为其 USD 价值显示
    • 若用户使用单资产模式, 仅 USDT 资产会被计入计算(和改动前一致)

2021-12-30

U本位合约

WEBSOCKET

  • 新增 WEBSOCKET 连接方式:
    • Base Url:wss://fstream-auth.binance.com
    • 订阅单一 stream 格式为 /ws/<streamName>?listenKey=<validateListenKey>
    • 组合 streams 的 URL 格式为 /stream?streams=<streamName1>/<streamName2>/<streamName3>&listenKey=<validateListenKey>
    • <validateListenKey>在建立连接时,必须为一个有效的 listenKey
  • 详细说明见 Websocket 行情推送Websocket 账户信息推送

2021-11-02

U本位合约

REST

  • 新增接口GET /fapi/v1/assetIndex以获取多资产模式保证金资产汇率指数

2021-08-18

币本位合约

REST

  • GET /dapi/v1/account 响应内容加入 positionAmt 以表示持仓数量

2021-08-17

币本位合约

REST

  • 新增 PUT /dapi/v1/orderPUT /dapi/v1/batchOrders 接口以支持限价订单修改功能
  • 新增 GET /dapi/v1/orderAmendment 接口以查询订单修改历史

WEBSOCKET

  • 订单/交易 更新推送 ORDER_TRADE_UPDATE 中本次事件的具体执行类型 x 新增 "AMENDMENT" 代表订单修改

2021-07-23

币本位合约

REST

  • GET /dapi/v1/accountGET /dapi/v1/positionRisk响应内容加入updateTime以表示资产,仓位的最新更新时间

2021-07-06

币本位合约

REST

  • GET /dapi/v1/exchangeInfo 响应内容增加以下字段:
    • "liquidationFee" 表示强平费率
    • "marketTakeBound" 表示市价吃单(相对于标记价格)允许可造成的最大价格偏离比例

2021-07-06

U本位合约

REST

  • GET /fapi/v2/accountGET /fapi/v2/positionRisk响应内容加入updateTime以表示资产,仓位的最新更新时间
  • GET /fapi/v1/exchangeInfo 响应内容增加以下字段:
    • "liquidationFee" 表示强平费率
    • "marketTakeBound" 表示市价吃单(相对于标记价格)允许可造成的最大价格偏离比例

2021-06-15

U本位合约

WEBSOCKET

  • 综合指数交易对信息流 <symbol>@compositeIndex 新增返回字段 "q" 表示报价资产, "i" 表示指数价格

REST

  • 更新以下接口:
    • GET /fapi/v1/indexInfo 响应加入component成分资产,quoteAsset报价资产字段

2021-05-06

币本位合约

WEBSOCKET

  • "ACCOUNT_UPDATE" 事件新增返回字段 "bc" 表示账户余额改变量。

2021-05-06

U本位合约

WEBSOCKET

  • 更新以下接口:
    • 原有杠杆倍数更新推送事件ACCOUNT_CONFIG_UPDATE扩展为账户配置更新推送事件,包含杠杆倍数与联合保证金状态更新推送
    • Balance 和 Position 更新推送ACCOUNT_UPDATE的事件m枚举类型新增AUTO_EXCHANGE代表联合保证金自动兑换事件

REST

  • 新增以下接口:

    • POST /fapi/v1/multiAssetsMargin 以更改联合保证金模式
    • GET /fapi/v1/multiAssetsMargin 以查询联合保证金模式
  • 更新以下接口:

    • GET /fapi/v1/exchangeInfo 响应加入assets资产信息
    • GET /fapi/v2/balanceGET /fapi/v2/account 响应加入marginAvailable字段代表是否可用作联合保证金

2021-04-27

币本位合约

WEBSOCKET

  • 以下市场强平订单推送事件由实时推送调整为快照推送,即每秒最多推送一条强平订单数据:
    • <symbol>@forceOrder
    • !forceOrder@arr

REST

  • 获取市场强平订单接口 GET /dapi/v1/allForceOrders停止维护,不再接受请求

2021-04-27

U本位合约

WEBSOCKET

  • 以下市场强平订单推送事件由实时推送调整为快照推送,即每秒最多推送一条强平订单数据:
    • <symbol>@forceOrder
    • !forceOrder@arr

REST

  • 获取市场强平订单接口 GET /fapi/v1/allForceOrders停止维护,不再接受请求

2021-04-22

U本位合约

WEBSOCKET

  • "ACCOUNT_UPDATE" 事件新增返回字段 "bc" 表示账户余额改变量。

2021-03-10

币本位合约

REST

  • 接口 GET /dapi/v1/allForceOrders 的查询时间范围最大为 7 天(默认查询最近 7 天内的数据)

2021-03-02

U本位合约

  • 新增接口 GET /fapi/v1/indexPriceKlines 以获取价格指数 K 线数据。

  • 新增接口 GET /fapi/v1/markPriceKlines 以获取标记价格 K 线数据。


2021-02-24

U本位合约

REST RATE LIMIT WEIGHT

  • 接口 GET /fapi/v2/balance 的请求权重更新为 5
  • 接口 GET /fapi/v2/positionRisk 的请求权重更新为 5

2021-02-22

U本位合约

REST RATE LIMIT WEIGHT

  • 接口 GET /fapi/v1/income 的请求权重更新为 30

REST

  • 接口GET /fapi/v1/allOrders 的查询时间范围最大为 7 天.
  • 接口GET /fapi/v1/allForceOrders的查询范围仅限于最近 7 天内的数据.

2021-01-26

币本位合约

REST RATE LIMIT WEIGHT

  • 以下接口的权重调整为 带 symbol 20, 不带 symbol 50
    • GET /dapi/v1/allForceOrders
    • GET /dapi/v1/forceOrders

2021-01-26

U本位合约

WEB SOCKET USER DATA STREAM

  • USER-DATA-STREAM 中新增事件ACCOUNT_CONFIG_UPDATE以获取交易对杠杆倍数变动更新

REST RATE LIMIT WEIGHT

  • 以下接口的权重调整为 带 symbol 20, 不带 symbol 50
    • GET /fapi/v1/allForceOrders
    • GET /fapi/v1/forceOrders

REST

  • 新增交易对过滤器 "MIN_NOTIONAL",定义了交易对订单所允许的最小名义价值,并在 fapi/v1/exchangeInfo 的响应中返回

2021-01-21

币本位合约

合约订单用户自定义 idnewClientOrderId更新正则规则为: ^[\.A-Z\:/a-z0-9_-]{1,36}$


2021-01-21

U本位合约

合约订单用户自定义 idnewClientOrderId更新正则规则为: ^[\.A-Z\:/a-z0-9_-]{1,36}$


2021-01-04

U本位合约

REST

  • 以下接口的 IP 限制权重将采用基于参数 LIMIT 数值的新权重规则:

    • GET /fapi/v1/klines
    • GET /fapi/v1/continuousKlines
  • 以下接口的 IP 限制权重调整到 20:

    • GET /fapi/v1/historicalTrades
    • GET /fapi/v1/allForceOrders
    • GET /fapi/v1/forceOrders
    • GET /fapi/v1/aggTrades

2020-12-30

币本位合约

REST RATE LIMIT WEIGHT

  • 以下接口的 IP 限制权重将采用基于参数 LIMIT 数值的新权重规则:

    • GET /dapi/v1/klines
    • GET /dapi/v1/continuousKlines
    • GET /dapi/v1/indexPriceKlines
    • GET /dapi/v1/markPriceKlines
  • 以下接口的 IP 限制权重调整到 20:

    • GET /dapi/v1/historicalTrades
    • GET /dapi/v1/allForceOrders
    • GET /dapi/v1/forceOrders
    • GET /dapi/v1/aggTrades

2020-12-08

U本位合约

WEBSOCKET

  • 行情消息推送 <symbol>@bookTicker!bookTicker 返回内容新增字段e 表示事件类型
  • 行情消息推送<symbol>@markPrice, <symbol>@markPrice@1s, !markPrice@arr, 和 !markPrice@arr@1s 返回内容新增字段P 表示估计结算价
  • 新增行情连续合约 K 线推送 <pair>_<contractType>@continuousKline_<interval>

REST API

  • 接口 GET /fapi/v1/premiumIndex 返回内容新增字段 "estimatedSettlePrice" 表示估计结算价。

  • 接口GET /fapi/v1/exchangeInfo 返回内容新增字段:

    • "pair" 标的交易对
    • "contractType" 合约类型
    • "deliveryDate" 交割日期
    • "onboardDate" 上线日期
  • 新增接口 GET /fapi/v1/continuousKlines 获取连续合约 K 线数据

ENUM

  • 合约类型:
    • PERPETUAL 永续合约
    • CURRENT_MONTH 当月交割合约
    • NEXT_MONTH 次月交割合约
    • CURRENT_QUARTER 当季交割合约
    • NEXT_QUARTER 次季交割合约

2020-11-27

币本位合约

  • 新增接口 GET /dapi/v1/commissionRate 以查询用户交易手续费率。

2020-11-27

U本位合约

  • 新增接口 GET /fapi/v1/commissionRate 以查询用户交易手续费率。

2020-11-13

U本位合约

WEB SOCKET STREAM

  • 为了给用户提供更安全稳定的服务,<symbol>depth@0ms and <symbol>@depth<level>@0ms 的更新频率调整为根据数据流量总量和其他客观情况动态调整

2020-11-10

U本位合约

  • 接口GET /fapi/v1/exchangeInfo 新增返回字段 "marginAsset" 表示保证金资产
  • 接口GET /fapi/v2/account新增返回字段 "positionAmt" 表示持仓数量

2020-11-09

U本位合约

WEB SOCKET USER DATA STREAM

USER-DATA-STREAM 中的事件ACCOUNT_UPDATE推送规则作出了以下更新和优化:

  • 当用户某项资产发生变化时:

    • 资产项目"B"中仅会推送本次发生变化的资产及其余额
    • 其他资产不会被推送,即便资产不为 0
    • 如果资产变化不涉及持仓变化,持仓项目"P"将仅返回空[]
  • 当合约某 symbol 的持仓或全逐仓配置发生变动时

    • "P"中会推送该 symbol 对应的"BOTH"方向上的持仓详情
    • 如果是多空方向上发生持仓变动, "P"中会推送该 symbol 发生持仓变动的对应"LONG"或"SHORT"方向上的持仓详情
    • 该 symbol 上被初始化过的"LONG"或"SHORT"方向的逐仓持仓, 也会被推送
    • 所以该 symbol 上推送的 position 方向组合, 由具体场景决定()
    • 其他 symbol 的所有持仓信息都不会被推送,即使其持仓不为 0
  • 简言之, 您应该通过相关的 rest 接口( GET /fapi/v2/accountGET /fapi/v2/positionRisk) 获取资产和头寸的全量信息; 通过 Websocket USER-DATA-STREAM 中的事件ACCOUNT_UPDATE对本地缓存的资产或头寸数据进行增量更新。

  • 可以访问这里 获取示例以帮助对本次优化升级的理解


2020-10-27

U本位合约

WEB SOCKET STREAM

  • 单个连接可订阅的最大 stream 数量调整为 200

2020-10-10

U本位合约

WEBSOCKET

  • 新增 WebSocket 综合指数交易对信息更新<symbol>@compositeIndex

2020-10-09

U本位合约

  • 新增接口 GET /fapi/v1/indexInfo 以获取交易对为综合指数的基础成分信息。

2020-09-18

U本位合约

  • 新增 API 交易量化规则指标查询接口 GET /fapi/v1/apiTradingStatus

2020-09-16

U本位合约

  • 新增杠杆代币历史净值 K 线接口 GET /fapi/v1/lvtKlines
    杠杆代币净值系统基于合约架构,故该接口采用 fapi。

WEBSOCKET

  • 新增 WebSocket 杠杆代币信息更新<tokenName>@tokenNav
    净值 K 线更新<tokenName>@nav_Kline_<interval>
    杠杆代币净值系统基于合约架构,故该推送采用合约 WS 服务。

2020-09-09

U本位合约

  • 一些过期或者被取消的订单将在未来开始逐步不会从 API 的接口返回。
    • 被移除的订单需要满足如下条件:
      • 订单的最终状态为 CANCELED 或者 EXPIRED, 并且
      • 订单没有任何的成交记录, 并且
      • 订单生成时间 + 7 天 < 当前时间
    • 如下的接口会受影响:
      • GET /fapi/v1/order
      • GET /fapi/v1/allOrders

2020-08-16

币本位合约

WEBSOCKET

  • 新增 Websocket 账户信息请求功能, 并开放以下请求:
    • <listenKey>@account 请求获取账户信息
    • <listenKey>@balance 请求获取账户余额
    • <listenKey>@balance 请求获取持仓信息

REST

  • 新增接口GET /dapi/v1/adlQuantile 以获取持仓 ADL 队列位置估算分数

2020-08-14

U本位合约

  • 接口GET /fapi/v1/premiumIndex 新增返回字段 "indexPrice", 表示现货指数价格。
  • 以下 websocket 行情,新增返回字段 "i" 表示现货指数价格:
    • <symbol>@markPrice,
    • <symbol>@markPrice@1s,
    • !markPrice@arr,
    • !markPrice@arr@1s

2020-08-12

币本位合约

  • 新增接口 GET /dapi/v1/forceOrders 以获取用户强平订单历史.

2020-08-12

U本位合约

  • 新增接口 GET /fapi/v1/forceOrders 以获取用户强平订单历史.

2020-08-11

币本位合约

币本位永续合约

  • 新增合约类型("contractType") PERPETUAL 表示币本位永续合约

  • 接口GET /dapi/v1/premiumIndex新增返回内容:

    • lastFundingRate 表示(永续合约的)最近更新的资金费率
    • nextFundingTime 表示(永续合约的)下次资金费时间
  • 新增接口GET /dapi/v1/fundingRate 用以获取币本位永续合约的资金费率历史

  • WSS 推送<symbol>@markPrice, <symbol>@markPrice@1s, <pair>@markPrice, 和 <pair>@markPrice@1s新增推送内容:

    • r 表示(永续合约的)最近更新的资金费率
    • T 表示(永续合约的)下次资金费时间

2020-07-30

U本位合约

  • 新增接口GET /fapi/v1/adlQuantile 以获取持仓 ADL 队列位置估算分数

2020-07-22

币本位合约

  • 新增币本位合约大数据接口:
    • GET /futures/data/openInterestHist
    • GET /futures/data/topLongShortAccountRatio
    • GET /futures/data/topLongShortPositionRatio
    • GET /futures/data/globalLongShortAccountRatio
    • GET /futures/data/takerBuySellVol
    • GET /futures/data/basis

2020-07-17

U本位合约

  • 接口 GET /fapi/v1/income 权重调整为 20

2020-07-02

U本位合约

WEBSOCKET

  • "ACCOUNT_UPDATE" 事件新增返回字段 "m" 表示事件推出缘由。
  • "ORDER_TRADE_UPDATE" 事件新增返回字段 "rp" 表示该交易实现损益。

2020-06-15

U本位合约

  • 接口GET /fapi/v2/accountGET /fapi/v2/balance返回内容新增字段:
    • availableBalance
    • maxWithdrawAmount

2020-06-04

U本位合约

  • 新增 /fapi/v2/ 接口, 较 v1 对应接口性能有较大提升:
    • GET /fapi/v2/account
    • GET /fapi/v2/balance

2020-06-02

U本位合约

  • 新增 /fapi/v2/ 接口 GET /fapi/v2/positionRisk:
    • 允许用户指定 symbol 查询
    • 市场上所有 symbol 都可以被查询
    • 返回内容有效区分单向持仓模式和双向持仓模式
    • 较 ‘/fapi/v1/positionRisk’ 性能有较大改善

2020-05-18

U本位合约

  • 新增参数 closePosition 于下单接口 POST /fapi/v1/order, 表示条件全部平仓:
    如果一个STOP_MARKETTAKE_PROFIT_MARKET 条简单设置了 closePosition=true 并被触发了,当时持有所有多头仓位(若为卖单)或当时持有所有空头仓位(若为买单)将会被平仓。
  • 新增返回字段closePosition于以下接口表示是否为条件全平仓单:
    • POST /fapi/v1/order
    • POST /fapi/v1/batchOrders
    • GET /fapi/v1/order
    • DELETE /fapi/v1/order
    • DELETE /fapi/v1/batchOrders
    • GET /fapi/v1/openOrder
    • GET /fapi/v1/openOrders
    • GET /fapi/v1/allOrders

2020-05-18

U本位合约

  • 一些过期或者被取消的订单将在未来开始逐步不会从 API 的接口返回, 但是还可以从网页端查询到。
    • 被移除的订单需要满足如下条件:
      • 订单的最终状态为 CANCELED 或者 EXPIRED, 并且
      • 订单没有任何的成交记录, 并且
      • 订单生成时间 + 30 天 < 当前时间
    • 如下的接口会受影响:
      • GET /fapi/v1/order
      • GET /fapi/v1/allOrders

2020-05-15

U本位合约

  • Wesocket 行情消息 <symbol>@bookTicker!bookTicker 增加返回字段:
    • E 表示事件推出事件
    • T 表示撮合时间

2020-05-14

U本位合约

  • 以下接口返回内容增加time字段,表示撮合引擎时间:
    • GET /fapi/v1/ticker/price
    • GET /fapi/v1/ticker/bookTicker
    • GET /fapi/v1/openInterest

2020-05-11

U本位合约

  • 新增接口 POST /fapi/v1/countdownCancelAll 以实现倒计时自动撤单。
    • 该接口可以被用于确保在倒计时结束时撤销指定 symbol 上的所有挂单。
    • 在使用这个功能时,接口应像心跳一样在倒计时内被反复调用,以便可以取消既有的倒计时并开始新的倒数计时设置。

2020-05-06

U本位合约

REST 接口

  • 接口 GET /fapi/v1/leverageBracket 调整为 USER-DATA 权限访问,需要验签以及 timestamp

WEBSOCKET 账户信息推送

  • 请注意: 当某一持仓发生"FUNDING FEE"时,事件ACCOUNT_UPDATE将只会推送相关的用户资产余额信息和持仓信息,而不会推送其余无关的资产和持仓信息。
    • 当用户某全仓持仓发生"FUNDING FEE"时,事件ACCOUNT_UPDATE将只会推送相关的用户资产余额信息B(仅推送 FUNDING FEE 发生相关的资产余额信息),而不会推送任何持仓信息P
    • 当用户某逐仓仓持仓发生"FUNGDING FEE"时,事件ACCOUNT_UPDATE将只会推送相关的用户资产余额信息B(仅推送"FUNDING FEE"所使用的资产余额信息),和相关的持仓信息P(仅推送这笔"FUNDING FEE"发生所在的持仓信息),其余持仓信息不会被推送

2020-04-25

U本位合约

  • 用户"订单/交易更新推送" ORDER_TRADE_UPDATE 新增以下字段:

    • cp 表示是否为平仓条件单
    • AP 表示追踪止损单的追踪止损激活价格
    • cr 表示追踪止损单的追踪止损回调比例
  • 新增账户信息推送事件: "追加保证金通知"MARGIN_CALL.


2020-04-17

U本位合约

  • 下单接口支持新的可选参数 newOrderRespType 表示下单响应类型。支持ACKRESULT,
    如果newOrderRespType= RESULT:
    • MARKET 订单将直接返回成交(FILLED)结果;
    • 配合使用特殊 timeInForceLIMIT 订单将直接返回成交/过期(FILLED/EXPIRED)结果。

2020-04-14

U本位合约

WEB SOCKET 连接限制

  • Websocket 服务器每秒最多接受 10 个消息。消息包括:
    • PING 帧
    • PONG 帧
    • JSON 格式的消息, 比如订阅, 断开订阅.
  • 如果用户发送的消息超过限制,连接会被断开连接。反复被断开连接的 IP 有可能被服务器屏蔽。
  • 单个连接最多可以订阅 200 个 Streams。

2020-04-09

U本位合约

  • 新增接口合约大数据 GET /futures/data/takerlongshortRatio 以查询合约主动买卖量

2020-04-08

U本位合约

  • 新增接口 GET /fapi/v1/positionSide/dual 以查询用户当前持仓模式
  • 新增接口 POST /fapi/v1/batchOrders 以实现批量下单

2020-04-06

U本位合约

  • 请注意 账户信息推送 事件 "Balance 和 Position 更新推送"(ACCOUNT_UPDATE)将不再未发生更新时推送,具体规则如下:

    • 仅当账户信息有变动时(包括资金、仓位、保证金模式等发生变化),才会推送此事件;
    • 订单状态变化没有引起账户和持仓变化的,不会推送此事件;
    • 每次推送的 position 信息,仅包含当前持仓不为 0 或逐仓仓位保证金不为 0 的 symbol position。
  • 新增接口 POST /fapi/v1/positionSide/dual 更改持仓模式:双向或单向持仓模式。

  • 以下接口新增参数 positionSide 用以支持单向/双向持仓模式,表示持仓方向:

    • POST /fapi/v1/order
    • POST /fapi/v1/positionMargin
  • 以下接口新增返回字段 positionSide 用以支持单向/双向持仓模式,表示持仓方向:

    • POST /fapi/v1/order
    • GET /fapi/v1/order
    • DELETE /fapi/v1/order
    • DELETE /fapi/v1/batchOrders
    • GET /fapi/v1/openOrder
    • GET /fapi/v1/openOrders
    • GET /fapi/v1/allOrders
    • GET /fapi/v1/account
    • POST /fapi/v1/positionMargin
    • GET /fapi/v1/positionMargin/history
    • GET /fapi/v1/positionRisk
    • GET /fapi/v1/userTrades
  • 账户信息推送 事件 "Balance 和 Position 更新推送"(ACCOUNT_UPDATE)和 "订单/交易更新推送"(ORDER_TRADE_UPDATE)中新增字段 ps 表示持仓方向。


2020-03-30

U本位合约

  • 新增接口合约大数据:
    • GET /futures/data/openInterestHist
    • GET /futures/data/topLongShortAccountRatio
    • GET /futures/data/topLongShortPositionRatio
    • GET /futures/data/globalLongShortAccountRatio

2020-02-26

U本位合约

  • 新增订单类型:跟踪止损 TRAILING_STOP_MARKET

2020-02-20

U本位合约

  • 新增接口以查询指定的当前挂单: GET /fapi/v1/openOrder

2020-02-17

U本位合约

  • <symbol>@ticker!ticker@arr 更新频率提升为 1000ms
  • 新增 500ms 更新的增量深度信息流选项: <symbol>@depth@500ms
  • 新增 500ms 更新的有限档深度信息流选项: <symbol>@depth<level>@500ms

2020-02-12

U本位合约

  • Java SDK 和代码示例 发布

  • 实现每秒更新的标记价格信息流选项:
    <symbol>@markPrice@1s and !markPrice@arr@1s


2020-02-05

U本位合约

  • 新增接口GET /fapi/v1/leverageBracket: 查询杠杆分层标准。

2020-01-19

U本位合约

  • "cumQty" 字段将于未来几周从 DELETE /fapi/v1/orderDELETE /fapi/v1/batchOrdersorder 相关接口的返回内容中去除,请使用 "executedQty" 字段予以替代。

2019-12-19

U本位合约

  • 新增接口获取市场当前未平仓合约数: GET /fapi/v1/openInterest

2019-12-18

U本位合约

  • 新增账户信息推送事件:listenKeyExpired

2019-12-12

U本位合约

  • 新增接口撤销指定 symbol 的所有订单: DELETE /fapi/v1/allOpenOrders
  • 新增接口批量撤销订单:DELETE /fapi/v1/batchOrders
  • 新增支持仅减仓reduceOnly的订单类型:
    • TAKE_PROFIT
    • TAKE_PROFIT_MARKET
    • STOP
    • STOP_MARKET

2019-11-29

U本位合约

  • 新增接口获取市场强平订单:GET /fapi/v1/allForceOrders
  • 新增市场行情推送:
    • 强平订单:<symbol>@forceOrder
    • 全市场强平订单:!forceOrder@arr

2019-11-25

U本位合约

  • GET /fapi/v1/account 新增返回内容: positions
  • 以下接口新增返回值 time 表示订单创建时间:
    • GET /fapi/v1/openOrders
    • GET /fapi/v1/order
    • GET /fapi/v1/allOrders

2019-11-15

U本位合约

  • Websocket 新增市场行情流:
    • !miniTicker@arr: 全市场的精简 Ticker 更新
    • !ticker@arr: : 全市场的完整 Ticker 更新

2019-11-12

U本位合约

  • WSS 支持实时订阅和取消数据流。

2019-11-05

U本位合约

  • 新增订单类型:
    • STOP_MARKET止损市价单,
    • TAKE_PROFIT_MARKET止盈市价单
  • 下单新增可选参数: workingType 可选stopPrice由 "CONTRACT_PRICE" 或 "MARK_PRICE"触发
  • USER-DATA-STREAMS 新增:
    • ORDER_TRADE_UPDATE订单/交易 更新推送 增加:
      • "T": 撮合时间
      • "wt": workingType
    • ACCOUNT_UPDATE Balance 和 Position 更新推送 增加:"T": 撮合时间

2019-10-28

U本位合约

  • 新增接口查询账户损益资金流水:GET /fapi/v1/income

2019-10-25

U本位合约

  • 账户信息推送事件ACCOUNT_UPDATE 增加字段 "up",表示持仓未实现盈亏。
  • 账户信息推送事件ORDER_TRADE_UPDATE增加字段 "R",表示该成交是否作为只减仓单。

2019-10-24

U本位合约

  • 新增最优挂单信息行情流: <symbol>@bookTicker!bookTicker
  • 新增有限档深度信息行情流: <symbol>@depth<levels><symbol>@depth<levels>@100ms
  • 更新频率达到 100ms 的更快的增量深度信息流选项: <symbol>@depth@100ms
  • Websocket行情推送 增加 Update Speed 更新速度

2019-10-18

U本位合约

  • 新增接口 POST /fapi/v1/leverage 以调整开仓杠杆倍数。
  • 接口 GET /fapi/v1/positionRisk 的返回内容中新增字段:
  • "leverage": 当前开仓杠杆倍数;
  • "maxNotionalValue": 当前开仓杠杆倍数下的名义价值上限。
  • MARKET 市价单支持 reduceOnly 只减仓参数。

2019-10-14

U本位合约

  • 新增接口GET /fapi/v1/fundingRate: 获取资金费率历史。

2019-10-11

U本位合约

  • 账户信息推送事件ORDER_TRADE_UPDATE增加字段 "m",表示该成交是否作为挂单成交

2019-10-08

U本位合约

  • 新增限价指令订单参数 reduceOnly :只减仓
  • 新增订单类型 TAKE_PROFIT: 止盈单