# 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-22 **Effective Date: 2026-10-29** Portfolio Margin Pro - New REST endpoints: - `POST /papi/v1/unimmr/notification` (Set uniMMR Drop Notification Status): enable or disable uniMMR drop notifications. - `GET /papi/v1/unimmr/notification` (Get uniMMR Drop Notification Status): query the uniMMR drop notification status. - New User Data Stream event: - `uniMMRDrop`: sent through the existing Portfolio Margin Pro User Data Stream when notifications are enabled and uniMMR drops by more than 5% from the reference value. The feature is disabled by default and supports PM PRO and PM PRO SPAN only. --- ## 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](#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](#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 `@indexPrice` (Index Price Stream) - The pair field in the response payload has been renamed from `"i"` to `"s"`. - The `@indexPrice@1s` (1000ms) variant has been removed. The stream is now available as `@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-23 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](/products/derivatives-trading-coin-futures/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](https://www.binance.com/en/support/announcement/detail/2a84dfd7643f4dc18084e45e8691b69e). --- ## 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: ```json { "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](https://www.binance.com/en/support/announcement/detail/13980e4145ee41259d32f985161d81b6) 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 (`@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](/products/derivatives-trading-portfolio-margin/user-data-streams#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](/products/derivatives-trading-usds-futures/websocket-market-streams/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](/products/derivatives-trading-usds-futures/websocket-market-streams/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 `@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 - `@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` - `@bookTicker` - `!bookTicker` - `@depth` - `@depth` - For more details, please refer to ## 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 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: ```javascript { "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×tamp=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 `@trade` and `@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](https://www.binance.com/zh-CN/support/faq/what-is-self-trade-prevention-0941126f6413485b9a3df964a9aa2306) - 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 - \@account - \@balance - \@position Please refer to [annoucement](https://www.binance.com/en/support/announcement/notice-on-upcoming-binance-api-update-2024-09-03-19d4e3cd0758426584dd9686eb56ec64) 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. ```javascript { "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](https://www.binance.com/en/support/faq/what-is-self-trade-prevention-stp-0941126f6413485b9a3df964a9aa2306) - 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 `@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=` should change to `wss://fstream.binance.com/ws/` --- ## 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=` or `wss://fstream.binance.com/illegal_parameter/ws/`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 ```javascript { "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 endpoint`GET /dapi/v1/income/asyn`to get Download Id For Futures Transaction History - New endpoint`GET /dapi/v1/income/asyn/id`to get Futures Transaction History Download Link by Id --- ## 2023-09-05 USDⓈ-M Futures - As per the [announcement](https://www.binance.com/en/support/announcement/binance-futures-launches-self-trade-prevention-stp-function-for-usd%E2%93%A2-margined-futures-on-api-32916877372243d69154c345200e34b8), 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 field`riskLevel` 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](https://www.binance.com/zh-CN/support/faq/what-is-self-trade-prevention-0941126f6413485b9a3df964a9aa2306) - 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=` or `wss://dstream.binance.com/illegal_parameter/ws/`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=` or `wss://fstream.binance.com/illegal_parameter/ws/`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 endpoint`GET /eapi/v1/income/asyn`to get Download Id For Option Transaction History - New endpoint`GET /eapi/v1/income/asyn/id`to 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 `@ticker` and `@ticker@` to show transaction time - Add field `E` in stream `@depth` 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 endpoint`GET /fapi/v1/order/asyn`to get Download Id For Futures Order History - New endpoint`GET /fapi/v1/order/asyn/id`to get Futures Order History Download Link by Id - New endpoint`GET /fapi/v1/trade/asyn`to get Download Id For Futures Trade History - New endpoint`GET /fapi/v1/trade/asyn/id`to 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?\** 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?\** 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\ 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 `@markPrice` and `@markPrice` --- ## 2023-06-14 USDⓈ-M Futures WEBSOCKET - New WebSocket stream `!assetIndex@arr`OR`@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. ```javascript { "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. ```javascript { "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： ```javascript { "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`. ```javascript { "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`. ```javascript { "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`@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 `@openInterest@` is added for real-time option open interest feed. --- ## 2022-11-16 European Options WEBSOCKET - New trade stream `@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 `@markPrice` and `@ticker@` are added. - Streams `` 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 endpoint`GET /fapi/v1/income/asyn`to get Download Id For Futures Transaction History - New endpoint`GET /fapi/v1/income/asyn/id`to 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/?listenKey=` - Combined streams are accessed at `/stream?streams=//&listenKey=` - `` must be a valid listenKey when you establish a connection. - More details: [Websocket Market Streams](/products/derivatives-trading-usds-futures/websocket-market-streams/Connect) and [User Data Streams](/products/derivatives-trading-usds-futures/user-data-streams) --- ## 2021-11-02 USDⓈ-M Futures REST - New endpoint`GET /fapi/v1/assetIndex`to 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 `@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_EXCHANGE`to 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.: - `@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.: - `@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 `@bookTicker` and `!bookTicker` - New field `P` for estimated settle price in payload of streams `@markPrice`, `@markPrice@1s`, `!markPrice@arr`, and `!markPrice@arr@1s`. - New stream `_@continuousKline_` 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 `depth@0ms` and `@depth@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](https://dev.binance.vision/t/838) 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 `@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. _`@tokenNav` for BLVT Info streams_ `@nav_kline_` 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: - `@account` request for user's account information - `@balance` request for user's account balance - `@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: - `@markPrice`, - `@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 `@markPrice`, `@markPrice@1s`, `@markPrice`, and `@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 `@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 `@ticker` and `!ticker@arr` - New diff depth data with 500ms updates: `@depth@500ms` - New partial depth data with 500ms updates: `@depth@500ms` --- ## 2020-02-12 USDⓈ-M Futures - New [SDK and Code Demonstration](/sdks-tools/overview) on Java - Faster mark price websocket data with 1s updates: `@markPrice@1s` and `!markPrice@arr@1s` --- ## 2020-02-05 USDⓈ-M Futures - New market data endpoint`GET /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](/sdks-tools/overview) on Python --- ## 2020-01-06 USDⓈ-M Futures - Faster diff data with real time updates: `@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/account`related 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 endpoint`DELETE /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: - `@forceOrder`for 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: `@bookTicker` and `!bookTicker`. - New WebSocket streams for partial orderbook added: `@depth` and `@depth@100ms` - Faster diff data with 100ms updates: `@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`. ---