Change Log

2026-10-23

Effective Date: 2026-10-23

USDⓈ-M Futures

POST /fapi/v1/algoOrder (New Algo Order): the maximum value of callbackRate for TRAILING_STOP_MARKET orders is updated from 10 to 20.
WebSocket API algoOrder.place (New Algo Order): the maximum value of callbackRate for TRAILING_STOP_MARKET orders is updated from 10 to 20.

Portfolio Margin

POST /papi/v1/um/algo/order (New UM Algo Order): the maximum value of callbackRate for TRAILING_STOP_MARKET orders is updated from 10 to 20.

2026-10-21

Effective Date: 2026-10-28

Portfolio Margin

GET /papi/v1/um/income (Get UM Income History): the page parameter is no longer supported. Use startTime and endTime to locate records.
GET /papi/v1/cm/income (Get CM Income History): the page parameter is no longer supported. Use startTime and endTime to locate records.

2026-10-20

Effective Date: 2026-10-20

USDⓈ-M Futures

GET /fapi/v1/income/asyn (Get Download Id For Futures Transaction History): the request limit is now 100 times per month, shared across the front end download page and rest api, as well as between USDⓈ-M and COIN-M contracts.

COIN-M Futures

GET /dapi/v1/income/asyn (Get Download Id For Futures Transaction History): the request limit is now 100 times per month, shared across the front end download page and rest api, as well as between USDⓈ-M and COIN-M contracts.

2026-10-15

Effective Date: 2026-10-15

Portfolio Margin and Portfolio Margin Pro

POST /sapi/v1/portfolio/asset-collection (Fund Collection by Asset) and POST /papi/v1/asset-collection (Fund Collection by Asset): added two optional request parameters, amount (DECIMAL) and futureType (STRING; enum UM / CM / OPTION, OPTION for SPAN only). When both are provided, the collection is routed to the specified wallet. amount and futureType must be supplied together. When neither is provided, behavior is unchanged.

Effective Date: 2026-10-16

USDⓈ-M Futures

GET /fapi/v1/income (Get Income History): the page parameter is no longer supported. Use startTime and endTime to locate records.

COIN-M Futures

GET /dapi/v1/income (Get Income History): the page parameter is no longer supported. Use startTime and endTime to locate records.

2026-10-09

Effective Date: 2026-10-09

USDⓈ-M Futures

POST /fapi/v1/leverage (Change Initial Leverage): removed the documented fixed maximum of 125 on leverage. The maximum is symbol-specific and equals initialLeverage of bracket 1 from GET /fapi/v1/leverageBracket (e.g. 150 for BTCUSDT and ETHUSDT). Documentation correction only, reflecting current backend behavior.

Portfolio Margin

POST /papi/v1/um/leverage (Change UM Initial Leverage): removed the documented fixed maximum of 125 on leverage. The maximum is symbol-specific and equals initialLeverage of bracket 1 from GET /papi/v1/um/leverageBracket. Documentation correction only, reflecting current backend behavior.

2026-10-08

Effective Date: 2026-10-08

European Options

GET /eapi/v1/bill (Account Funding Flow)
- Response now includes a symbol field on contract-related records (e.g. CONTRACT, FEE, EXERCISE_PNL, EXERCISE_FEE), identifying the option symbol. It is not returned for other types such as TRANSFER, and older records may not include it.

2026-09-28

Effective Date: 2026-09-28

USDⓈ-M Futures

Added new error code -4425 JOINT_MARGIN_REJECT_WITH_SIGNAL_LEAD: "Cannot switch to multi-asset mode due to active signal lead portfolio."

2026-09-21

Effective Date: 2026-09-14

USDⓈ-M Futures

GET /fapi/v1/tradingSchedule (Trading Schedule) and the Trading Session Stream now cover the FX market (FX / FXUpdate), with session types "REGULAR" and "NO_TRADING".

2026-09-15

Effective Date: 2026-09-15

USDⓈ-M Futures

Modified order.modify (WebSocket API — Modify Order): added optional parameter reduceOnly (STRING). When true, the endpoint skips min_notional validation on the modified order if and only if the original order was also placed as reduce-only; otherwise the request is rejected with -5047 "The original order is not a reduce-only order".
Modified PUT /fapi/v1/order (REST API — Modify Order): added the same optional parameter reduceOnly (STRING), with identical behavior to the order.modify change above.
Note: the reduceOnly parameter is used purely for order validation (min_notional bypass + RO attribute consistency check). Passing reduceOnly=true does NOT change the original order's reduce-only attribute — the order's RO flag remains whatever it was set to at placement time.

2026-09-10

Effective Date: 2026-09-10

USDⓈ-M Futures

GET /fapi/v1/income (Get Income History): added a new incomeType enum value SPECIAL_FUNDING_FEE, used for Tradfi Dividend funding fee.

2026-08-26

Effective Date: 2026-08-26

USDⓈ-M Futures

GET /fapi/v1/userTrades (Account Trade List): the historical data availability note is updated from "Only support querying trade in the past 6 months" to "Only support querying trade in the past 3 months", reflecting current backend behavior.

COIN-M Futures

GET /dapi/v1/userTrades (Account Trade List): added a historical data availability note, "Only support querying trade in the past 3 months", reflecting current backend behavior.

2026-08-25

Effective Date: 2026-08-25

USDⓈ-M Futures

GET /fapi/v1/allOrders (All Orders): the symbol parameter changed from mandatory to optional. All other behavior unchanged — the endpoint still returns up to 1000 records per request.

Effective Date: 2026-08-26

Portfolio Margin

POST /papi/v1/um/algo/order (New UM Algo Order): added optional closePosition parameter (true/false; Close-All, used with STOP_MARKET or TAKE_PROFIT_MARKET; mutually exclusive with quantity/reduceOnly; in Hedge Mode, cannot be used with BUY orders in LONG position side or SELL orders in SHORT position side); quantity changes from mandatory to optional; response now includes closePosition.

2026-08-21

Effective Date: 2026-08-21

USDⓈ-M Futures

ALGO_UPDATE (Algo Order Update)
- The ia field (introduced in the 2026-08-07 entry) is now fully active — no longer a placeholder. For trailing stop orders, before the order triggers (Algo Status X remains NEW), you may receive two separate ALGO_UPDATE NEW push events: one with ia:false, followed by another with ia:true once the order is activated.

Portfolio Margin

ALGO_UPDATE (Algo Order Update)
- The ia field (introduced in the 2026-08-07 entry) is now fully active — no longer a placeholder. For trailing stop orders, before the order triggers (Algo Status X remains NEW), you may receive two separate ALGO_UPDATE NEW push events: one with ia:false, followed by another with ia:true once the order is activated.

2026-08-17

Effective Date: 2026-08-17

USDⓈ-M Futures

GET /fapi/v1/tradingSchedule (Trading Schedule) and the Trading Session Stream now cover the China equity market (CN_EQUITY / CN_EquityUpdate), with session types "REGULAR" and "NO_TRADING".

2026-08-14

COIN-M Futures

GET /futures/data/topLongShortAccountRatio (Top Trader Long/Short Ratio (Accounts)): fixed request parameter symbol → pair; added optional contractType parameter (PERPETUAL / CURRENT_QUARTER / NEXT_QUARTER; omit for aggregated data across all contract types).
GET /futures/data/globalLongShortAccountRatio (Long/Short Ratio): added optional contractType parameter (PERPETUAL / CURRENT_QUARTER / NEXT_QUARTER; omit for aggregated data across all contract types).
GET /futures/data/openInterestHist (Open Interest Statistics): corrected contractType from documented-as-required to optional (PERPETUAL / CURRENT_QUARTER / NEXT_QUARTER; omit for aggregated data across all contract types; server behavior unchanged).
GET /futures/data/topLongShortPositionRatio (Top Trader Long/Short Ratio (Positions)): added optional contractType parameter (PERPETUAL / CURRENT_QUARTER / NEXT_QUARTER; omit for aggregated data across all contract types).

2026-08-11

Effective Date: 2026-08-13

USDⓈ-M Futures

GET /fapi/v1/aggTrades (Compressed/Aggregate Trades List): the maximum queryable trade history lookback (counted from now) is extended from 24 hours to 48 hours.

2026-08-07

Effective Date: 2026-08-07

USDⓈ-M Futures

ACCOUNT_UPDATE (Balance and Position Update)
- The a object now includes a new field S (STRING): the symbol associated with the event. Only pushed when the event reason type m is FUNDING_FEE.
ALGO_UPDATE (Algo Order Update)
- The o object now includes a new field ia (BOOLEAN): whether the algo order has been activated. Only meaningful for trailing stop orders.
- Note: ia is currently a placeholder field and will always return false. It will be fully functional in a future release.

COIN-M Futures

ACCOUNT_UPDATE (Balance and Position Update)
- The a object now includes a new field S (STRING): the symbol associated with the event. Only pushed when the event reason type m is FUNDING_FEE.

Portfolio Margin

ACCOUNT_UPDATE (Futures Balance and Position Update)
- The a object now includes a new field S (STRING): the symbol associated with the event. Only pushed when the event reason type m is FUNDING_FEE.
ALGO_UPDATE (Algo Order Update)
- The ao object now includes a new field ia (BOOLEAN): whether the algo order has been activated. Only meaningful for trailing stop orders.
- Note: ia is currently a placeholder field and will always return false. It will be fully functional in a future release.

2026-08-05

Effective Date: 2026-08-05

The order/trade-history query endpoints (forceOrders / allOrders / userTrades, both /fapi/v1/* UM and /dapi/v1/* CM) support returning both UM and CM futures data.

USDⓈ-M Futures

The following endpoints now include additional fields in their responses:
- GET /fapi/v1/forceOrders (User's Force Orders): added cumBase and pair.
- GET /fapi/v1/allOrders (All Orders): added cumBase and pair.
- GET /fapi/v1/userTrades (Account Trade List): added pair, baseQty and marginAsset.

COIN-M Futures

The following endpoints now include additional fields in their responses:
- GET /dapi/v1/forceOrders (User's Force Orders): added cumQuote and goodTillDate.
- GET /dapi/v1/allOrders (All Orders): added cumQuote and goodTillDate.
- GET /dapi/v1/userTrades (Account Trade List): added quoteQty.

2026-08-03

Effective Date: 2026-08-03

Portfolio Margin

The avgPrice field, along with cumQuote (UM) / cumBase (CM), has been removed from the responses of the following endpoints:
- PUT /papi/v1/um/order (Modify UM Order)
- PUT /papi/v1/cm/order (Modify CM Order)

2026-07-29

Effective Date: 2026-07-29

USDⓈ-M Futures

GET /fapi/v1/historicalTrades (Old Trades Lookup)
- Request Weight updated from 20 to 200.

COIN-M Futures

GET /dapi/v1/historicalTrades (Old Trades Lookup)
- Request Weight updated from 20 to 200.

2026-07-23

Effective Date: 2026-07-23

USDⓈ-M Futures

GET /fapi/v1/fundingRate (Get Funding Rate History)
- The response now includes a new field rateType (STRING): the funding rate type. Regular for the normal funding rate; Special for the additional funding rate generated by stock dividends.

2026-07-21

Effective Date: 2026-07-30

USDⓈ-M Futures

PUT /fapi/v1/order (Modify Order), PUT /fapi/v1/batchOrders (Modify Multiple Orders), and the WebSocket API order.modify
- New optional request parameter modifyId (INT): a user-defined modification identifier that the server passes through as-is; not validated for uniqueness. If omitted, it is not returned.
- The response now returns modifyId when it was provided in the request.
GET /fapi/v1/orderAmendment (Get Order Modify History)
- The response now includes modifyId for each modification that was submitted with one.
User Data Stream ORDER_TRADE_UPDATE event ("x": "AMENDMENT")
- New field M (STRING): the modifyId from the corresponding modify request; only pushed when a modifyId was provided.

COIN-M Futures

PUT /dapi/v1/order (Modify Order), PUT /dapi/v1/batchOrders (Modify Multiple Orders), and the WebSocket API order.modify
- New optional request parameter modifyId (INT): a user-defined modification identifier that the server passes through as-is; not validated for uniqueness. If omitted, it is not returned.
- The response now returns modifyId when it was provided in the request.
GET /dapi/v1/orderAmendment (Get Order Modify History)
- The response now includes modifyId for each modification that was submitted with one.
User Data Stream ORDER_TRADE_UPDATE event ("x": "AMENDMENT")
- New field M (STRING): the modifyId from the corresponding modify request; only pushed when a modifyId was provided.

Portfolio Margin

PUT /papi/v1/um/order and PUT /papi/v1/cm/order (Modify Order)
- New optional request parameter modifyId (INT): a user-defined modification identifier that the server passes through as-is; not validated for uniqueness. If omitted, it is not returned.
- The response now returns modifyId when it was provided in the request.
GET /papi/v1/um/orderAmendment and GET /papi/v1/cm/orderAmendment (Query Order Modify History)
- The response now includes modifyId for each modification that was submitted with one.
User Data Stream ORDER_TRADE_UPDATE event ("x": "AMENDMENT")
- New field M (STRING): the modifyId from the corresponding modify request; only pushed when a modifyId was provided.

2026-07-16

Effective Date: 2026-07-16

USDⓈ-M Futures

GET /fapi/v1/tradingSchedule (Trading Schedule)
- Now covers the Hong Kong equity market (HK_EQUITY), with session types REGULAR and NO_TRADING.
WebSocket Trading Session Stream (tradingSession)
- New event type HK_EquityUpdate for the Hong Kong equity market, with session types REGULAR and NO_TRADING.

2026-07-13

Effective Date: 2026-07-14

Portfolio Margin

The cumBase, cumQuote and avgPrice fields will be removed from the responses of the following endpoints:
- POST /papi/v1/um/order
- POST /papi/v1/cm/order
- DELETE /papi/v1/um/order
- DELETE /papi/v1/cm/order

2026-07-09

Options

New REST API:
- POST /eapi/v1/stock/contract: sign TradFi Options agreement contract

European Options

GET /eapi/v1/exchangeInfo (Exchange Information)
- Response optionSymbols now includes contractType and underlyingType fields for each option symbol, indicating the contract type and underlying type.

2026-06-30

COIN-M Futures

GET /dapi/v1/constituents (Index Constituents)
- Response now includes weight and price fields for each constituent, consistent with the USDⓈ-M Futures endpoint (GET /fapi/v1/constituents).
GET /dapi/v1/pmAccountInfo (Classic Portfolio Margin Account Information) is no longer in use. Please use GET /fapi/v1/pmAccountInfo instead.
WebSocket Stream <pair>@indexPrice (Index Price Stream)
- The pair field in the response payload has been renamed from "i" to "s".
- The <pair>@indexPrice@1s (1000ms) variant has been removed. The stream is now available as <pair>@indexPrice only, with an update speed of 1000ms.

2026-06-29

Time-sensitive Notice

POST /dapi/v1/countdownCancelAll (COIN-M Auto-Cancel All Open Orders / Countdown)
- The COIN-M countdown (auto-cancel) feature will be suspended on 2026-06-29 at 09:00 UTC (17:00 UTC+8) for the CM migration maintenance, and will be restored after CM resumes.
- Any countdown set before the suspension remains effective in the matching engine up until the snapshot is taken at maintenance shutdown.
- If the countdown timer set by the user is scheduled to fire after the maintenance snapshot, the countdown for those symbols will not take effect.

2026-06-20

USDⓈ-M Futures

POST /fapi/v1/algoOrder (New Algo Order)
- Request Weight now follows the order rate limits: 1 on 10s order rate limit (X-MBX-ORDER-COUNT-10S) and 1 on 1min order rate limit (X-MBX-ORDER-COUNT-1M). IP weight remains 0.

2026-06-16

Time-sensitive Notice

Please note the Futures COIN-M demo trading will be unavailable from 2026-06-16 02:00 till 10:00 UTC.
Update: The Futures COIN-M demo trading maintenance window is extended. The new window is from 2026-06-16 02:00:00 till 2026-06-22 10:00:00 (UTC). We appreciate your patience and understanding.

2026-06-10

Effective Date: 2026-06-30

COIN-M Futures architecture integration with USDⓈ-M Futures — REST endpoints, WebSocket streams, and account-level behavior changes. See Important CM-UM Integration Notice for the full list of affected endpoints and the action items. For the detailed timeline, please refer to the announcement.

2026-06-02

Effective Date: 2026-06-02

USDⓈ-M Futures

GET /fapi/v1/tradingSchedule (Trading Schedule)
- Extended time range from 7 days forward to 7 days backward and 7 days forward starting from the day prior to the query time.
- Added Korean equity market (KR_EQUITY) support. Korean equity market session types: REGULAR and NO_TRADING.
WebSocket Stream tradingSession (Trading Session Stream)
- Added Korean equity market support.
- Added new event type KR_EquityUpdate. Korean equity market session types: REGULAR and NO_TRADING.

2026-05-11

Effective Date: 2026-05-13

USDⓈ-M Futures

POST /fapi/v1/positionSide/dual
- New error code -4531: When changing UM dualSidePosition, the system will automatically sync CM dualSidePosition. If the CM account has any open position or open order, the sync cannot proceed and the UM position mode change will be rejected with error code -4531.
- Error payload:
```
{
    "code": -4531,
    "msg": "Position mode change requires syncing UM and CM. Please close any open positions or orders in CM and try again."
}
```
- Note: This error code is temporary and will only be active until CM enters Guard (approximately 1 month). After CM enters Guard, this error will no longer occur.

2026-04-17

Portfolio Margin Pro

User Data Stream:
- Add new event PM_PRO_ACCOUNT_UPDATE, which pushes account asset status every 5 seconds.

2026-04-15

European Options

Trade
- Cancel Multiple Option Orders - Corrected request weight from 1 to 5.

2026-04-14

Portfolio Margin

The following REST Endpoints and WebSocket User Data Streams will be enabled from 2026-04-28:
- REST:
  - POST /papi/v1/um/algo/order
  - DELETE /papi/v1/um/algo/order
  - DELETE /papi/v1/um/algo/allOpenOrders
  - GET /papi/v1/um/algo/algoOrder
  - GET /papi/v1/um/algo/openAlgoOrders
  - GET /papi/v1/um/algo/allAlgoOrders
- Websocket:
  - ALGO_UPDATE: algo order update event
The following REST Endpoints will be deprecated from 2026-04-28
- REST:
  - POST /papi/v1/um/conditional/order
  - DELETE /papi/v1/um/conditional/order
  - DELETE /papi/v1/um/conditional/allOpenOrders
  - GET /papi/v1/um/conditional/allOrders
  - GET /papi/v1/um/conditional/openOrders
  - GET /papi/v1/um/conditional/openOrder
  - GET /papi/v1/um/conditional/orderHistory

Please refer to announcement for API replacement

2026-04-13

Portfolio Margin and Portfolio Margin Pro

New REST APIs:

POST /sapi/v1/portfolio/margin-call-level : Set the margin call level for a Portfolio Margin account. When the account's uniMMR drops to the specified level, a notification will be sent via email and SMS.
GET /sapi/v1/portfolio/margin-call-level : Get the margin call level for a Portfolio Margin account.
DELETE /sapi/v1/portfolio/margin-call-level : Delete the margin call level for a Portfolio Margin account.

2026-04-10

Effective Date: 2026-04-14

COIN-M Futures / Portfolio Margin and Portfolio Margin Pro

POST /dapi/v1/positionSide/dual and POST /papi/v1/cm/positionSide/dual
- CM dualSidePosition must now stay consistent with UM. If CM dualSidePosition is already the same as UM, changing it will be rejected.

USDⓈ-M Futures

Liquidation Order Streams (<symbol>@forceOrder) and All Market Liquidation Order Streams (!forceOrder@arr)
- Updated description: changed "only the latest one liquidation order" to "only the largest one liquidation order" within 1000ms.

2026-04-09

Portfolio Margin

User Data Stream
- Event: Margin Order Update - Added new fields to the executionReport event payload: Cs, pl, pL, pY, eR.

2026-04-08

Portfolio Margin

New REST APIs:

POST /papi/v1/um/stock/contract : sign TradFi-Perps agreement contract

2026-04-06

USDⓈ-M Futures / COIN-M Futures / Portfolio Margin and Portfolio Margin Pro

GET /fapi/v1/forceOrders, GET /dapi/v1/forceOrders, GET /papi/v1/um/forceOrders and GET /papi/v1/cm/forceOrders
- Added note: Only support querying data in the past 90 days.

2026-04-02

USDⓈ-M Futures

WebSocket
- Updated important websocket change notice with legacy URL decommissioning date: 2026-04-23.

2026-03-19

USDⓈ-M Futures / COIN-M Futures

GET /fapi/v1/historicalTrades and GET /dapi/v1/historicalTrades
- Updated data availability from the last 3 months to the last 1 month.

2026-03-16

USDⓈ-M Futures

Websocket Market Streams
- Add new field ap in Mark-Price-Stream and Mark-Price-Stream-for-All-market to show mark price moving average.

2026-03-11

Option

Effective on 2026-03-19
Self-Trade Prevention:
- Similar to USDⓈ-M Futures, Self-Trade Prevention (aka STP) is added to the system. This prevents orders from matching with orders from the same account, or accounts under the same tradeGroupId
- User can set selfTradePreventionMode when placing new orders. All option symbols support the following STP mode:
  - EXPIRE_MAKER: expire maker order when STP trigger
  - EXPIRE_TAKER: expire taker order when STP trigger
  - EXPIRE_BOTH: expire taker and maker order when STP trigger
REST Update:
- New order status EXPIRED_IN_MATCH - This means that the order expired due to STP being triggered.
- Add optional parameter selfTradePreventionMode in the endpoints below to set order's STP mode:
  - POST /eapi/v1/order
  - POST /eapi/v1/batchOrders
- Add new field selfTradePreventionMode in response of the endpoints below to show order's STP mode:
  - POST /eapi/v1/order
  - POST /eapi/v1/batchOrders
  - GET /eapi/v1/order
  - GET /eapi/v1/openOrders
  - PUT /eapi/v1/order
  - PUT /eapi/v1/batchOrders
  - DELETE /eapi/v1/order
  - DELETE /eapi/v1/batchOrders
WEBSOCKET User Data Stream:
- Add new field V in ORDER_TRADE_UPDATE to order STP mode.

2026-03-05

USDⓈ-M Futures

WebSocket
- Add important websocket change notice.
- Added URL PATH section to all websocket market stream pages indicating the new base URL path (/public, /market).
- Added URL PATH section to all user data stream event pages indicating the new base URL path (/private).

2026-01-09

Portfolio Margin and Portfolio Margin Pro

New endpoints for switch to Delta Mode:
- POST /sapi/v1/portfolio/delta-mode: Switch the Delta Mode for existing PM PRO / PM RETAIL accounts.
- GET /sapi/v1/portfolio/delta-mode: Query the Delta mode status of current account.

2026-01-07

Option

New REST APIs:
- GET /eapi/v1/commission: query user commission rate

2025-12-29

USDⓈ-M Futures

The parameter "filterType": "MAX_NUM_ALGO_ORDERS" has been removed from the endpoint GET /fapi/v1/exchangeInfo. The condtional order limits is 200 across all symbols.
Effective on 2025-12-31, field nq will be available in <symbol>@aggTrade stream. For this new field, only normal market trades will be aggregated， which means the trades involving RPI orders won't be aggregated.

2025-12-11

USDⓈ-M Futures

New REST APIs:
- GET /fapi/v1/tradingSchedule: query trading session schedules for a one-week period
- POST /fapi/v1/stock/contract: sign TradFi-Perps agreement contract
New Websocket API:
- tradingSession: query current trading session information

2025-12-10

Since conditional orders have been migrated to the Algo Service, the event CONDITIONAL_ORDER_TRIGGER_REJECT will be deprecated effective December 15, 2025. Any conditional order rejection reasons are provided within the ALGO_UPDATE event.

2025-12-09

COIN-M Futures

Effective on 2025-12-10, Order expire reason field er will be available in ORDER_TRADE_UPDATE stream.

2025-11-25

USDⓈ-M Futures

Effective on 2025-11-26, RPI commisson fee is available in the response of User Commission Rate endpoint
- REST
  - GET /fapi/v1/commissionRate
New endpoints to fetch RPI order book
- REST
  - GET /fapi/v1/rpiDepth
- WebSocket
  - <symbol>@rpiDepth@500ms

2025-11-19

USDⓈ-M Futures

REST API
- GET /fapi/v1/symbolAdlRisk: New endpoints to query ADL risk rating

2025-11-18

USDⓈ-M Futures

The RPI order is introduced to USDⓈ-M Futures
- New time-in-force ENUM value - RPI is supported in
  - REST
    - POST /fapi/v1/order
    - POST /fapi/v1/batchOrders
  - WebSocket
    - order.place
- New fields in the market data response - Boolean "IsRPITrade" available in
  - REST
    - GET /fapi/v1/trades
    - GET /fapi/v1/historicalTrades
- Order Book Exclusion - RPI orders don't appear in
  - REST
    - GET /fapi/v1/depth
    - GET /fapi/v1/ticker/bookTicker
  - WebSocket
    - ticker.book
    - <symbol>@bookTicker
    - !bookTicker
    - <symbol>@depth<levels>
    - <symbol>@depth
For more details, please refer to https://www.binance.com/en/support/faq/92c83c53173947c4a44f9a7277c3b9ce

2025-11-12

Binance Derivative is rebuilding the Options system to enhance overall stability, performance, and scalability, while also introducing new features.

As the first step, a new Options Demo API environment has been launched to help existing users adapt their code to the updated system. Documentation is available under the "Options Demo Trading" tab.

To get started, please visit https://demo.binance.com/zh-CN/my/settings/api-management to create a new API key. This key can be used to access the new Options Demo Trading environment.

2025-11-10

As BFUSD has been migrated to Binance Earn on 2025-08-13. The following endpoints is deprecated:
- POST sapi/v1/portfolio/mint
- POST sapi/v1/portfolio/redeem

2025-11-06

Effective on 2025-12-09, USDⓈ-M Futures will migrate conditional orders to the Algo Service, which will affect the following order types: STOP_MARKET/TAKE_PROFIT_MARKET/STOP/TAKE_PROFIT/TRAILING_STOP_MARKET.
The new endpoints for conditional orders of REST API :
- POST fapi/v1/algoOrder: Place an algo order
- DELETE /fapi/v1/algoOrder: Cancel an algo order
- DELETE fapi/v1/algoOpenOrders: Cancel all open algo orders
- GET /fapi/v1/algoOrder: Query an algo order
- GET /fapi/v1/openAlgoOrders: Query algo open order(s)
- GET /fapi/v1/allAlgoOrders: Query algo order(s)
The following enpoints will block the requests for order types after the migration: STOP_MARKET/TAKE_PROFIT_MARKET/STOP/TAKE_PROFIT/TRAILING_STOP_MARKET. The error code -4120 STOP_ORDER_SWITCH_ALGO will be encountered.
- POST /fapi/v1/order
- POST /fapi/v1/batchOrders
Websocket User Stream Update
- New algo order event: ALGO_UPDATE
Websocket API Update
- New algo order : algoOrder.place
- Cancel algo order: algoOrder.cancel
Please note that after the migration:
- No margin check before the conditional order gets triggered.
- GTE_GTC orders no longer depend on open orders of the opposite side, but rather on positions only.
- There should be no latency increase in order triggering.
- Modification of untriggered conditional orders is not supported.

2025-10-21

Effective 2025-10-23, the priceMatch enum values OPPONENT_10 and OPPONENT_20 are temporarily removed from place/amend flows, other enums are not impacted. Affected endpoints:

USDT-M Futures (/fapi)
- POST /fapi/v1/order
- POST /fapi/v1/batchOrders
- PUT /fapi/v1/order
- PUT /fapi/v1/batchOrders
COIN-M Futures (/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 Futures

Effective 2025-10-23, Order expire reason field er will be available in ORDER_TRADE_UPDATE stream.

2025-10-14

Effective 2025-10-23, the error message for the code below will be updated:

{
    "code": -1008,
    "msg": "Request throttled by system-level protection. Reduce-only/close-position orders are exempt. Please try again."
}

2025-10-09

Futures now supports trading pair symbols in Chinese. Example from exchangeInfo: "symbol": "测试USDT".
When placing orders via API, if symbol contains Chinese characters, it must be URL-encoded (UTF-8 percent-encoding). Example:
https://fapi.binance.com/fapi/v1/order?symbol=%E6%B5%8B%E8%AF%95USDT&side=BUY&type=TAKE_PROFIT_MARKET&timeInForce=GTC&quantity=1&stopPrice=30&timestamp=1760000007980
The symbol field in push messages (WebSocket/User Data Stream) may also contain Chinese. Ensure clients/downstream systems handle decoding and rendering properly.
Requests with unencoded Chinese symbol may fail or return parameter parsing errors.

2025-08-11

BFUSD will be migrated to Binance Earn on 2025-08-13. The following endpoints will be deprecated after the migration:
- POST sapi/v1/portfolio/mint
- POST sapi/v1/portfolio/redeem
Error code -21015 ENDPOINT_GONE will be encountered.
Portfolio Margin and Portfolio Margin Pro users can switch to Binance Earn for BFUSD minting and redeeming. After the migration, the existing BFUSD under the Portfolio Margin wallet can use the aggregate balance function(POST /sapi/v1/portfolio/asset-collection) first, and transfer from Portfolio Margin wallet to Spot wallet for redemption.

2025-07-25

Added new error code in fapi:
- -4109: This account is inactive. Please activate it before trading.
  This indicates the account has been archived due to inactivity. To activate it, transfer any amount of asset to the USDM Futures account.

2025-07-02

USDⓈ-M Futures

REST API
- GET /futures/data/openInterestHist: add response field CMCCirculatingSupply
Websocket Market Streams
- A single connection of maximum streams change from 200 to 1024.

2025-04-23

USDⓈ-M Futures

REST API
- GET /fapi/v1/insuranceBalance: New endpoints to query insurance fund balance snapshot
- GET /fapi/v1/constituents: add response field price and weight

2025-04-15

Portfolio Margin and Portfolio Margin Pro

New endpoints for Earn Asset transfer as collateral:
- POST /sapi/v1/portfolio/earn-asset-transfer: Transfer LDUSDT for Portfolio Margin
- GET /sapi/v1/portfolio/earn-asset-balance: Get Transferable Earn Asset Balance for Portfolio Margin

2025-02-28

Portfolio Margin

New endpoints to query user pmloan repay record(Release on 2025-02-28):
- GET /sapi/v1/portfolio/pmloan-history

2025-02-20

COIN-M Futures

WEBSOCKET API

Websocket API will be available on 2025-02-25 and can be accessed through this URL: wss://ws-dapi.binance.com/ws-dapi/v1
WebSocket API allows placing orders, canceling orders, etc. through a WebSocket connection.
WebSocket API is a separate service from WebSocket Market Data streams. I.e., placing orders and listening to market data requires two separate WebSocket connections.
WebSocket API is subject to the same Filter and Rate Limit rules as REST API.
WebSocket API and REST API are functionally equivalent: they provide the same features, accept the same parameters, return the same status and error codes.

2025-01-20

Portfolio Margin

New endpoints to query user negative balance auto exchange record(Release on 2025-01-22):
- GET /papi/v1/portfolio/negative-balance-exchange-record

2025-01-13

USDⓈ-M Futures & COIN-M Futures

The following endpoints will be updated at 2024-01-14:
- GET /fapi/v1/historicalTrades
- GET /dapi/v1/historicalTrades
Changes to the request parameter limit:
- Maximum value changed from 1000 to 500
- Default value changed from 500 to 100

2025-01-06

Portfolio Margin

New endpoints to query user rate limit:
- GET papi/v1/rateLimit/order

2024-12-19

Portfolio Margin Pro & Portfolio Margin

New endpoints for BFUSD mint and redeem(Release on 2024-12-20):
- POST sapi/v1/portfolio/mint
- POST sapi/v1/portfolio/redeem

2024-12-17

Options

REST API: Added new endpoint GET /eapi/v1/blockTrades to get recent block trades
Websocket Market Streams: Add field X in streams <symbol>@trade and <underlyingAsset>@trade to show trade type

2024-12-02

USDⓈ-M Futures

The following error code will be added on 2024-12-03:
- -4116: ClientOrderId is duplicated.
- -4117: Stop order is in triggering process. Please try again later.

2024-11-04

USDⓈ-M Futures & COIN-M Futures

GET /fapi/v1/pmExchangeInfo and GET /dapi/v1/pmExchangeInfo will be deprecated on 2024-11-15

2024-11-01

Options

Add block trade endpoints:
- 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

The following REST endpoints will be adjusted:
- POST /sapi/v1/portfolio/repay-futures-switch: Effective on 2024-11-01, rate limit will be adjusted to 20/day.

Portfolio Margin

The following REST endpoints will be adjusted:
- POST /papi/v1/repay-futures-switch: Effective on 2024-11-01, rate limit will be adjusted to 20/day.

2024-10-24

Options

API Field Removal(Effective 2024-10-28):
- In the GET /eapi/v1/exchangeInfo endpoint, the id field will be removed from optionContracts, the id field will been removed from optionAssets, and both the contractId and id fields have been removed from optionSymbols.
- The id and cid fields will been removed from the option_pair websocket stream

2024-10-21

USDⓈ-M Futures & COIN-M Futures

Effective from 2024-10-30 00:00 (UTC), the endpoints will only support querying futures trade histories within the most recent 6 months:
- GET /fapi/v1/userTrades
- GET /dapi/v1/userTrades

COIN-M Futures

Add new historical data download endpoint:
- GET /dapi/v1/order/asyn: to get Download Id For Futures Order History
- GET /dapi/v1/order/asyn/id: to get Futures Order History Download Link by Id
- GET /dapi/v1/trade/asyn: to get Download Id For Futures Trade History
- GET /dapi/v1/trade/asyn/id: to get Futures Trade History Download Link by Id

2024-10-15

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

New endpoint to get Portfolio Margin Pro SPAN Account Info(For Portfolio Margin Pro SPAN users only):
- GET /sapi/v2/portfolio/account
New endpoint to get Portfolio Margin Pro Account Balance Info:
- GET /sapi/v1/portfolio/balance

Portfolio Margin

New endpoint to get download id for UM futures trade history:
- GET /papi/v1/um/trade/asyn
New endpoint to get UM futures trade download link by Id:
- GET /papi/v1/um/trade/asyn/id
New endpoint to get download id for UM futures order history:
- GET /papi/v1/um/order/asyn
New endpoint to get UM futures order download link by Id:
- GET /papi/v1/um/order/asyn/id
New endpoint to get download id for UM futures transaction history:
- GET /papi/v1/um/income/asyn
New endpoint to get UM futures transaction download link by Id:
- GET /papi/v1/um/income/asyn/id

2024-10-14

USDⓈ-M Futures

The following REST endpoints will be adjusted:
- POST /fapi/v1/convert/getQuote: Effective on 2024-10-19, rate limit will be adjusted to 360/hour, 500/day.
- POST /fapi/v1/convert/getQuote: validTime can only be set to 10s

2024-10-11

COIN-M Futures

Self-Trade Prevention:
Self-Trade Prevention (aka STP) is added to the system. This prevents orders from matching with orders from the same account, or accounts under the same tradeGroupId(currently only support same account). For more detail, please check FAQ
User can set selfTradePreventionMode when placing new orders. All symbols support the following STP mode:
- NONE: No Self-Trade Prevention
- EXPIRE_TAKER: expire taker order when STP trigger
- EXPIRE_BOTH: expire taker and maker order when STP trigger
- EXPIRE_MAKER: expire maker order when STP trigger
REST Update:
- New order status EXPIRED_IN_MATCH - This means that the order expired due to STP being triggered.
- Add optional parameter selfTradePreventionMode in the endpoints below to set order's STP mode:
  - POST /dapi/v1/order
  - POST /dapi/v1/batchOrders
- Add new field selfTradePreventionMode in response of the endpoints below to show order's STP mode:
  - 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 User Data Stream:
- Add new field V in ORDER_TRADE_UPDATE to order STP mode.
Price Match
Coin margin future supports order price match function. This feature allows users' LIMIT/STOP/TAKE_PROFIT orders to be placed without entering a price. The price match function will automatically determine the order price in real-time based on the price match mode and the order book.
The following priceMatch modes are supported on order level:
- NONE: no price match
- OPPONENT: counterparty best price
- OPPONENT_5: counterparty 5th best price
- OPPONENT_10: counterparty 10th best price
- OPPONENT_20: counterparty 20th best price
- QUEUE: the best price on the same side of the order book
- QUEUE_5: the 5th best price on the same side of the order book
- QUEUE_10: the 10th best price on the same side of the order book
- QUEUE_20: the 20th best price on the same side of the order book
Example:
- User places buy order and set priceMatch as QUEUE_5, the order price will be 5th best bid price of the orderbook
- User places buy order and set priceMatch as OPPONENT, the order price will be best ask price of the orderbook
REST Update:
Add optional parameter priceMatch in the endpoints below to set order's priceMatch mode:
- POST /dapi/v1/order
- POST /dapi/v1/batchOrders
Add new field priceMatch in response of the endpoints below to show order's priceMatch mode:
- 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 User Data Stream:
- Add new field pm in ORDER_TRADE_UPDATE to show price match mode.

2024-10-10

USDⓈ-M Futures

Binance will update the following endpoints, estimated to be in force on 2024-10-17 03:00 (UTC). After 2024-10-17 03:00 (UTC), the endpoints will support querying futures trade histories that are not older than one year:
- GET /fapi/v1/aggTrades
- GET /dapi/v1/aggTrades
Binance will update the following endpoints, estimated to be in force on 2024-10-16 03:00 (UTC). After 2024-10-16 03:00 (UTC), the endpoint will support querying future histories that are not older than 30 days:
- GET /fapi/v1/positionMargin/history

2024-10-08

COIN-M Futures

The most recent 7-days data is returned by default when requesting the following endpoints. The query time period for these endpoints must be less than 7 days:
- GET /dapi/v1/allOrders
- GET /dapi/v1/userTrades
The following endpoints will be adjusted to keep only recent three month data:
- GET /dapi/v1/order
- GET /dapi/v1/allOrders

2024-09-27

USDⓈ-M Futures

The following websocket user data requests are deprecated:
- listenkey@account
- listenkey@balance
- listenkey@position

COIN-M Futures

The following websocket user data requests are deprecated:
- listenkey@account
- listenkey@balance
- listenkey@position

2024-09-19

Portfolio Margin

New endpoint to repay debt for Margin:
- POST /papi/v1/margin/repay-debt: Repay debt for a margin loan.

2024-09-06

Portfolio Margin

Update endpoint for Portfolio Margin/Trade(Release date 2024-09-06):
- POST /papi/v1/um/order: add parameter priceMatch to support priceMatch for place order
- POST/papi/v1/um/conditional/order: add parameter priceMatch to support priceMatch for plac conditional order
- PUT /papi/v1/um/order: add parameter priceMatch to ssupport priceMatch for order modification
Add new field priceMatch in response of the endpoints below to show order's 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
- Add new field pm in ORDER_TRADE_UPDATE and CONDITIONAL_ORDER_TRADE_UPDATE, which represents priceMatch .

2024-09-05

Portfolio Margin Pro

New endpoint to query Portfolio Margin Pro Tiered Collateral Rate:
- GET /sapi/v2/portfolio/collateralRate: Query Portfolio Margin Pro Tiered Collateral Rate.

2024-09-03

USDⓈ-M Futures

User data stream will add TRADE_LITE event. TRADE_LITE event designed to reduce user data latency by focusing solely on ‘TRADE’ execution type and minimizing the number of user data fields, providing a faster and more efficient experience compared to the original ORDER_TRADE_UPDATE user data stream.

2024-08-26

USDⓈ-M Futures

New endpoint to Future Convert:
- 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

New endpoint to toggle UM Futures BNB Burn:
- POST /papi/v1/um/feeBurn: Toggle BNB Burn on UM Futures Trade.
- GET /papi/v1/um/feeBurn: Get UM Futures BNB Burn status.
New Endpoints to Query Account Information:
- GET /papi/v1/um/accountConfig: Query user UM account configuration.
- GET /papi/v1/um/symbolConfig: Query user symbol configuration.
- GET /papi/v2/um/account: Compared to GET /papi/v1/um/account, this endpoint only returns symbols that the user has positions or open orders in. Configuration-related fields have been removed and can now be queried from GET /papi/v1/um/symbolConfig and GET /papi/v1/um/accountConfig. The V2 endpoint also offers better performance.

2024-08-07

USDⓈ-M Futures

The following endpoints IP weight limit will be adjusted from 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
The following WebSocket User Data Requests will be deprecated from 2024-09-03
- <listenKey>@account
- <listenKey>@balance
- <listenKey>@position

Please refer to annoucement for api replacement

2024-08-06

COIN-M Futures

GET /dapi/v1/pmExchangeInfo will be deprecated on August 6,2024 due to removing notionalLimit restriction.

2024-07-24

USDⓈ-M Futures

REST API

New Endpoints to Query Account Information:
- GET /fapi/v1/symbolConfig: Query user symbol configuration.
- GET /fapi/v1/accountConfig: Query user account configuration.
- GET /fapi/v3/account: Compared to GET /fapi/v2/account, this endpoint only returns symbols that the user has positions or open orders in. Configuration-related fields have been removed and can now be queried from GET /fapi/v1/symbolConfig and GET /fapi/v1/accountConfig. The V3 endpoint also offers better performance.
- GET /fapi/v3/balance: Query user account balance.
New Endpoints to Query Trade Information:
- GET /fapi/v3/positionRisk: Compared to GET /fapi/v2/positionRisk, this endpoint only returns symbols that the user has positions or open orders in. Configuration-related fields have been removed and can now be queried from GET /fapi/v1/symbolConfig. The V3 endpoint also offers better performance.

WebSocket API

New Endpoints to Query Account Information:
- v2/account.status: Compared to account.status, this endpoint only returns symbols that the user has positions or open orders in. Configuration-related fields have been removed and can now be queried from GET /fapi/v1/symbolConfig and GET /fapi/v1/accountConfig. The V2 endpoint also offers better performance.
- v2/account.balance: Query user account balance.
- v2/account.position: Compared to account.position, this endpoint only returns symbols that the user has positions or open orders in. Configuration-related fields have been removed and can now be queried from GET /fapi/v1/symbolConfig. The V2 endpoint also offers better performance.

Deprecation Notice:

The following endpoints will be deprecated in the coming months (exact date to be announced later). Please switch to the new endpoints listed above:
- 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

Portfolio Margin

REST API

The response field marginAsset in GET /papi/v1/um/userTrades will be removed on 2024-07-17.

2024-06-19

USDⓈ-M Futures

REST API

The response field marginAsset in GET /fapi/v1/userTrades will be removed on 2024-06-25.

2024-05-22

USDⓈ-M Futures

REST API & Websocket API

New endpoint to toggle BNB Burn:
- POST /fapi/v1/feeBurn to toggle BNB Burn on Futures Trade.
- GET /fapi/v1/feeBurn to get BNB Burn status.

2024-04-19

USDⓈ-M Futures

REST API & Websocket API

The new field listenKey will be integrated into the response received from the PUT /fapi/v1/listenKey endpoint and WebSocket api userDataStream.ping. This enhancement will allow users to view the key that has been kept alive. This update is scheduled to take effect on 2024-04-25.

{
    "listenKey": "3HBntNTepshgEdjIwSUIBgB9keLyOCg5qv3n6bYAtktG8ejcaW5HXz9Vx1JgIieg"
}

2024-04-09

USDⓈ-M Futures/ COIN-M Futures / Portfolio Margin

WEBSOCKET API

Good-Till-Cancel (GTC) timeInForce will have a one-year validity period after order placement. GTC orders longer than one-year will be automatically canceled. This applies to all order types including reduceOnly but does not affect part-filled orders or strategy trading or copy-trading orders.

2024-04-01

USDⓈ-M Futures

WEBSOCKET API

Websocket API is now available and can be accessed through this URL: wss://ws-fapi.binance.com/ws-fapi/v1
WebSocket API allows placing orders, canceling orders, etc. through a WebSocket connection.
WebSocket API is a separate service from WebSocket Market Data streams. I.e., placing orders and listening to market data requires two separate WebSocket connections.
WebSocket API is subject to the same Filter and Rate Limit rules as REST API.
WebSocket API and REST API are functionally equivalent: they provide the same features, accept the same parameters, return the same status and error codes.

2024-03-11

USDⓈ-M Futures

REST

Add new Account Endpoints:
- GET /fapi/v1/rateLimit/order: query user order rate limits

2024-02-09

USDⓈ-M Futures

Binance Future is doing Websocket Service upgrade and the upgrade impacts the following：

Before upgrade:
- The websocket server will send a ping frame every 3 minutes. If the websocket server does not receive a pong frame back from the connection within a 10 minute period, the connection will be disconnected. Unsolicited pong frames are allowed.
After upgrade:
- Websocket server will send a ping frame every 3 minutes.
  - If the websocket server does not receive a pong frame back from the connection within a 10 minute period, the connection will be disconnected.
  - When you receive a ping, you must send a pong with a copy of ping's payload as soon as possible.
  - Unsolicited pong frames are allowed, but will not prevent disconnection. It is recommended that the payload for these pong frames are empty.

2024-01-24

USDⓈ-M Futures

Testnet WEBSOCKET

The Websocket baseurl for testnet is updated to "wss://fstream.binancefuture.com"

2024-01-19

Portfolio Margin

REST
- New endpoints PUT /papi/v1/um/order and PUT /papi/v1/cm/order to support UM/CM limit order modify
- New endpoints GET /papi/v1/um/orderAmendment and GET /papi/v1/cm/orderAmendment to get UM/CM order modify history

2024-01-11

Portfolio Margin

Self-Trade Prevention(Released):
Self-Trade Prevention (aka STP) will be added to the system. This will prevent orders from matching with orders from the same account, or accounts under the same tradeGroupId. For more detail, please check FAQ
User can set selfTradePreventionMode when placing new orders. All symbols support the following STP mode:
- NONE: No Self-Trade Prevention
- EXPIRE_TAKER: expire taker order when STP trigger
- EXPIRE_BOTH: expire taker and maker order when STP trigger
- EXPIRE_MAKER: expire maker order when STP trigger
REST Update:
- New order status EXPIRED_IN_MATCH - This means that the order expired due to STP being triggered.
- GET /papi/v1/um/account: Add new field tradeGroupId in response to show user's tradeGroupId
- Add optional parameter selfTradePreventionMode in the endpoints below to set order's STP mode:
  - POST /papi/v1/um/order
  - POST/papi/v1/um/conditional/order
  - POST /papi/v1/margin/order
  - POST /papi/v1/margin/order/oco
- Add new field selfTradePreventionMode in response of the endpoints below to show order's STP mode:
  - 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 User Data Stream:
- Add new field V in ORDER_TRADE_UPDATE and CONDITIONAL_ORDER_TRADE_UPDATE to order STP mode.
- New fields for executionReport (These fields will only appear if the order has expired due to STP trigger)
  - u - tradeGroupId
  - v - preventedMatchId
  - U - counterOrderId
  - A - preventedQuantity
  - B - lastPreventedQuantity
Good Till Date TIF(Released)
USDⓈ margin future will support Good To Date TIF. Orders with the TIF set to GTD will be automatically canceled by the goodTillDate time.
REST Update:
- Add optional parameter goodTillDate in the endpoints below to set order's goodTillDate :
  - POST /papi/v1/um/order
  - POST/papi/v1/um/conditional/order
- Add new field goodTillDate in response of the endpoints below to show order's goodTillDate:
  - 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 User Data Stream:
- Add new field gtd in ORDER_TRADE_UPDATE and CONDITIONAL_ORDER_TRADE_UPDATE to order good till date.
Breakeven Price(Released)
REST Update
- Add new field breakEvenPrice in The following endpoint
  - GET /papi/v1/um/account
  - GET /papi/v1/um/positionRisk
  - GET /papi/v1/cm/account
  - GET /papi/v1/cm/positionRisk
WEBSOCKET
- New field bep represents Break-Even Price in position P of payload to event: Balance and Position Update – "e": "ACCOUNT_UPDATE"

2024-01-08

USDⓈ-M Futures

REST

Update endpoint for Account/Trade(Release date 2023-01-11):
- PUT /fapi/v1/order: add parameter priceMatch to support priceMatch for order modification
- PUT /fapi/v1/batchOrders: add parameter priceMatch to support priceMatch for order modification
- Order modification will preserve the original selfTradePreventionMode of the order

2023-12-12

USDⓈ-M Futures

WEBSOCKET

Update speed for stream !bookTicker will be modified from real-time to every 5 seconds on starting December 20, 2023. Individual Symbol Book Ticker Streams <symbol>@bookticker will remain unaffected by this update

2023-11-15

USDⓈ-M Futures

REST

Add new Market Data Endpoints:
- GET /fapi/v2/ticker/price: this is v2 endpoint for querying latest price. It has same parameters and response as the GET /fapi/v1/ticker/price, and it offers lower latency and consume less of the IP rate limit. Please note that the GET /fapi/v1/ticker/price will be deprecated in the future, with the exact timing to be determined.

WEBSOCKET

Binance Futures will retire the wss://fstream-auth.binance.com domain at 2023-12-15 06:00. API users are advised to establish a new WebSocket connection to wss://fstream.binance.com. Please note that the connection method for wss://fstream.binance.com is different from that of wss://fstream-auth.binance.com. For instance:
- wss://fstream-auth.binance.com/ws/<ListenKey>?listenKey=<ListenKey> should change to wss://fstream.binance.com/ws/<ListenKey>

2023-11-01

COIN-M Futures

REST

Update on GET dapi/v1/fundingRate:
- add response field markPrice to display mark price associated with a particular funding fee charge

2023-11-01

USDⓈ-M Futures

REST

Add new Market Data Endpoints:
- GET /futures/data/basis: query basis data
Update on GET /fapi/v1/fundingRate:
- add response field markPrice to display mark price associated with a particular funding fee charge

2023-10-19

COIN-M Futures

REST

New Market Data Endpoints
- GET /futures/data/delivery-price: query quarterly contract settlement price
Update Rate Limit to 1000/5min/IP on Market Data Endpoints below:
- GET /futures/data/openInterestHist
- GET /futures/data/topLongShortAccountRatio
- GET /futures/data/topLongShortPositionRatio
- GET /futures/data/globalLongShortAccountRatio
- GET /futures/data/takerlongshortRatio

2023-10-19

European Options

Binance Option is doing Websocket Service upgrade and the upgrade impacts the following：

Before upgrade:
- The websocket server will send a ping frame every 5 minutes. If the websocket server does not receive a pong frame back from the connection within a 15 minute period, the connection will be disconnected. Unsolicited pong frames are allowed.
- To connect websocket server without subscription, user can connect by using
  - wss://nbstream.binance.com/eoptions/ws
  - wss://nbstream.binance.com/eoptions/stream
  - wss://nbstream.binance.com/eoptions/ws/
  - wss://nbstream.binance.com/eoptions/stream/
After upgrade:
- The websocket server will send a ping frame every 3 minutes. If the websocket server does not receive a pong frame back from the connection within a 10 minute period, the connection will be disconnected. Unsolicited pong frames are allowed.
- To connect websocket server without subscription:
- Connect websocket server with subscription:
  - wss://nbstream.binance.com/eoptions/ws
  - wss://nbstream.binance.com/eoptions/stream
  - / at the end is no longer supported
- Raw stream like wss://nbstream.binance.com/eoptions/illegal_parameter/stream?steams=<streamName> or wss://fstream.binance.com/illegal_parameter/ws/<streamName>is not supported, please use remove illegal_parameter/ before /ws and /stream.

2023-10-19

USDⓈ-M Futures

REST

New Market Data Endpoints
- GET /futures/data/delivery-price: query quarterly contract settlement price
Update Rate Limit to 1000/5min/IP on Market Data Endpoints below:
- GET /futures/data/openInterestHist
- GET /futures/data/topLongShortAccountRatio
- GET /futures/data/topLongShortPositionRatio
- GET /futures/data/globalLongShortAccountRatio
- GET /futures/data/takerlongshortRatio
Update Rate Limit to 500/5min/IP on Market Data Endpoints below:
- GET /fapi/v1/fundingRate
- GET /fapi/v1/fundingInfo

2023-10-16

COIN-M Futures

REST

New Market Data Endpoints
- GET /dapi/v1/constituents: query index constituents

2023-10-16

USDⓈ-M Futures

REST

New Market Data Endpoints
- GET /fapi/v1/constituents: query index constituents

2023-10-11

USDⓈ-M Futures

REST

Account Endpoints IP Weight Update:
- 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

COIN-M Futures

REST

New Market Data Endpoints Update
- GET /dapi/v1/fundingInfo: query adjusted funding info

2023-09-25

USDⓈ-M Futures

REST

New Market Data Endpoints Update
- GET /fapi/v1/fundingInfo: query adjusted funding info

2023-09-22

Portfolio Margin

Update on endpoints:
- GET /papi/v1/um/positionRisk: add response field liquidationPrice
- GET /papi/v1/cm/positionRisk: add response field liquidationPrice
- GET /papi/v1/um/leverageBracket: add response field notionalCoef
- GET /papi/v1/cm/leverageBracket: add response field notionalCoef
Websocket User Data Streams Update:
- outboundAccountPosition event add new field updateId U
- balanceUpdate event add new field updateId U

2023-09-20

COIN-M Futures

REST

Update on GET /dapi/v1/ticker/bookTicker:
- add response field lastUpdateId
Update on GET /dapi/v1/account:
- add response field updateTime in assets

2023-09-20

USDⓈ-M Futures

REST

Update on GET /fapi/v1/ticker/bookTicker:
- add response field lastUpdateId

2023-09-19

USDⓈ-M Futures

{
    "code": -1008,
    "msg": "Server is currently overloaded with other requests. Please try again in a few minutes."
}

New error code message for http 503 return code, endpoints below might have this response during high traffic:
- 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
This is a failure API operation and you can resend your request if you need.

2023-09-07

COIN-M Futures

REST

New endpointGET /dapi/v1/income/asynto get Download Id For Futures Transaction History
New endpointGET /dapi/v1/income/asyn/idto get Futures Transaction History Download Link by Id

2023-09-05

USDⓈ-M Futures

As per the announcement, Self Trade Prevention is enabled at 2023-09-05.
Price Match/ Good Till Date TIF/ Breakeven Price(detail in 2023-08-29 changelog) are released at 2023-09-05

2023-09-04

Portfolio Margin

Expect 2023-09-07 Release

Overall papi order ratelimit change from 2400 orders/min to 1200 orders/min, impacted endpoints are:
- 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

COIN-M Futures

Binance Future is doing Websocket Service upgrade and the upgrade impacts the following：

Before upgrade:
- The websocket server will send a ping frame every 5 minutes. If the websocket server does not receive a pong frame back from the connection within a 15 minute period, the connection will be disconnected. Unsolicited pong frames are allowed.
After upgrade:
- The websocket server will send a ping frame every 3 minutes. If the websocket server does not receive a pong frame back from the connection within a 10 minute period, the connection will be disconnected. Unsolicited pong frames are allowed.

2023-08-31

USDⓈ-M Futures

Binance Future is doing Websocket Service upgrade and the upgrade impacts the following：

Before upgrade:
- The websocket server will send a ping frame every 5 minutes. If the websocket server does not receive a pong frame back from the connection within a 15 minute period, the connection will be disconnected. Unsolicited pong frames are allowed.
After upgrade:
- The websocket server will send a ping frame every 3 minutes. If the websocket server does not receive a pong frame back from the connection within a 10 minute period, the connection will be disconnected. Unsolicited pong frames are allowed.

2023-08-29

European Options

REST

GET /eapi/v1/account: add new field riskLevel to show account risk level
GET /eapi/v1/marginAccount: add new fieldriskLevel to show account risk level

Websocket User Data Stream

Add new event RISK_LEVEL_CHANGE to show account riskLevel change

2023-08-29

USDⓈ-M Futures

Self-Trade Prevention(Release Date TBD):
Self-Trade Prevention (aka STP) will be added to the system. This will prevent orders from matching with orders from the same account, or accounts under the same tradeGroupId. For more detail, please check FAQ
User can set selfTradePreventionMode when placing new orders. All symbols support the following STP mode:
- NONE: No Self-Trade Prevention
- EXPIRE_TAKER: expire taker order when STP trigger
- EXPIRE_BOTH: expire taker and maker order when STP trigger
- EXPIRE_MAKER: expire maker order when STP trigger
REST Update:
- New order status EXPIRED_IN_MATCH - This means that the order expired due to STP being triggered.
- GET /fapi/v2/account: Add new field tradeGroupId in response to show user's tradeGroupId
- Add optional parameter selfTradePreventionMode in the endpoints below to set order's STP mode:
  - POST /fapi/v1/order
  - POST /fapi/v1/batchOrders
- Add new field selfTradePreventionMode in response of the endpoints below to show order's STP mode:
  - 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 User Data Stream:
- Add new field V in ORDER_TRADE_UPDATE to order STP mode.

2023-08-25

COIN-M Futures

Binance Future is doing Websocket Service upgrade and the upgrade impacts the following：
- Connect websocket server without subscription:
  - Before upgrade, user can connect by using:
    - wss://dstream.binance.com/ws
    - wss://dstream.binance.com/stream
    - wss://dstream.binance.com/ws/
    - wss://dstream.binance.com/stream/
  - After upgrade, user can connect by using:
    - wss://dstream.binance.com/ws
    - wss://dstream.binance.com/stream
    - / at the end is no longer supported
- Connect websocket server with subscription:
  - Raw stream like wss://dstream.binance.com/illegal_parameter/stream?steams=<streamName> or wss://dstream.binance.com/illegal_parameter/ws/<streamName>is not supported, please use remove illegal_parameter/ before /ws and /stream.

2023-08-19

USDⓈ-M Futures

Binance Future is doing Websocket Service upgrade and the upgrade impacts the following：
- Connect websocket server without subscription:
  - Before upgrade, user can connect by using:
    - wss://fstream.binance.com/ws
    - wss://fstream.binance.com/stream
    - wss://fstream.binance.com/ws/
    - wss://fstream.binance.com/stream/
  - After upgrade, user can connect by using:
    - wss://fstream.binance.com/ws
    - wss://fstream.binance.com/stream
    - / at the end is no longer supported
- Connect websocket server with subscription:
  - Raw stream like wss://fstream.binance.com/illegal_parameter/stream?steams=<streamName> or wss://fstream.binance.com/illegal_parameter/ws/<streamName>is not supported, please use remove illegal_parameter/ before /ws and /stream.

2023-08-18

Portfolio Margin

New endpoints for Query Order:
- GET /papi/v1/margin/order: Query Margin Account Order
- GET /papi/v1/margin/openOrders: Query Current Margin Open Order
- GET /papi/v1/margin/allOrders: Query All Margin Account Orders
- GET /papi/v1/margin/orderList: Query Margin Account's OCO
- GET /papi/v1/margin/allOrderList: Query Margin Account's all OCO
- GET /papi/v1/margin/openOrderList: Query Margin Account's Open OCO
- GET /papi/v1/margin/myTrades: Query Margin Account's Trade List

2023-08-14

COIN-M Futures

Update endpoint for Account/Trade:
- GET /dapi/v1/income: Add parameter page for pagination

2023-08-14

USDⓈ-M Futures

Update endpoint for Account/Trade:
- GET /fapi/v1/income: Add parameter page for pagination

2023-07-28

Portfolio Margin

New endpoints for account:
- POST /papi/v1/asset-collection: Fund Collection by Asset

2023-07-21

European Options

REST

New endpointGET /eapi/v1/income/asynto get Download Id For Option Transaction History
New endpointGET /eapi/v1/income/asyn/idto get Option Transaction History Download Link by Id

2023-07-20

Portfolio Margin

New endpoints for account:
- GET /papi/v1/um/adlQuantile: UM Position ADL Quantile Estimation
- GET /papi/v1/cm/adlQuantile: CM Position ADL Quantile Estimation

2023-07-19

COIN-M Futures

REST

Add field notionalCoef in GET /dapi/v2/leverageBracket to show the bracket multiplier comparing to default leverage bracket

2023-07-18

Portfolio Margin

New endpoints for account:
- POST /papi/v1/repay-futures-switch: Change Auto-repay-futures Status
- GET /papi/v1/repay-futures-switch: Get Auto-repay-futures Status
- POST /papi/v1/repay-futures-negative-balance: Repay futures Negative Balance

2023-07-18

USDⓈ-M Futures

REST

Add field notionalCoef in GET /fapi/v1/leverageBracket to show the bracket multiplier comparing to default leverage bracket

2023-07-13

European Options

Websocket Market Streams

These change will be effective from 2023-07-14:
- Add field T in streams <symbol>@ticker and <underlyingAsset>@ticker@<expirationDate> to show transaction time
- Add field E in stream <symbol>@depth<levels> to show event time

2023-07-13

Portfolio Margin

New USER DATA STREAM event riskLevelChange（effective 2023-07-14）

2023-07-12

COIN-M Futures

REST

New field breakEvenPrice represents Break-Even Price in position of response to:
- GET /dapi/v1/account (HMAC SHA256)
- GET /dapi/v1/positionRisk (HMAC SHA256)

WEBSOCKET

New field bep represents Break-Even Price in position P of payload to event: Balance and Position Update – "e": "ACCOUNT_UPDATE"

2023-07-11

Portfolio Margin

REST

Add new endpoint POST /papi/v1/ping for connectivity test

2023-07-04

USDⓈ-M Futures

REST

The following endpoints will be adjust to keep only recent three month data：
- GET /fapi/v1/order(effective 2023-07-27)
- GET /fapi/v1/allOrders(effective 2023-07-27)
- GET /fapi/v1/userTrades(exact time TBD)
Please maintain and record old order/trade infomation or switch querying historical order/trade using new endpoint below:
- New endpointGET /fapi/v1/order/asynto get Download Id For Futures Order History
- New endpointGET /fapi/v1/order/asyn/idto get Futures Order History Download Link by Id
- New endpointGET /fapi/v1/trade/asynto get Download Id For Futures Trade History
- New endpointGET /fapi/v1/trade/asyn/idto get Futures Trade History Download Link by Id

2023-06-28

USDⓈ-M Futures

Notice:

REST

The following endpoints will no longer be supported from 2023-07-15:
- GET /fapi/v1/account
- GET /fapi/v1/balance
- GET /fapi/v1/positionRisk
Please switch to corresponding v2 endpoints:
- GET /fapi/v2/account
- GET /fapi/v2/balance
- GET /fapi/v2/positionRisk

2023-06-22

COIN-M Futures

Notice:

WEBSOCKET

Raw stream like /ws?<streamName> is not supported, for example wss://dstream.binance.com/ws?btcusd@depth is invalid.
Sending websocket message with invalid JSON format will cause disconnection now, returning this error {"error":{"code":3,"msg":"Invalid JSON: expected value at line 1 column 1"}}

2023-06-22

USDⓈ-M Futures

Notice:

WEBSOCKET

Raw stream like /ws?<streamName> is not supported, for example wss://fstream.binance.com/ws?btcusdt@depth is invalid.
Sending websocket message with invalid JSON format will cause disconnection now, returning this error {"error":{"code":3,"msg":"Invalid JSON: expected value at line 1 column 1"}}

2023-06-19

Portfolio Margin

REST

Add fields CONTRACT_PRICE，priceProtect in endpoints POST /papi/v1/um/conditional/order and POST/papi/v1/cm/conditional/order

2023-06-16

USDⓈ-M Futures

Notice:

It is recommended to use standard HTTP request formats, non-standard request formats will not be supported in fapi, below are some examples for correct code practice:
- Escaping (") with '\x22' is no longer supported, please use the standard '%22' instead. It is necessary to URL encode the square brackets [] and the double quotes（"）inside the square brackets.
```
DELETE /fapi/v1/batchOrders?origClientOrderIdList=

Unsupported:
```
  [\x229151944646313025900\x22]
```
Suggest:
```
  ["9151944646313025900"]
```
--After URL encode--
```
  DELETE /fapi/v1/batchOrders?origClientOrderIdList=%5B%229151944646313025900%22%5D
- Non-standard nested JSON formats are not supported,
```
POST /fapi/v1/batchOrders?batchOrders=

Unsupported:
```
  ["{\"type\":\"LIMIT\",\"timeInForce\":\"GTC\"}"]
```
Suggest:
```
  [{"type":"LIMIT","timeInForce":"GTC"}]
```
--After URL encode--
```
  POST /fapi/v1/batchOrders?batchOrders=%5B%7B%22type%22%3A%22LIMIT%22%2C%22timeInForce%22%3A%22GTC%22%7D%5D
- Using incorrect data type is not supported
```
DELETE /fapi/v1/batchOrders?orderIdList=

As the data type of the 'orderIdList' parameter is LIST\<LONG\>
Unsupported:
```
  ["159856286502","159856313662"]
```
Suggest:
```
  [159856286502,159856313662]
```
--After URL encode--
```
  DELETE /fapi/v1/batchOrders?orderIdList=%5B159856286502%2C159856313662%5D
- Invalid whitespace characters from the request parameters are not supported
```
Unsupported:
```
  POST symbol=BTCUSDT& price= 40000.0 & signature=2d24a314
```
Suggest:
```
  POST symbol=BTCUSDT&&price=40000.0&signature=2d24a314
- Passing empty values in request parameters is not supported
```
Unsupported:
```
  GET symbol=BTCUSDT&orderId=&signature=2d24a314
  
  Suggest:
  
  GET symbol=BTCUSDT&signature=2d24a314

2023-06-14

COIN-M Futures

WEBSOCKET

New field i for quote asset and index price added in streams <symbol>@markPrice and <pair>@markPrice

2023-06-14

USDⓈ-M Futures

WEBSOCKET

New WebSocket stream !assetIndex@arrOR<assetSymbol>@assetIndex for multi-assets mode asset index update

2023-06-01

Portfolio Margin

REST

The endpoints below will be deployed on 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

USDⓈ-M Futures

WEBSOCKET

Add user data stream:
- new event CONDITIONAL_ORDER_TRIGGER_REJECT to the order reject reason for triggered TP/SL order

2023-05-30

European Options

General Information on Endpoints

For GET endpoints, parameters must be sent as a query string without setting content type in the http headers.

2023-05-05

USDⓈ-M Futures

REST

New endpoints PUT /fapi/v1/order and PUT /fapi/v1/batchOrders to support limit order modify
New endpoint GET /fapi/v1/orderAmendment to get order modify history

WEBSOCKET

New type "AMENDMENT" as order modify in Execution Type x of Order Update event ORDER_TRADE_UPDATE

2023-05-04

Portfolio Margin

API doc for portfolio margin

2023-04-17

COIN-M Futures

RELEASE DATE TBD

The recvWindow check will also be performed when orders reach matching engine. The recvWindow will be checked more precisely on order placing endpoints.

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

recvWindow Logic Before Release:

The order placing requests are valid if recvWindow + timestamp => REST API service server timestamp

recvWindow Logic After Release:

Add new recwWindow check: the order placing requests are valid if recvWindow + timestamp => matching engine timestamp
Impacted Endpoints:
- 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

USDⓈ-M Futures

RELEASE DATE 2023-04-18

The recvWindow check will also be performed when orders reach matching engine. The recvWindow will be checked more precisely on order placing endpoints.

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

recvWindow Logic Before Release:

The order placing requests are valid if recvWindow + timestamp => REST API service server timestamp

recvWindow Logic After Release:

Add new recwWindow check: the order placing requests are valid if recvWindow + timestamp => matching engine timestamp
Impacted Endpoints:
- POST /fapi/v1/order
- PUT /fapi/v1/order
- POST /fapi/v1/batchOrders
- PUT /fapi/v1/batchOrders

2023-03-28

USDⓈ-M Futures

Referal Rebate Logic Before Release

For every trade，the referal rebate balance change will be reflected in ACCOUNT_UPDATE event of USER-DATA-STREAM in real time：

{
  "e": "ACCOUNT_UPDATE",
  "T": 1679974782150,
  "E": 1679974782155,
  "a": {
    "B": [
	  {
       "a": "USDT",
       "wb": "685.31478079",
       "cw": "677.17212454",
       "bc": "0.00258637"
      }
	],
    "P": [],
    "m": "ADMIN_DEPOSIT"
  }
}

Referal Rebate Logic After Release

Referral rebates are aggregated every 20 minutes and reflected as a single push in the ACCOUNT_UPDATE event of the USER-DATA-STREAM, showing the total sum of rebates earned from multiple referrals.

2023-03-08

USDⓈ-M Futures

RELEASE DATE 2023-03-22

Order Logic Before Release:

When placing order with timeInForce FOK or GTX(Post-only), user will get order response with status = “NEW“ and corresponding order_trade_update with x = “NEW”, X = “NEW”. If the orders can't meet execution criteria, user will receive another websocket order_trade_update message x = “EXPIRED”, X = “EXPIRED”. The order can be found in GET /fapi/v1/order or 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"
}

Order Logic After Release:

When placing order with timeInForce FOK or GTX(Post-only), if the order can't meet execution criteria, order will get rejected directly and receive error response, no order_trade_update message in websocket. The order can't be found in GET /fapi/v1/order or 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"
}

Impacted Endpoints:
- POST /fapi/v1/order
- POST /fapi/v1/batchOrders
- GET /fapi/v1/order
- GET /fapi/v1/allOrders

2023-02-02

European Options

REST

Endpoint POST /eapi/v1/transfer is disabled.

2023-01-11

European Options

REST

Add endpoint GET /eapi/v1/order to check order status.

2023-01-04

USDⓈ-M Futures

WEBSOCKET

Delete Order Status NEW_INSURANCE and NEW_ADL in Order Update Event

2022-12-16

COIN-M Futures

WEBSOCKET

New WebSocket stream !contractInfo for symbol information update

2022-12-16

USDⓈ-M Futures

WEBSOCKET

New WebSocket stream !contractInfo for symbol information update

2022-12-13

European Options

WEBSOCKET

Add u and pu in stream<symbol>@depth1000 to get diff orderbook update.

2022-12-09

European Options

REST

Add updateId field u in GET /eapi/v1/depth
Add parameter underlying in GET /eapi/v1/exerciseHistory to query exercise histroy by underlying

2022-11-29

COIN-M Futures

WEB SOCKET USER DATA STREAM

New WebSocket stream STRATEGY_UPDATE in USER-DATA-STREAM: update when a strategy is created/cancelled/expired, ...etc.
New WebSocket stream GRID_UPDATE in USER-DATA-STREAM: update when a sub order of a grid is filled or partially filled.

2022-11-29

USDⓈ-M Futures

WEB SOCKET USER DATA STREAM

New WebSocket stream STRATEGY_UPDATE in USER-DATA-STREAM: update when a strategy is created/cancelled/expired, ...etc.
New WebSocket stream GRID_UPDATE in USER-DATA-STREAM: update when a sub order of a grid is filled or partially filled.

2022-11-18

European Options

REST

New endpoint GET /eapi/v1/openInterest is added to get options open interest for specific underlying on certain expiration date.

WEBSOCKET

New stream <underlyingAsset>@openInterest@<expirationDate> is added for real-time option open interest feed.

2022-11-16

European Options

WEBSOCKET

New trade stream <underlyingAsset>@trade is added for all option trades on specific underlying asset.
Adjust format in stream option_pair.

2022-11-03

European Options

REST

New endpoint for Auto-Cancel All Open Orders will be added on 2022-11-07:
- POST /eapi/v1/countdownCancelAll：Set Auto-Cancel All Open Orders (Kill-Switch) Config
- GET /eapi/v1/countdownCancelAll：Get Auto-Cancel All Open Orders (Kill-Switch) Config
- POST /eapi/v1/countdownCancelAllHeartBeat：Auto-Cancel All Open Orders (Kill-Switch) Heartbeat

2022-10-13

COIN-M Futures

Note: This change will be effictive on 2022-10-17

REST RATE LIMIT WEIGHT

Endpoint GET /dapi/v1/ticker/bookTicker

Weight Update:

2 for a single symbol;
5 when the symbol parameter is omitted

2022-10-13

USDⓈ-M Futures

Note: This change will be effictive on 2022-10-17

REST RATE LIMIT WEIGHT

Endpoint GET /fapi/v1/ticker/bookTicker

Weight Update:

2 for a single symbol;
5 when the symbol parameter is omitted

2022-09-22

COIN-M Futures

Add new endpoint for Portfolio Margin:
- GET /dapi/v1/pmAccountInfo: Get Portfolio Margin current account information.

2022-09-22

USDⓈ-M Futures

Update endpoint for Account/Trade:
- GET /fapi/v1/income: Support more incomeType
Add new endpoint for Portfolio Margin:
- GET /fapi/v1/pmAccountInfo: Get Portfolio Margin current account information.

2022-09-20

European Options

WEBSOCKET

New streams <underlyingAsset>@markPrice and <underlyingAsset>@ticker@<expirationDate> are added.
Streams <!miniTicker@arr> will be deprecated on 2022/10/30.

2022-09-14

European Options

REST

Adjust endpoint field strikePrice,makerFeeRate,takerFeeRate,minQty,maxQty,initialMargin,maintenanceMargin,minInitialMargin,minMaintenanceMargin to string in endpoint GET /eapi/v1/exchangeInfo
Only finished orders within 5 days can be queried in GET /eapi/v1/historyOrders

2022-09-05

European Options

REST

Adjust response result in endpoint DELETE /eapi/v1/allOpenOrdersByUnderlying

2022-08-22

European Options

REST

Add rateLimits information in endpoint GET /eapi/v1/exchangeInfo
Parameters symbol set to not mandatory in GET /eapi/v1/userTrades

2022-07-27

COIN-M Futures

REST RATE LIMIT WEIGHT

The weight of endpoint GET /dapi/v1/trades is updated to 5

2022-07-27

USDⓈ-M Futures

REST RATE LIMIT WEIGHT

The weight of endpoint GET /fapi/v1/trades is updated to 5

2022-06-28

COIN-M Futures

REST

New endpoint GET /dapi/v1/pmExchangeInfo to get current Portfolio Margin exchange trading rules.

2022-06-28

USDⓈ-M Futures

REST

New endpoint GET /fapi/v1/pmExchangeInfo to get current Portfolio Margin exchange trading rules.

2022-04-28

COIN-M Futures

REST

New endpoints PUT /dapi/v1/order and PUT /dapi/v1/batchOrders to support limit order modify
New endpoint GET /dapi/v1/orderAmendment to get order modify history

WEBSOCKET

New type "AMENDMENT" as order modify in Execution Type x of Order Update event ORDER_TRADE_UPDATE

2022-04-14

COIN-M Futures

WEB SOCKET USER DATA STREAM

New WebSocket stream ACCOUNT_CONFIG_UPDATE in USER-DATA-STREAM for leverage changed update

2022-03-01

USDⓈ-M Futures

REST

New endpointGET /fapi/v1/income/asynto get Download Id For Futures Transaction History
New endpointGET /fapi/v1/income/asyn/idto get Futures Transaction History Download Link by Id

2022-02-18

COIN-M Futures

REST

The maximum value of limit in GET /dapi/v1/userTrades is adjusted to 1000

2022-02-10

USDⓈ-M Futures

REST

Update GET /fapi/v2/account endpoints:
- If user is in multiAssetsMargin mode, all assets will be included in calculation for fields totalInitialMargin``totalMaintMargin``totalWalletBalance``totalUnrealizedProfit``totalMarginBalance``totalPositionInitialMargin``totalOpenOrderInitialMargin``totalCrossWalletBalance``totalCrossUnPnl``availableBalance``maxWithdrawAmount and the results will be show as value in USD
- If user is in singleAssetsMargin mode, only USDT assets are included in the calculation(same as before)

2021-12-30

USDⓈ-M Futures

WEBSOCKET

New connection method for WEBSOCKET.
- Base Url is wss://fstream-auth.binance.com
- Streams can be access either in a single raw stream or a combined stream
- Raw streams are accessed at /ws/<streamName>?listenKey=<validateListenKey>
- Combined streams are accessed at /stream?streams=<streamName1>/<streamName2>/<streamName3>&listenKey=<validateListenKey>
- <validateListenKey> must be a valid listenKey when you establish a connection.
More details: Websocket Market Streams and User Data Streams

2021-11-02

USDⓈ-M Futures

REST

New endpointGET /fapi/v1/assetIndexto get asset index for Multi-Assets mode margin asset

2021-08-18

COIN-M Futures

REST

New field positionAmt as position amount in response of GET /dapi/v1/account

2021-08-17

COIN-M Futures

REST

New endpoints PUT /dapi/v1/order and PUT /dapi/v1/batchOrders to support limit order modify
New endpoint GET /dapi/v1/orderAmendment to get order modify history

WEBSOCKET

New type "AMENDMENT" as order modify in Execution Type x of Order Update event ORDER_TRADE_UPDATE

2021-07-23

COIN-M Futures

REST

New field updateTime as last update time of asset and position in response of GET /dapi/v1/account and GET /dapi/v1/positionRisk

2021-07-06

COIN-M Futures

REST

New fields in the response of GET /dapi/v1/exchangeInfo:
- "liquidationFee" for liquidation fee rate
- "marketTakeBound" for he max price difference rate( from mark price) a market order can make

2021-07-06

USDⓈ-M Futures

REST

New field updateTime as last update time of asset and position in response of GET /fapi/v2/account and GET /fapi/v2/positionRisk
New fields in the response of GET /fapi/v1/exchangeInfo:
- "liquidationFee" for liquidation fee rate
- "marketTakeBound" for he max price difference rate( from mark price) a market order can make

2021-06-15

USDⓈ-M Futures

WEBSOCKET

New fields "q" and "i" for quote asset and index price added in stream <symbol>@compositeIndex

REST

Update endpoints:
- New fields component and quoteAsset as component asset and quote asset added in response of GET /fapi/v1/indexInfo

2021-05-06

COIN-M Futures

WEBSOCKET

New field "bc" for balance change in event "ACCOUNT_UPDATE"

2021-05-06

USDⓈ-M Futures

WEBSOCKET

Update streams:
- Previous Leverage Update event ACCOUNT_CONFIG_UPDATE expanded as account configuration update event, including leverage update and Multi-Assets margin status update.
- Balance and Position Update event ACCOUNT_UPDATE add new event reason type m as AUTO_EXCHANGEto represent Multi-Assets margin auto-exchange event

REST

New endpoints:
- POST /fapi/v1/multiAssetsMargin to change Multi-Assets margin mode
- GET /fapi/v1/multiAssetsMargin to check Multi-Assets margin mode
Update endpoints:
- New object assets as asset information in response of GET /fapi/v1/exchangeInfo.
- New field marginAvailable in response of GET /fapi/v2/balance and GET /fapi/v2/account to indicate whether the asset can be used as margin in Multi-Assets mode.

2021-04-27

COIN-M Futures

WEBSOCKET

The following liquidation orders streams do not push realtime order data anymore. Instead, they push snapshot order data at a maximum frequency of 1 order push per second.:
- <symbol>@forceOrder
- !forceOrder@arr

REST

The endpoint GET /dapi/v1/allForceOrders stop being maintained and no longer accepts request.

2021-04-27

USDⓈ-M Futures

WEBSOCKET

The following liquidation orders streams do not push realtime order data anymore. Instead, they push snapshot order data at a maximum frequency of 1 order push per second.:
- <symbol>@forceOrder
- !forceOrder@arr

REST

The endpoint GET /fapi/v1/allForceOrders stop being maintained and no longer accepts request.

2021-04-22

USDⓈ-M Futures

WEBSOCKET

New field "bc" for balance change in event "ACCOUNT_UPDATE"

2021-03-10

COIN-M Futures

REST

The query time period for endpoint GET /dapi/v1/allForceOrders must be less than 7 days (default as the recent 7 days).

2021-03-02

USDⓈ-M Futures

New endpoint GET /fapi/v1/indexPriceKlines to get index price kline/candlestick data.
New endpoint GET /fapi/v1/markPriceKlines to get mark price kline/candlestick data.

2021-02-24

USDⓈ-M Futures

REST RATE LIMIT WEIGHT

The weight of endpoint GET /fapi/v2/balance is updated to 5
The weight of endpoint GET /fapi/v2/positionRisk is updated to 5

2021-02-22

USDⓈ-M Futures

REST RATE LIMIT WEIGHT

The weight of endpoint GET /fapi/v1/income is updated to 30

REST

The query time period for endpoint GET /fapi/v1/allOrders must be less than 7 days.
The query time period for endpoint GET /fapi/v1/allForceOrders must be within the recent 7 days.

2021-01-26

COIN-M Futures

REST RATE LIMIT WEIGHT

Following endpoints' weights will be updated to 20 with symbol and 50 without symbol:
- GET /dapi/v1/allForceOrders
- GET /dapi/v1/forceOrders

2021-01-26

USDⓈ-M Futures

WEB SOCKET USER DATA STREAM

New WebSocket stream ACCOUNT_CONFIG_UPDATE in USER-DATA-STREAM for leverage changed update

REST RATE LIMIT WEIGHT

Following endpoints' weights will be updated to 20 with symbol and 50 without symbol:
- GET /fapi/v1/allForceOrders
- GET /fapi/v1/forceOrders

REST

New filter "MIN_NOTIONAL" whicht defines the minimum notional value allowed for an order on a symbol, and shown in the /fapi/v1/exchangeInfo

2021-01-21

COIN-M Futures

The regular expression rule for newClientOrderId updated as ^[\.A-Z\:/a-z0-9_-]{1,36}$

2021-01-21

USDⓈ-M Futures

The regular expression rule for newClientOrderId updated as ^[\.A-Z\:/a-z0-9_-]{1,36}$

2021-01-04

USDⓈ-M Futures

REST RATE LIMIT WEIGHT

Following endpoints will use new weight rule based on the paremeter "LIMIT" in the request:
- GET /fapi/v1/klines
- GET /fapi/v1/continuousKlines
Following endpoints' weights will be updated to 20:
- GET /fapi/v1/historicalTrades
- GET /fapi/v1/allForceOrders
- GET /fapi/v1/forceOrders
- GET /fapi/v1/aggTrades

2020-12-30

COIN-M Futures

REST

Following DAPI endpoints will use new weight rule based on the parameter "LIMIT" in the request:
- GET /dapi/v1/klines
- GET /dapi/v1/continuousKlines
- GET /dapi/v1/indexPriceKlines
- GET /dapi/v1/markPriceKlines
Following DAPI endpoints' weights will be updated to 20:
- GET /dapi/v1/historicalTrades
- GET /dapi/v1/allForceOrders
- GET /dapi/v1/forceOrders
- GET /dapi/v1/aggTrades

2020-12-08

USDⓈ-M Futures

WEBSOCKET

New field e for event type in payload of streams <symbol>@bookTicker and !bookTicker
New field P for estimated settle price in payload of streams <symbol>@markPrice, <symbol>@markPrice@1s, !markPrice@arr, and !markPrice@arr@1s.
New stream <pair>_<contractType>@continuousKline_<interval> for continuous contract kline

REST API

New field "estimatedSettlePrice" in response to GET /fapi/v1/premiumIndex
New fields in response to GET /fapi/v1/exchangeInfo:
- "pair"
- "contractType"
- "deliveryDate"
- "onboardDate"
New endpoint GET /fapi/v1/continuousKlines to get continuous contract kline data

ENUM

Contract types:
- PERPETUAL
- CURRENT_MONTH
- NEXT_MONTH
- CURRENT_QUARTER
- NEXT_QUARTER

2020-11-27

COIN-M Futures

New endpoint GET /dapi/v1/commissionRate to get user commission rate.

2020-11-27

USDⓈ-M Futures

New endpoint GET /fapi/v1/commissionRate to get user commission rate.

2020-11-13

USDⓈ-M Futures

WEB SOCKET STREAM

In order to provide users with more secure and stable services, the update time of <symbol>depth@0ms and <symbol>@depth<level>@0ms is dynamically adjusted according to the total amount of data traffic and other objective conditions.

2020-11-10

USDⓈ-M Futures

New field "marginAsset" for margin asset in the response to GET /fapi/v1/exchangeInfo.
New field "positionAmt" for position amount in the response to GET /fapi/v2/account.

2020-11-09

USDⓈ-M Futures

WEB SOCKET USER DATA STREAM

Please notice: new streamlined and optimized push rules on event ACCOUNT_UPDATE in USER-DATA-STREAM

When an asset of a user is changed:
- Only this asset and its balance information will be pushed
- Other assets and information will no longer be pushed even the balances may not be 0
- If none of the open positions change, the position "P" will only return an empty []
When a position or the margin type of a symbol is changed:
- "P" will push the details in the "BOTH" position of this symbol
- If the change happens in "LONG" or "SHORT" position, the changed "LONG" or "SHORT" position of this symbol will be pushed
- Initialized "LONG" or "SHORT" isolated position of this symbol will also be pushed
- Position information of other symbols will no longer be pushed, even their positions may not be 0
In short, the full information of assets and positions should be obtained via the related RESTful endpoints(GET /fapi/v2/account and GET /fapi/v2/positionRisk), and the locally cached asset or position data can be updated via the event ACCOUNT_UPDATE in Websocket USER-DATA-STREAM with the information of changed asset or position.
Please visit here to get examples for helping to understand the upgrade.

2020-10-27

USDⓈ-M Futures

WEB SOCKET STREAM

The maximum stream number that a single connection can listen to changes as 200.

2020-10-10

USDⓈ-M Futures

WEBSOCKET

New WebSocket streams <symbol>@compositeIndex for composite index symbol information.

2020-10-09

USDⓈ-M Futures

New endpoint GET /fapi/v1/indexInfo to get information of composite index.

2020-09-18

USDⓈ-M Futures

New endpoint GET /fapi/v1/apiTradingStatus to get futures API trading quantitative rules indicators

2020-09-16

USDⓈ-M Futures

New endpoint GET /fapi/v1/lvtKlines to get gistorical BLVT Kline.
The BLVT NAV system is working relatively with Binance Futures, so the endpoint is based on fapi.

WEBSOCKET

New WebSocket streams for BLVT
The BLVT NAV system is working relatively with Binance Futures, so the endpoint is based on futures websocket service.
_ <tokenName>@tokenNav for BLVT Info streams _ <tokenName>@nav_kline_<interval> for BLVT NAV Kline streams

2020-09-09

USDⓈ-M Futures

Some orders that were cancelled/expired will be removed gradually from API endpoints.
- Orders that meet criteria
  - order status is CANCELED or EXPIRED, AND
  - order has NO filled trade, AND
  - created time + 7 days < current time
- These endpoints are affected:
  - GET /fapi/v1/order
  - GET /fapi/v1/allOrders

2020-08-16

COIN-M Futures

WEBSOCKET

Websocket Request for user data:
- <listenKey>@account request for user's account information
- <listenKey>@balance request for user's account balance
- <listenKey>@balance request for user's position information

REST

New endpoint GET /dapi/v1/adlQuantile to get the positions' ADL quantile estimation values

2020-08-14

USDⓈ-M Futures

New field "indexPrice" in response to endpoint GET /fapi/v1/premiumIndex.
New field "i" for indexPrice in payload of ws streams:
- <symbol>@markPrice,
- <symbol>@markPrice@1s,
- !markPrice@arr,
- !markPrice@arr@1s

2020-08-12

COIN-M Futures

New endpoint GET /dapi/v1/forceOrders to get the user's force orderes.

2020-08-12

USDⓈ-M Futures

New endpoint GET /fapi/v1/forceOrders to get the user's force orderes.

2020-08-11

COIN-M Futures

COIN MARGINED PERPETUAL FUTURES

New contract type ("contractType") PERPETUAL for coin margined perpetual futures countract.
New fields in the reponse to endpoint GET /dapi/v1/premiumIndex:
- lastFundingRate for the lasted funding rate of the perpetual futures contract
- nextFundingTime for the next funding time of the perpetual futures contract
New endpoint GET /dapi/v1/fundingRate to get funding rate history of perpetual futures
New fields in the payload of WSS <symbol>@markPrice, <symbol>@markPrice@1s, <pair>@markPrice, and <pair>@markPrice@1s:
- r for the lasted funding rate of the perpetual futures contract
- T for the next funding time of the perpetual futures contract

2020-07-30

USDⓈ-M Futures

New endpoint GET /fapi/v1/adlQuantile to get the positions' ADL quantile estimation values

2020-07-22

COIN-M Futures

New endpoints of coin margined futures trading data:
- 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

USDⓈ-M Futures

Weights of endpoint GET /fapi/v1/income has been changed as 20

2020-07-02

USDⓈ-M Futures

WEBSOCKET

New field "m" for event reason type in event "ACCOUNT_UPDATE"
New field "rp" for the realized profit of the trade in event "ORDER_TRADE_UPDATE"

2020-06-15

USDⓈ-M Futures

New fields in responses to GET /fapi/v2/account and GET /fapi/v2/balance:
- availableBalance
- maxWithdrawAmount

2020-06-04

USDⓈ-M Futures

New endpoints of version 2 of fapi, having better performance than the v1 endpoints:
- GET /fapi/v2/account
- GET /fapi/v2/balance

2020-06-02

USDⓈ-M Futures

New endpoint GET /fapi/v2/positionRisk in version 2 of fapi:
- User can choose to send specific "symbol".
- All symbols in the market can be returned.
- Different responses for "One-way" or "Hedge" position mode.
- Better performance than the v1 endpoint.

2020-05-18

USDⓈ-M Futures

New parameter closePosition for endpoint POST /fapi/v1/order:
If a STOP_MARKET or TAKE_PROFIT_MARKET order with closePosition=true is triggered，all of the current long position( if SELL order) or current short position( if BUY order) will be closed.
New field closePosition in response to endpoints:
- 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

USDⓈ-M Futures

Some orders that were cancelled/expired will be removed gradually from API endpoints, but they are still available from Web UI.
- Orders that meet criteria
  - order status is CANCELED or EXPIRED, AND
  - order has NO filled trade, AND
  - created time + 30 days < current time
- These endpoints are affected:
  - GET /fapi/v1/order
  - GET /fapi/v1/allOrders

2020-05-15

USDⓈ-M Futures

New fields in payloads of <symbol>@bookTicker and !bookTicker:
- E for event time
- T for transaction time

2020-05-14

USDⓈ-M Futures

New field time for transaction time in response to endpoints：
- GET /fapi/v1/ticker/price
- GET /fapi/v1/ticker/bookTicker
- GET /fapi/v1/openInterest

2020-05-11

USDⓈ-M Futures

New endpoint POST /fapi/v1/countdownCancelAll to cancel all open orders of the specified symbol at the end of the specified countdown.
This rest endpoint means to ensure your open orders are canceled in case of an outage. The endpoint should be called repeatedly as heartbeats so that the existing countdown time can be canceled and repalced by a new one.

2020-05-06

USDⓈ-M Futures

REST

Endpoint GET /fapi/v1/leverageBracket is changed as "USER-DATA". It need to be signed, and timestamp is needed.

WEB SOCKET USER DATA STREAM

Please notice: event ACCOUNT_UPDATE in USER-DATA-STREAM will be pushed with only account balance or relative position when "FUNDING FEE" occurs.
- When "FUNDING FEE" occurs in a crossed position, ACCOUNT_UPDATE will be pushed with only the balance B(including the "FUNDING FEE" asset only), without any position P message.
- When "FUNDING FEE" occurs in an isolated position, ACCOUNT_UPDATE will be pushed with only the balance B(including the "FUNDING FEE" asset only) and the relative position message P( including the isolated position on which the "FUNDING FEE" occurs only, without any other position message).

2020-04-25

USDⓈ-M Futures

New fields in USER DATA STREAM event ORDER_TRADE_UPDATE :
- cp stands for Close-All conditional order
- AP for Activation Price with TRAILING_STOP_MARKET order
- cr for Callback Rate with TRAILING_STOP_MARKET order
New USER DATA STREAM event MARGIN_CALL.

2020-04-17

USDⓈ-M Futures

New parameter newOrderRespType for response type in endpoint POST /fapi/v1/order.
ACK and RESULT are supported. And for newOrderRespType= RESULT: _ MARKET order: the final FILLED result of the order will be return directly. _ LIMIT order with special timeInForce: the final status result of the order(FILLED or EXPIRED) will be returned directly.

2020-04-14

USDⓈ-M Futures

WEB SOCKET STREAM

WebSocket connections have a limit of 10 incoming messages per second. A message is considered:
- A PING frame
- A PONG frame
- A JSON control message (e.g. subscribe, unsubscribe)
A connection that goes beyond the limit will be disconnected; IPs that are repeatedly disconnected may be banned.
A single connection can listen to a maximum of 200 streams.

2020-04-09

USDⓈ-M Futures

New endpoint of futures trading data: GET /futures/data/takerlongshortRatio

2020-04-08

USDⓈ-M Futures

New endpoint GET /fapi/v1/positionSide/dual to get current position mode.
New endpoint POST /fapi/v1/batchOrders to place multiple orders.

2020-04-06

USDⓈ-M Futures

Please notice: event ACCOUNT_UPDATE in USER-DATA-STREAM will not be pushed without update of account balances or positions.
- ACCOUNT_UPDATE will be pushed only when update happens on user's account, including changes on balances, positions, or margin type.
- Unfilled orders or cancelled orders will not make the event ACCOUNT_UPDATE pushed, since there's no change on positions.
- Only positions of symbols with non-zero isolatd wallet or non-zero position amount will be pushed in the "position" part of the event ACCOUNT_UPDATE.
New endpoint POST /fapi/v1/positionSide/dual to change position mode: Hedge Mode or One-way Mode.
New parameter positionSide in the following endpoints：
- POST /fapi/v1/order
- POST /fapi/v1/positionMargin
New field positionSide in the responses to the following endpoints：
- 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
- GET /fapi/v1/positionMargin/history
- GET /fapi/v1/positionRisk
- GET /fapi/v1/userTrades
New field ps for "position side"in USER_DATA_STREAM events ACCOUNT_UPDATE and ORDER_TRADE_UPDATE.

2020-03-30

USDⓈ-M Futures

New endpoints of futures trading data:
- GET /futures/data/openInterestHist
- GET /futures/data/topLongShortAccountRatio
- GET /futures/data/topLongShortPositionRatio
- GET /futures/data/globalLongShortAccountRatio

2020-02-26

New order type: TRAILING_STOP_MARKET

2020-02-20

USDⓈ-M Futures

New endpoint to query specific current open order: GET /fapi/v1/openOrder

2020-02-17

USDⓈ-M Futures

Update time changed as 1000ms for streams <symbol>@ticker and !ticker@arr
New diff depth data with 500ms updates: <symbol>@depth@500ms
New partial depth data with 500ms updates: <symbol>@depth<level>@500ms

2020-02-12

USDⓈ-M Futures

New SDK and Code Demonstration on Java
Faster mark price websocket data with 1s updates: <symbol>@markPrice@1s and !markPrice@arr@1s

2020-02-05

USDⓈ-M Futures

New market data endpointGET /fapi/v1/leverageBracket to check notional and leverage brackets.

2020-01-19

USDⓈ-M Futures

"cumQty" is going to be removed from the responses to DELETE /fapi/v1/order, DELETE /fapi/v1/batchOrders and other order relatived endpoints in the coming weeks.
Please use "executedQty" instead.

2020-01-17

USDⓈ-M Futures

New SDK and Code Demonstration on Python

2020-01-06

USDⓈ-M Futures

Faster diff data with real time updates: <symbol>@depth@0ms

2020-01-03

USDⓈ-M Futures

New endpoints related to isolated position：
- POST /fapi/v1/marginType
- POST /fapi/v1/positionMargin
- GET /fapi/v1/positionMargin/history
New field in response to GET /fapi/v1/positionRisk related to isolated position:
- marginType
- isolatedMargin
New field in response to GET /fapi/v1/accountrelated to isolated position: isolated
New field in event ACCOUNT_UPDATE:
- "cw" for cross wallet
- "mt" for margin type
- "iw" for isolated wallet (if isolated)

2019-12-19

USDⓈ-M Futures

New endpoint GET /fapi/v1/openInterest to get present open interest of a specific symbol.

2019-12-18

USDⓈ-M Futures

New event type in user data stream：listenKeyExpired.

2019-12-12

USDⓈ-M Futures

New endpoint DELETE /fapi/v1/allOpenOrders to cancel all open orders of a specific symbol.
New endpointDELETE /fapi/v1/batchOrders to cancel a list of open orders.
reduceOnly has been supported in orders with type:
- TAKE_PROFIT
- TAKE_PROFIT_MARKET
- STOP
- STOP_MARKET

2019-11-29

USDⓈ-M Futures

New endpoint GET /fapi/v1/allForceOrders to get all liquidation orders.
New websocket streams:
- <symbol>@forceOrderfor liquidation order streams
- !forceOrder@arr for all market liquidation order streams

2019-11-25

USDⓈ-M Futures

GET /fapi/v1/account has new field: positions
Added new field time for order creation time in:
- GET /fapi/v1/openOrders
- GET /fapi/v1/order
- GET /fapi/v1/allOrders

2019-11-15

USDⓈ-M Futures

New websocket streams：
- !miniTicker@arr: All market 24hr mini-tickers stream.
- !ticker@arr: : All market 24hr tickers stream.

2019-11-12

USDⓈ-M Futures

WSS now supports live subscribing/unsubscribing to streams.

2019-11-05

USDⓈ-M Futures

New order type:
- STOP_MARKET，
- TAKE_PROFIT_MARKET.
New parameter workingType in POST /fapi/v1/order:
order with stop price can be triggered by "CONTRACT_PRICE" or "MARK_PRICE"
New keys in USER-DATA-STREAMS：
- in ORDER_TRADE_UPDATE:
  - "T" as transaction time
  - "wt" as workingType
- in ACCOUNT_UPDATE:
  - "T" as transaction time

2019-10-28

USDⓈ-M Futures

New rest endpoint for income flow history GET /fapi/v1/income

2019-10-25

USDⓈ-M Futures

Added "up" in event ACCOUNT_UPDATE in user data stream: the unrealized PnL of the position.
Added "R" in event ORDER_TRADE_UPDATE in user data stream, showing if the trade is reduce only.

2019-10-24

USDⓈ-M Futures

New WebSocket streams for booktickers added: <symbol>@bookTicker and !bookTicker.
New WebSocket streams for partial orderbook added: <symbol>@depth<levels> and <symbol>@depth<levels>@100ms
Faster diff data with 100ms updates: <symbol>@depth@100ms
Added Update Speed: to Websocket Market Streams

2019-10-18

USDⓈ-M Futures

New endpoint POST /fapi/v1/leverage for changing user's initial leverage in specific symbol market.
Added "leverage" for current initial leverage and "maxNotionalValue" for notional value limit of current initial leverage in response to GET /fapi/v1/positionRisk.
reduceOnly now is supported in the MARKET orders.

2019-10-14

USDⓈ-M Futures

Added GET /fapi/v1/fundingRate for getting funding fee rate history.

2019-10-11

USDⓈ-M Futures

Added "m" in event ORDER_TRADE_UPDATE in user data stream, showing if the trade is the maker side.

2019-10-08

USDⓈ-M Futures

New order parameter reduceOnly for LIMIT orders.
New order type TAKE_PROFIT.

Change Log

2026-10-23​

2026-10-21​

2026-10-20​

2026-10-15​

2026-10-09​

2026-10-08​

2026-09-28​

2026-09-21​

2026-09-15​

2026-09-10​

2026-08-26​

2026-08-25​

2026-08-21​

2026-08-17​

2026-08-14​

2026-08-11​

2026-08-07​

2026-08-05​

2026-08-03​

2026-07-29​

2026-07-23​

2026-07-21​

2026-07-16​

2026-07-13​

2026-07-09​

2026-06-30​

2026-06-29​

2026-06-20​

2026-06-16​

2026-06-10​

2026-06-02​

2026-05-11​

2026-04-17​

2026-04-15​

2026-04-14​

2026-04-13​

2026-04-10​

2026-04-09​

2026-04-08​

2026-04-06​

2026-04-02​

2026-03-19​

2026-03-16​

2026-03-11​

2026-03-05​

2026-01-09​

2026-01-07​

2025-12-29​

2025-12-11​

2025-12-10​

2025-12-09​

2025-11-25​

2025-11-19​

2025-11-18​

2025-11-12​

2025-11-10​

2025-11-06​

2025-10-21​

2025-10-20​

2025-10-14​

2025-10-09​

2025-08-11​

2025-07-25​

2025-07-02​

2025-04-23​

2025-04-15​

2025-02-28​

2025-02-20​

2025-01-20​

2025-01-13​

2025-01-06​

2024-12-19​

2024-12-17​

2024-12-02​

2024-11-04​

2024-11-01​

2024-10-29​

2024-10-24​

2024-10-21​

2026-10-23

2026-10-21

2026-10-20

2026-10-15

2026-10-09

2026-10-08

2026-09-28

2026-09-21

2026-09-15

2026-09-10

2026-08-26

2026-08-25

2026-08-21

2026-08-17

2026-08-14

2026-08-11

2026-08-07

2026-08-05

2026-08-03

2026-07-29

2026-07-23

2026-07-21

2026-07-16

2026-07-13

2026-07-09

2026-06-30

2026-06-29

2026-06-20

2026-06-16

2026-06-10

2026-06-02

2026-05-11

2026-04-17

2026-04-15

2026-04-14

2026-04-13

2026-04-10

2026-04-09

2026-04-08

2026-04-06

2026-04-02

2026-03-19

2026-03-16

2026-03-11

2026-03-05

2026-01-09

2026-01-07

2025-12-29

2025-12-11

2025-12-10

2025-12-09

2025-11-25

2025-11-19

2025-11-18

2025-11-12

2025-11-10

2025-11-06

2025-10-21

2025-10-20

2025-10-14

2025-10-09

2025-08-11

2025-07-25

2025-07-02

2025-04-23

2025-04-15

2025-02-28

2025-02-20

2025-01-20

2025-01-13

2025-01-06

2024-12-19

2024-12-17

2024-12-02

2024-11-04

2024-11-01

2024-10-29

2024-10-24

2024-10-21

2024-10-15