更新日志

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_UPDATE 和 CONDITIONAL_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/symbolConfig 和 GET /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/symbolConfig 和 GET /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/symbolConfig 和 GET /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/order 和 PUT /papi/v1/cm/order 接口以支持合约限价订单修改功能
- 新增 GET /papi/v1/um/orderAmendment 和 GET /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_UPDATE和CONDITIONAL_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_UPDATE和 CONDITIONAL_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/order和POST/papi/v1/cm/conditional/order新增参数CONTRACT_PRICE，priceProtect

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/order 和 PUT /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

发布前订单逻辑：

下单时传参 timeInForce为 FOK 或 GTX(Post-only)，用户会收到订单返回 status = “NEW” 并收到推送 order_trade_update消息x = “NEW”， X = “NEW”。如果订单不满足执行条件，用户会收到另一条 order_trade_update 消息，其x = “EXPIRED”, X = “EXPIRED”。该订单可以在GET /fapi/v1/order或GET /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"
}

发布后订单逻辑：

下单时传参 timeInForce为 FOK 或 GTX(Post-only)，如果该订单不满足执行条件，订单会被直接拒绝并收到报错信息，order_trade_update不会推送此订单的消息。该订单不能在GET /fapi/v1/order或GET /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中新增字段u和pu以获取增量 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/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-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/order 和 PUT /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/order 和 PUT /dapi/v1/batchOrders 接口以支持限价订单修改功能
新增 GET /dapi/v1/orderAmendment 接口以查询订单修改历史

WEBSOCKET

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

2021-07-23

币本位合约

REST

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

2021-07-06

币本位合约

REST

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

2021-07-06

U本位合约

REST

GET /fapi/v2/account 和 GET /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/balance与GET /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/account 和 GET /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/account，GET /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_MARKET 或 TAKE_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 表示下单响应类型。支持ACK 和 RESULT,
如果newOrderRespType= RESULT:
- MARKET 订单将直接返回成交(FILLED)结果；
- 配合使用特殊 timeInForce 的 LIMIT 订单将直接返回成交/过期(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/order，DELETE /fapi/v1/batchOrders 等 order 相关接口的返回内容中去除，请使用 "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：止盈单

更新日志

2024-09-19​

2024-09-06​

2024-09-05​

2024-09-03​

2024-08-26​

2024-08-23​

2024-08-07​

2024-08-06​

2024-07-24​

REST API​

WebSocket API​

2024-07-17​

REST API​

2024-06-19​

REST API​

2024-05-22​

2024-04-19​

2024-04-09​

2024-04-01​

2024-03-11​

2024-02-09​

2024-01-24​

2024-01-19​

2024-01-11​

2024-01-08​

2023-12-12​

2023-11-15​

2023-11-01​

2023-11-01​

2023-10-19​

2023-10-19​

2023-10-19​

2023-10-16​

2023-10-16​

2023-10-11​

2023-09-25​

2023-09-25​

2023-09-20​

2023-09-20​

2023-09-19​

2023-09-07​

2023-09-05​

2023-09-04​

2023-09-04​

2023-08-31​

2023-08-31​

2023-08-29​

2023-08-29​

2023-08-25​

2023-08-19​

2023-08-18​

2023-08-14​

2023-08-14​

2023-07-28​

2023-07-21​

2023-07-20​

2023-07-19​

2023-07-18​

2023-07-18​

2023-07-13​

2023-07-13​

2023-07-12​

2023-07-11​

2023-07-04​

2023-06-28​

2023-06-22​

2023-06-22​

2023-06-19​

2023-06-16​

2023-06-14​

2023-06-14​

2023-06-01​

2023-05-31​

2023-05-30​

2023-05-24​

2023-05-05​

2023-05-04​

2023-04-17​

2023-04-17​

2024-09-19

2024-09-06

2024-09-05

2024-09-03

2024-08-26

2024-08-23

2024-08-07

2024-08-06

2024-07-24

REST API

WebSocket API

2024-07-17

REST API

2024-06-19

REST API

2024-05-22

2024-04-19

2024-04-09

2024-04-01

2024-03-11

2024-02-09

2024-01-24

2024-01-19

2024-01-11

2024-01-08

2023-12-12

2023-11-15

2023-11-01

2023-11-01

2023-10-19

2023-10-19

2023-10-19

2023-10-16

2023-10-16

2023-10-11

2023-09-25

2023-09-25

2023-09-20

2023-09-20

2023-09-19

2023-09-07

2023-09-05

2023-09-04

2023-09-04

2023-08-31

2023-08-31

2023-08-29

2023-08-29

2023-08-25

2023-08-19

2023-08-18

2023-08-14

2023-08-14

2023-07-28

2023-07-21

2023-07-20

2023-07-19

2023-07-18

2023-07-18

2023-07-13

2023-07-13

2023-07-12

2023-07-11

2023-07-04

2023-06-28

2023-06-22

2023-06-22

2023-06-19

2023-06-16

2023-06-14

2023-06-14

2023-06-01

2023-05-31

2023-05-30

2023-05-24

2023-05-05

2023-05-04

2023-04-17

2023-04-17

2023-03-28