derivatives-usds v8.0.0

MIGRATION.md

@@ -51,7 +51,7 @@ For Futures (COIN-M Futures package):
     </dependency>
 ```
 
-### **Step 3: Update Imports**
+### **Step 2: Update Imports**
 
 Update your import paths:
 
@@ -79,7 +79,7 @@ import com.binance.connector.futures.client.impl.CMFuturesClientImpl;
 import com.binance.connector.client.derivatives_trading_coin_futures.rest.api.DerivativesTradingCoinFuturesRestApi;
 ```
 
-### **Step 4: Update Client Initialization**
+### **Step 3: Update Client Initialization**
 
 The new structure introduces a more modular approach to client initialization.
 
@@ -129,11 +129,11 @@ The new structure introduces a more modular approach to client initialization.
     DerivativesTradingCoinFuturesRestApi api = new DerivativesTradingCoinFuturesRestApi(clientConfiguration);
 
     Long recvWindow = 5000L;
-    ApiResponse<AccountInformationResponse> response = getApi().accountInformation(recvWindow);
+    ApiResponse<AccountInformationResponse> response = api.accountInformation(recvWindow);
     System.out.println(response.getData());
 ```
 
-### **Step 5: Check for API Differences**
+### **Step 4: Check for API Differences**
 
 Some function names or response structures may have changed. Refer to the modular connector's documentation for details.
 

clients/derivatives-trading-usds-futures/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 8.0.0 - 2026-01-06
+
+### Changed (3)
+
+#### WebSocket API
+
+- Added parameter `activatePrice`
+  - affected methods:
+    - `newAlgoOrder()` (`algoOrder.place` method)
+- Deleted parameter `activationPrice`
+  - affected methods:
+    - `newAlgoOrder()` (`algoOrder.place` method)
+#### WebSocket Streams
+
+- Modified response for `aggregateTradeStreams()` (`<symbol>@aggTrade` stream):
+  - property `nq` added
+
 ## 7.0.0 - 2025-12-16
 
 ### Added (14)

clients/derivatives-trading-usds-futures/docs/AggregateTradeStreamsResponse.md

@@ -13,6 +13,7 @@
 |**aLowerCase** | **Long** |  |  [optional] |
 |**pLowerCase** | **String** |  |  [optional] |
 |**qLowerCase** | **String** |  |  [optional] |
+|**nq** | **String** |  |  [optional] |
 |**fLowerCase** | **Long** |  |  [optional] |
 |**lLowerCase** | **Long** |  |  [optional] |
 |**T** | **Long** |  |  [optional] |

clients/derivatives-trading-usds-futures/docs/BatchOrdersPlaceMultipleOrdersInner.md

@@ -16,11 +16,6 @@
 |**reduceOnly** | **String** |  |  [optional] |
 |**price** | **String** |  |  [optional] |
 |**newClientOrderId** | **String** |  |  [optional] |
-|**stopPrice** | **String** |  |  [optional] |
-|**activationPrice** | **String** |  |  [optional] |
-|**callbackRate** | **String** |  |  [optional] |
-|**workingType** | [**WorkingTypeEnum**](#WorkingTypeEnum) |  |  [optional] |
-|**priceProtect** | **String** |  |  [optional] |
 |**newOrderRespType** | [**NewOrderRespTypeEnum**](#NewOrderRespTypeEnum) |  |  [optional] |
 |**priceMatch** | [**PriceMatchEnum**](#PriceMatchEnum) |  |  [optional] |
 |**selfTradePreventionMode** | [**SelfTradePreventionModeEnum**](#SelfTradePreventionModeEnum) |  |  [optional] |
@@ -60,15 +55,6 @@
 
 
 
-## Enum: WorkingTypeEnum
-
-| Name | Value |
-|---- | -----|
-| MARK_PRICE | "MARK_PRICE" |
-| CONTRACT_PRICE | "CONTRACT_PRICE" |
-
-
-
 ## Enum: NewOrderRespTypeEnum
 
 | Name | Value |

clients/derivatives-trading-usds-futures/docs/CancelAlgoOrderResponseResult.md

@@ -9,27 +9,8 @@
 |------------ | ------------- | ------------- | -------------|
 |**algoId** | **Long** |  |  [optional] |
 |**clientAlgoId** | **String** |  |  [optional] |
-|**algoType** | **String** |  |  [optional] |
-|**orderType** | **String** |  |  [optional] |
-|**symbol** | **String** |  |  [optional] |
-|**side** | **String** |  |  [optional] |
-|**positionSide** | **String** |  |  [optional] |
-|**timeInForce** | **String** |  |  [optional] |
-|**quantity** | **String** |  |  [optional] |
-|**algoStatus** | **String** |  |  [optional] |
-|**triggerPrice** | **String** |  |  [optional] |
-|**price** | **String** |  |  [optional] |
-|**icebergQuantity** | **String** |  |  [optional] |
-|**selfTradePreventionMode** | **String** |  |  [optional] |
-|**workingType** | **String** |  |  [optional] |
-|**priceMatch** | **String** |  |  [optional] |
-|**closePosition** | **Boolean** |  |  [optional] |
-|**priceProtect** | **Boolean** |  |  [optional] |
-|**reduceOnly** | **Boolean** |  |  [optional] |
-|**createTime** | **Long** |  |  [optional] |
-|**updateTime** | **Long** |  |  [optional] |
-|**triggerTime** | **Long** |  |  [optional] |
-|**goodTillDate** | **Long** |  |  [optional] |
+|**code** | **String** |  |  [optional] |
+|**msg** | **String** |  |  [optional] |
 
 
 

clients/derivatives-trading-usds-futures/docs/CancelOrderResponse.md

@@ -10,7 +10,7 @@
 |**id** | **String** |  |  [optional] |
 |**status** | **Long** |  |  [optional] |
 |**result** | [**CancelOrderResponseResult**](CancelOrderResponseResult.md) |  |  [optional] |
-|**rateLimits** | [**List<CancelAlgoOrderResponseRateLimitsInner>**](CancelAlgoOrderResponseRateLimitsInner.md) |  |  [optional] |
+|**rateLimits** | [**List<CancelOrderResponseRateLimitsInner>**](CancelOrderResponseRateLimitsInner.md) |  |  [optional] |
 
 
 

clients/derivatives-trading-usds-futures/docs/CancelOrderResponseRateLimitsInner.md

@@ -0,0 +1,17 @@
+
+
+# CancelOrderResponseRateLimitsInner
+
+
+## Properties
+
+| Name | Type | Description | Notes |
+|------------ | ------------- | ------------- | -------------|
+|**rateLimitType** | **String** |  |  [optional] |
+|**interval** | **String** |  |  [optional] |
+|**intervalNum** | **Long** |  |  [optional] |
+|**limit** | **Long** |  |  [optional] |
+|**count** | **Long** |  |  [optional] |
+
+
+

clients/derivatives-trading-usds-futures/docs/NewAlgoOrderRequest.md

@@ -22,7 +22,7 @@
 |**closePosition** | **String** |  |  [optional] |
 |**priceProtect** | **String** |  |  [optional] |
 |**reduceOnly** | **String** |  |  [optional] |
-|**activationPrice** | **Double** |  |  [optional] |
+|**activatePrice** | **Double** |  |  [optional] |
 |**callbackRate** | **Double** |  |  [optional] |
 |**clientAlgoId** | **String** |  |  [optional] |
 |**selfTradePreventionMode** | **SelfTradePreventionMode** |  |  [optional] |

clients/derivatives-trading-usds-futures/docs/NewAlgoOrderResponse.md

@@ -10,7 +10,7 @@
 |**id** | **String** |  |  [optional] |
 |**status** | **Long** |  |  [optional] |
 |**result** | [**NewAlgoOrderResponseResult**](NewAlgoOrderResponseResult.md) |  |  [optional] |
-|**rateLimits** | [**List<CancelAlgoOrderResponseRateLimitsInner>**](CancelAlgoOrderResponseRateLimitsInner.md) |  |  [optional] |
+|**rateLimits** | [**List<CancelOrderResponseRateLimitsInner>**](CancelOrderResponseRateLimitsInner.md) |  |  [optional] |
 
 
 

clients/derivatives-trading-usds-futures/docs/PlaceMultipleOrdersResponseInner.md

@@ -24,8 +24,6 @@
 |**timeInForce** | **String** |  |  [optional] |
 |**type** | **String** |  |  [optional] |
 |**origType** | **String** |  |  [optional] |
-|**activatePrice** | **String** |  |  [optional] |
-|**priceRate** | **String** |  |  [optional] |
 |**updateTime** | **Long** |  |  [optional] |
 |**workingType** | **String** |  |  [optional] |
 |**priceProtect** | **Boolean** |  |  [optional] |

clients/derivatives-trading-usds-futures/docs/TradeApi.md

@@ -206,7 +206,7 @@ No authorization required
 
 New Algo Order(TRADE)
 
-Send in a new algo order.  * Condition orders will be triggered when:  * If parameter`priceProtect`is sent as true: * when price reaches the `triggerPrice` ，the difference rate between \"MARK_PRICE\" and \"CONTRACT_PRICE\" cannot be larger than the \"triggerProtect\" of the symbol * \"triggerProtect\" of a symbol can be got from `GET /fapi/v1/exchangeInfo`  * `STOP`, `STOP_MARKET`: * BUY: latest price (\"MARK_PRICE\" or \"CONTRACT_PRICE\") >= `triggerPrice` * SELL: latest price (\"MARK_PRICE\" or \"CONTRACT_PRICE\") <= `triggerPrice` * `TAKE_PROFIT`, `TAKE_PROFIT_MARKET`: * BUY: latest price (\"MARK_PRICE\" or \"CONTRACT_PRICE\") <= `triggerPrice` * SELL: latest price (\"MARK_PRICE\" or \"CONTRACT_PRICE\") >= `triggerPrice` * `TRAILING_STOP_MARKET`: * BUY: the lowest price after order placed <= `activationPrice`, and the latest price >= the lowest price * (1 + `callbackRate`) * SELL: the highest price after order placed >= `activationPrice`, and the latest price <= the highest price * (1 - `callbackRate`)  * For `TRAILING_STOP_MARKET`, if you got such error code. ``{\"code\": -2021, \"msg\": \"Order would immediately trigger.\"}`` means that the parameters you send do not meet the following requirements: * BUY: `activationPrice` should be smaller than latest price. * SELL: `activationPrice` should be larger than latest price.  * `STOP_MARKET`, `TAKE_PROFIT_MARKET` with `closePosition`=`true`: * Follow the same rules for condition orders. * If triggered，**close all** current long position( if `SELL`) or current short position( if `BUY`). * Cannot be used with `quantity` paremeter * Cannot be used with `reduceOnly` parameter * In Hedge Mode,cannot be used with `BUY` orders in `LONG` position side. and cannot be used with `SELL` orders in `SHORT` position side * `selfTradePreventionMode` is only effective when `timeInForce` set to `IOC` or `GTC` or `GTD`.  Weight: 0
+Send in a new algo order.  * Condition orders will be triggered when:  * If parameter`priceProtect`is sent as true: * when price reaches the `triggerPrice` ，the difference rate between \"MARK_PRICE\" and \"CONTRACT_PRICE\" cannot be larger than the \"triggerProtect\" of the symbol * \"triggerProtect\" of a symbol can be got from `GET /fapi/v1/exchangeInfo`  * `STOP`, `STOP_MARKET`: * BUY: latest price (\"MARK_PRICE\" or \"CONTRACT_PRICE\") >= `triggerPrice` * SELL: latest price (\"MARK_PRICE\" or \"CONTRACT_PRICE\") <= `triggerPrice` * `TAKE_PROFIT`, `TAKE_PROFIT_MARKET`: * BUY: latest price (\"MARK_PRICE\" or \"CONTRACT_PRICE\") <= `triggerPrice` * SELL: latest price (\"MARK_PRICE\" or \"CONTRACT_PRICE\") >= `triggerPrice` * `TRAILING_STOP_MARKET`: * BUY: the lowest price after order placed <= `activatePrice`, and the latest price >= the lowest price * (1 + `callbackRate`) * SELL: the highest price after order placed >= `activatePrice`, and the latest price <= the highest price * (1 - `callbackRate`)  * For `TRAILING_STOP_MARKET`, if you got such error code. ``{\"code\": -2021, \"msg\": \"Order would immediately trigger.\"}`` means that the parameters you send do not meet the following requirements: * BUY: `activatePrice` should be smaller than latest price. * SELL: `activatePrice` should be larger than latest price.  * `STOP_MARKET`, `TAKE_PROFIT_MARKET` with `closePosition`=`true`: * Follow the same rules for condition orders. * If triggered，**close all** current long position( if `SELL`) or current short position( if `BUY`). * Cannot be used with `quantity` paremeter * Cannot be used with `reduceOnly` parameter * In Hedge Mode,cannot be used with `BUY` orders in `LONG` position side. and cannot be used with `SELL` orders in `SHORT` position side * `selfTradePreventionMode` is only effective when `timeInForce` set to `IOC` or `GTC` or `GTD`.  Weight: 0
 
 ### Example
 ```java

clients/derivatives-trading-usds-futures/docs/WebsocketMarketStreamsApi.md

@@ -32,7 +32,7 @@ All URIs are relative to *http://localhost*
 
 Aggregate Trade Streams
 
-The Aggregate Trade Streams push market trade information that is aggregated for fills with same price and taking side every 100 milliseconds. Only market trades will be aggregated, which means the insurance fund trades and ADL trades won't be aggregated.   Retail Price Improvement(RPI) orders are aggregated and without special tags to be distinguished.  Update Speed: 100ms
+The Aggregate Trade Streams push market trade information that is aggregated for fills with same price and taking side every 100 milliseconds. Only market trades will be aggregated, which means the insurance fund trades and ADL trades won't be aggregated.   Retail Price Improvement(RPI) orders are aggregated into field `q` and without special tags to be distinguished.  Update Speed: 100ms
 
 ### Example
 ```java
@@ -962,7 +962,7 @@ No authorization required
 
 Mark Price Stream for All market
 
-Mark price and funding rate for all symbols pushed every 3 seconds or every second.  **Note**:  This stream does not cover TradFi Perps.  Update Speed: 3000ms or 1000ms
+Mark price and funding rate for all symbols pushed every 3 seconds or every second.  **Note**:  TradFi symbols will be pushed through a seperate message.  Update Speed: 3000ms or 1000ms
 
 ### Example
 ```java
@@ -1210,7 +1210,7 @@ No authorization required
 
 Trading Session Stream
 
-Trading session information of U.S. equity market and commodity market which updates every second. Trading session information of different markets is pushed in seperate messages. Session types of equity market include \"PRE_MARKET\", \"REGULAR\", \"AFTER_MARKET\", \"OVERNIGHT\" and \"NO_TRADING\". And session types of commodity market include \"REGULAR\" and \"NO_TRADING\".  Update Speed: 1s
+Trading session information for the underlying assets of TradFi Perpetual contracts—covering the U.S. equity market and the commodity market—is updated every second. Trading session information for different underlying markets is pushed in separate messages. Session types for the equity market include \"PRE_MARKET\", \"REGULAR\", \"AFTER_MARKET\", \"OVERNIGHT\", and \"NO_TRADING\". Session types for the commodity market include \"REGULAR\" and \"NO_TRADING\".  Update Speed: 1s
 
 ### Example
 ```java

clients/derivatives-trading-usds-futures/docs/rest-api/migration-guide.md

@@ -22,7 +22,7 @@ With the transition to a modularized structure, the Binance Connector has been s
 <dependency>
   <groupId>io.github.binance</groupId>
   <artifactId>binance-derivatives-trading-usds-futures</artifactId>
-  <version>7.0.0</version>
+  <version>8.0.0</version>
 </dependency>
 ```
 
@@ -91,7 +91,7 @@ by:
  <dependency>
      <groupId>io.github.binance</groupId>
      <artifactId>binance-derivatives-trading-usds-futures</artifactId>
-     <version>7.0.0</version>
+     <version>8.0.0</version>
  </dependency>
 ```