跳到主要内容

更新日志

2025-11-25​

USDⓈ-M期货

  • 自 2025-11-26 起，用户手续费率接口支持查询RPI手续费率
    • REST
      • GET /fapi/v1/commissionRate
  • 提供如下新接口，获取RPI深度信息
    • REST
      • GET /fapi/v1/rpiDepth
    • WebSocket
      • <symbol>@rpiDepth@500ms

2025-11-19​

USDⓈ-M期货

  • REST API更新:
    • GET /fapi/v1/symbolAdlRisk: 查询自动减仓风险评级

2025-11-18​

USDⓈ-M期货

  • 支持RPI订单
    • 有效方式 (timeInForce)新增“RPI”枚举值
      • REST
        • POST /fapi/v1/order
        • POST /fapi/v1/batchOrders
      • WebSocket
        • order.place
    • 新响应字段"IsRPITrade"(布尔)
      • REST
        • GET /fapi/v1/trades
        • GET /fapi/v1/historicalTrades
    • RPI订单不包含在订单簿
      • REST
        • GET /fapi/v1/depth
        • GET /fapi/v1/ticker/bookTicker
      • WebSocket
        • ticker.book
        • <symbol>@bookTicker
        • !bookTicker
        • <symbol>@depth<levels>
        • <symbol>@depth
  • 更多详细信息，请阅读 - https://www.binance.com/en/support/faq/92c83c53173947c4a44f9a7277c3b9ce

2025-11-12​

币安衍生品正在重建期权系统，以提升整体的稳定性、性能与可扩展性，并引入更多新功能。

作为第一步，我们已上线全新的期权 Demo API 环境，以便现有用户能够提前调整代码，适配新系统。相关文档可在 “Options Demo Trading” 标签页中查看。

请前往 https://demo.binance.com/zh-CN/my/settings/api-management 创建新的 API Key，该 Key 可用于访问全新的期权 Demo 交易环境。

2025-11-10​

  • BFUSD 已于 2025-08-13 迁移至 Binance Earn，以下接口已被废弃：
    • POST sapi/v1/portfolio/mint
    • POST sapi/v1/portfolio/redeem

2025-11-06​

  • USDT-M合约将在 2025-12-02 起将条件订单迁移到Algo服务, 以下订单类型将会受到影响： STOP_MARKET/TAKE_PROFIT_MARKET/STOP/TAKE_PROFIT/TRAILING_STOP_MARKET.

  • REST API 将提供如下新接口进行条件订单的下单、撤单和查询:

    • POST fapi/v1/algoOrder: 条件单下单
    • DELETE /fapi/v1/algoOrder: 条件单撤单
    • DELETE fapi/v1/algoOpenOrders: 撤销所有条件单
    • GET /fapi/v1/algoOrder: 查询条件订单
    • GET /fapi/v1/openAlgoOrders: 查询条件订单挂单
    • GET /fapi/v1/allAlgoOrders: 查询所有条件单

  • 用户数据更新

    • 条件单新增事件: ALGO_UPDATE

  • Websocket API 更新

    • 条件单下单 : algoOrder.place
    • 条件单撤单: algoOrder.cancel

  • 本次迁移的影响点如下：

    • 条件单在触发前不会进行保证金校验
    • GTE_GTC 订单不再依赖于对手方的未平仓订单，而仅依赖于持仓情况
    • 订单触发不会增加延迟
    • 条件单暂不支持改单

2025-10-21​

  • 自 2025-10-23 起，下单/改单接口中的 priceMatch 枚举 OPPONENT_10、OPPONENT_20 暂时移除，其余枚举不受影响。影响接口如下：

    USDT-M 合约 (/fapi)

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

    COIN-M 合约 (/dapi)

    • POST /dapi/v1/order
    • POST /dapi/v1/batchOrders
    • PUT /dapi/v1/order
    • PUT /dapi/v1/batchOrders

    Portfolio Margin (/papi)

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

2025-10-20​

USDⓈ-M期货

  • 自2025-10-23起，订单交易更新推送事件ORDER_TRADE_UPDATE增加订单过期原因字段er。

2025-10-14​

  • 自 2025-10-23 起，下列错误码的提示信息将更新：
{
    "code": -1008,
    "msg": "Request throttled by system-level protection. Reduce-only/close-position orders are exempt. Please try again."
}

2025-10-09​

  • 合约系统新增：支持中文交易对名称（symbol 可为中文）。exchangeInfo 返回示例："symbol": "测试USDT"。
  • 通过 API 下单时，若 symbol 含中文，必须进行 URL 编码（UTF-8 百分号编码）。示例：
    https://fapi.binance.com/fapi/v1/order?symbol=%E6%B5%8B%E8%AF%95USDT&side=BUY&type=TAKE_PROFIT_MARKET&timeInForce=GTE_GTC&quantity=1&stopPrice=30&timestamp=1760000007980
  • 推送消息（WebSocket/用户数据流）中的 symbol 也可能为中文，请确保客户端/下游系统对中文解析、解码与显示的兼容性。
  • 未对中文 symbol 进行编码可能导致请求失败或参数解析错误。

2025-08-11​

  • BFUSD 将于 2025-08-13 迁移至 Binance Earn。迁移完成后，以下接口将被废弃：
    • POST sapi/v1/portfolio/mint
    • POST sapi/v1/portfolio/redeem
  • 调用上述接口可能会遇到错误码 -21015（ENDPOINT_GONE）。
  • Portfolio Margin 和 Portfolio Margin Pro 用户可切换至 Binance Earn 进行 BFUSD 的铸造和赎回。迁移后，Portfolio Margin 钱包中的现有 BFUSD 可先通过资产归集接口（POST /sapi/v1/portfolio/asset-collection）进行资金归集，然后将BFUSD资产从 Portfolio Margin 钱包转至现货钱包进行赎回。

2025-07-25​

  • fapi新增下列错误码:
    • -4109: This account is inactive, please activate the account first. 这表示该账户因长期未使用而被归档。要激活账户，请向USDM合约账户转入任意金额的资产。

2025-07-02​

USDⓈ-M期货

  • REST API更新:

    • GET /futures/data/openInterestHist: 响应增加CMCCirculatingSupply

  • 市场数据连接:

    • 单个连接最多可以订阅Streams个数从200增加到1024。

2025-04-23​

USDⓈ-M期货

  • REST API更新:
    • GET /fapi/v1/insuranceBalance: 查询保险基金余额快照
    • GET /fapi/v1/constituents: 响应增加price和weight

2025-04-15​

Portfolio Margin and Portfolio Margin Pro

  • 统一账户支持Earn资产作为抵押物相关接口:
    • POST /sapi/v1/portfolio/earn-asset-transfer: 统一账户转入LDUSDT资产
    • GET /sapi/v1/portfolio/earn-asset-balance: 查询统一账户LDUSDT可转金额

2025-02-28​

Portfolio Margin Pro

  • 统一账户专业版新增穿仓借贷偿还记录查询（将于2025-02-28生效）:
    • GET /sapi/v1/portfolio/pmloan-history

2025-02-20​

币本位合约

WEBSOCKET API

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

2025-01-20​

Portfolio Margin

  • 统一账户新增查询用户负余额自动兑换记录（将于2025-01-22生效）:
    • GET /papi/v1/portfolio/negative-balance-exchange-record

2025-01-13​

USDⓈ-M Futures & COIN-M Futures

  • 下列接口将在2024-01-14被调整：
    • GET /fapi/v1/historicalTrades
    • GET /dapi/v1/historicalTrades
    接口请求参数limit调整内容为:
    • 最大值从1000改为500
    • 默认值从500改为100

2025-01-06​

Portfolio Margin

  • 统一账户新增查询用户下单限频接口:
    • GET papi/v1/rateLimit/order

2024-12-19​

Portfolio Margin Pro & Portfolio Margin

  • 统一账户新增BFUSD申购和赎回接口（将于2024-12-20生效）:
    • POST sapi/v1/portfolio/mint
    • POST sapi/v1/portfolio/redeem

2024-12-17​

期权

  • REST API: 新增 GET /eapi/v1/blockTrades以查询最近的大宗交易

  • Websocket行情推送: 在消息<symbol>@trade和 <underlyingAsset>@trade增加字段X显示交易类型

2024-12-02​

USDⓈ-M Futures

  • 将于2024-12-03增加下列错误码:
    • -4116: ClientOrderId is duplicated.
    • -4117: Stop order is in triggering process. Please try again later.

2024-11-04​

USDⓈ-M期货和币本位合约

  • GET /fapi/v1/pmExchangeInfo 和 GET /dapi/v1/pmExchangeInfo 将于2024-11-15停用

2024-11-01​

期权

  • 新增做市商大宗交易接口：
    • POST eapi/v1/block/order/create
    • PUT eapi/v1/block/order/create
    • DELETE eapi/v1/block/order/create
    • GET eapi/v1/block/order/orders
    • POST eapi/v1/block/order/execute
    • GET eapi/v1/block/order/execute
    • GET eapi/v1/block/user-trades

2024-10-29​

Portfolio Margin Pro

  • 下列REST接口被调整：
    • POST /sapi/v1/portfolio/repay-futures-switch: 从2024-11-01开始, 接口限频为每天20次。

Portfolio Margin

  • T下列REST接口被调整：
    • POST /papi/v1/repay-futures-switch: 从2024-11-01开始, 接口限频为每天20次。

2024-10-24​

欧式期权

  • 接口字段删除(2024-10-28生效)：
    • GET /eapi/v1/exchangeInfo接口移除optionContracts中的id字段，移除optionAssets中的id字段，移除optionSymbols中的contractId和id字段
    • 推送option_pair中移除id和cid字段

2024-10-21​

USDⓈ-M期货和币本位合约

  • 币安合约预计于2024年10月30日08:00（东八区时间）更新以下接口。自2024年10月30日08:00（东八区时间）之后，以下接口仅支持查询不超过最近6个月的合约交易数据：
    • GET /fapi/v1/userTrades
    • GET /dapi/v1/userTrades

币本位合约

  • 新增历史数据下载接口：
    • GET /dapi/v1/order/asyn: 获取合约订单历史下载id
    • GET /dapi/v1/order/asyn/id: 通过下载id获取合约订单历史下载链接
    • GET /dapi/v1/trade/asyn: 获取合约交易历史下载id
    • GET /dapi/v1/trade/asyn/id: 通过下载id获取合约交易历史下载链接

2024-10-15​

Portfolio Margin Pro(Release date 2024-10-18)

  • 新增查询统一账户专业版SPAN账户信息接口(仅统一账户专业版SPAN可查):
    • GET /sapi/v2/portfolio/account
  • 新增查询统一账户专业版账户资产信息接口:
    • GET /sapi/v1/portfolio/balance

Portfolio Margin

  • 新增获取统一账户UM合约交易历史下载Id:
    • GET /papi/v1/um/trade/asyn
  • 新增通过下载Id获取统一账户UM合约交易历史下载链接:
    • GET /papi/v1/um/trade/asyn/id
  • 新增获取统一账户UM合约订单历史下载Id:
    • GET /papi/v1/um/order/asyn
  • 新增通过下载Id获取统一账户UM合约订单历史下载链接:
    • GET /papi/v1/um/order/asyn/id
  • 新增获取统一账户UM合约资金流水历史下载Id:
    • GET /papi/v1/um/income/asyn
  • 新增通过下载Id获取统一账户UM合约资金流水历史下载链接:
    • GET /papi/v1/um/income/asyn/id

2024-10-14​

USDⓈ-M 期货

  • 下列REST接口被调整：
    • POST /fapi/v1/convert/getQuote: 从2024-10-19开始，接口限频为每小时360次，每天500次。
    • POST /fapi/v1/convert/getQuote: validTime的枚举值调整为仅支持10s

2024-10-11​

币本位合约

  • 自成交保护

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

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

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

  • REST 更新:

    • 新的订单状态：EXPIRED_IN_MATCH - 订单由于 STP 触发而过期
    • 以下接口新增可选参数selfTradePreventionMode以设置该订单的自成交保护模式：
      • POST /dapi/v1/order
      • POST /dapi/v1/batchOrders
    • 以下接口新增响应字段selfTradePreventionMode以显示订单的自成交保护模式：
      • POST /dapi/v1/order
      • POST /dapi/v1/batchOrders
      • GET /dapi/v1/order
      • GET /dapi/v1/openOrders
      • GET /dapi/v1/allOrders
      • PUT /dapi/v1/order
      • PUT /dapi/v1/batchOrders
      • DELETE /dapi/v1/order
      • DELETE /dapi/v1/batchOrders

  • WEBSOCKET 账户信息推送更新:

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

  • 价格匹配

  • 币本位合约系统中已经支持价格匹配功能（priceMatch）。此功能将允许用户的LIMIT/STOP/TAKE_PROFIT订单无需输入价格，价格匹配功能将根据订单的价格匹配模式和订单簿实时自动确定订单价格。

  • 合约LIMIT/STOP/TAKE_PROFIT订单支持设置priceMatch以价格匹配模式：

    • NONE: 设置价格匹配
    • OPPONENT: 盘口对手价
    • OPPONENT_5: 盘口对手5档价
    • OPPONENT_10: 盘口对手10档价
    • OPPONENT_20: 盘口对手20档价
    • QUEUE: 盘口同向价
    • QUEUE_5: 盘口同向排队5档价
    • QUEUE_10: 盘口同向排队10档价
    • QUEUE_20: 盘口同向排队20档价

  • 例子:

    • 用户下买单，设置priceMatch为QUEUE_5，则订单价格为订单薄买方向（盘口同向）第五档价格
    • 用户下买单，设置priceMatch为OPPONENT，则订单价格为订单薄卖方向（盘口对手）第一档价格

  • REST更新:

    • 以下接口新增可选参数priceMatch以设置价格匹配类型：
      • POST /dapi/v1/order
      • POST /dapi/v1/batchOrders
    • 以下接口新增响应字段priceMatch以显示订单的价格匹配模式：
      • POST /dapi/v1/order
      • POST /dapi/v1/batchOrders
      • GET /dapi/v1/order
      • GET /dapi/v1/openOrders
      • GET /dapi/v1/allOrders
      • PUT /dapi/v1/order
      • PUT /dapi/v1/batchOrders
      • DELETE /dapi/v1/order
      • DELETE /dapi/v1/batchOrders

  • Websocket账户信息推送更新:

    • ORDER_TRADE_UPDATE中新增字段pm显示用户订单的价格匹配模式

2024-10-10​

USDⓈ-M 期货

  • 预计于2024年10月17日11:00（东八区时间）更新以下接口。自2024年10月17日11:00（东八区时间）后，以下接口将支持查询不超过1年的合约交易数据：

    • GET /fapi/v1/aggTrades
    • GET /dapi/v1/aggTrades

  • 预计于2024年10月16日11:00（东八区时间）更新以下接口。自2024年10月16日11:00（东八区时间）后，以下接口将支持查询不超过1个月的合约数据：

    • GET /fapi/v1/positionMargin/history

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_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-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： 止盈单