Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion MIGRATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ For Spot (Spot package):
<dependency>
<groupId>io.github.binance</groupId>
<artifactId>binance-spot</artifactId>
<version>8.0.0</version>
<version>9.0.0</version>
</dependency>
```

Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ Each connector is published as a separate maven dependency. For example:
<dependency>
<groupId>io.github.binance</groupId>
<artifactId>binance-spot</artifactId>
<version>8.0.0</version>
<version>9.0.0</version>
</dependency>
```

Expand Down
17 changes: 16 additions & 1 deletion clients/convert/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,21 @@
# Changelog

## 2.0.0 - 2026-02-12

### Changed (1)

- Modified response for `placeLimitOrder()` (`POST /sapi/v1/convert/limit/placeOrder`):
- property `orderId` added
- property `status` added
- property `inverseRatio` deleted
- property `quoteId` deleted
- property `ratio` deleted
- property `toAmount` deleted
- property `validTimestamp` deleted
- property `fromAmount` deleted

## 1.2.1 - 2025-08-07

- Update `binance/common` module to version `2.0.0`.
- Add `Content-Type` header only if there is a body.

Expand All @@ -17,4 +32,4 @@

## 1.0.0 - 2025-04-24

- Initial release
- Initial release
8 changes: 2 additions & 6 deletions clients/convert/docs/PlaceLimitOrderResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,8 @@

| Name | Type | Description | Notes |
|------------ | ------------- | ------------- | -------------|
|**quoteId** | **String** | | [optional] |
|**ratio** | **String** | | [optional] |
|**inverseRatio** | **String** | | [optional] |
|**validTimestamp** | **Long** | | [optional] |
|**toAmount** | **String** | | [optional] |
|**fromAmount** | **String** | | [optional] |
|**orderId** | **Long** | | [optional] |
|**status** | **String** | | [optional] |



10 changes: 5 additions & 5 deletions clients/convert/docs/TradeApi.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ All URIs are relative to *https://api.binance.com*
| [**getConvertTradeHistory**](TradeApi.md#getConvertTradeHistory) | **GET** /sapi/v1/convert/tradeFlow | Get Convert Trade History(USER_DATA) |
| [**orderStatus**](TradeApi.md#orderStatus) | **GET** /sapi/v1/convert/orderStatus | Order status(USER_DATA) |
| [**placeLimitOrder**](TradeApi.md#placeLimitOrder) | **POST** /sapi/v1/convert/limit/placeOrder | Place limit order (USER_DATA) |
| [**queryLimitOpenOrders**](TradeApi.md#queryLimitOpenOrders) | **POST** /sapi/v1/convert/limit/queryOpenOrders | Query limit open orders (USER_DATA) |
| [**queryLimitOpenOrders**](TradeApi.md#queryLimitOpenOrders) | **GET** /sapi/v1/convert/limit/queryOpenOrders | Query limit open orders (USER_DATA) |
| [**sendQuoteRequest**](TradeApi.md#sendQuoteRequest) | **POST** /sapi/v1/convert/getQuote | Send Quote Request(USER_DATA) |


Expand Down Expand Up @@ -333,7 +333,7 @@ No authorization required

<a id="queryLimitOpenOrders"></a>
# **queryLimitOpenOrders**
> QueryLimitOpenOrdersResponse queryLimitOpenOrders(queryLimitOpenOrdersRequest)
> QueryLimitOpenOrdersResponse queryLimitOpenOrders(recvWindow)

Query limit open orders (USER_DATA)

Expand All @@ -354,9 +354,9 @@ public class Example {
defaultClient.setBasePath("https://api.binance.com");

TradeApi apiInstance = new TradeApi(defaultClient);
QueryLimitOpenOrdersRequest queryLimitOpenOrdersRequest = new QueryLimitOpenOrdersRequest(); // QueryLimitOpenOrdersRequest |
Long recvWindow = 56L; // Long | The value cannot be greater than 60000
try {
QueryLimitOpenOrdersResponse result = apiInstance.queryLimitOpenOrders(queryLimitOpenOrdersRequest);
QueryLimitOpenOrdersResponse result = apiInstance.queryLimitOpenOrders(recvWindow);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling TradeApi#queryLimitOpenOrders");
Expand All @@ -373,7 +373,7 @@ public class Example {

| Name | Type | Description | Notes |
|------------- | ------------- | ------------- | -------------|
| **queryLimitOpenOrdersRequest** | [**QueryLimitOpenOrdersRequest**](QueryLimitOpenOrdersRequest.md)| | |
| **recvWindow** | **Long**| The value cannot be greater than 60000 | [optional] |

### Return type

Expand Down
4 changes: 2 additions & 2 deletions clients/convert/docs/rest-api/migration-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -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-convert</artifactId>
<version>1.2.1</version>
<version>2.0.0</version>
</dependency>
```

Expand Down Expand Up @@ -91,7 +91,7 @@ by:
<dependency>
<groupId>io.github.binance</groupId>
<artifactId>binance-convert</artifactId>
<version>1.2.1</version>
<version>2.0.0</version>
</dependency>
```

Expand Down
2 changes: 1 addition & 1 deletion clients/convert/example_rest.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

[POST /sapi/v1/convert/limit/placeOrder](https://developers.binance.com/docs/convert/trade/Place-Order) - placeLimitOrder - [PlaceLimitOrderExample.java:50](/examples/convert/src/main/java/com/binance/connector/client/convert/rest/trade/PlaceLimitOrderExample.java#L50)

[POST /sapi/v1/convert/limit/queryOpenOrders](https://developers.binance.com/docs/convert/trade/Query-Order) - queryLimitOpenOrders - [QueryLimitOpenOrdersExample.java:47](/examples/convert/src/main/java/com/binance/connector/client/convert/rest/trade/QueryLimitOpenOrdersExample.java#L47)
[GET /sapi/v1/convert/limit/queryOpenOrders](https://developers.binance.com/docs/convert/trade/Query-Order) - queryLimitOpenOrders - [QueryLimitOpenOrdersExample.java:46](/examples/convert/src/main/java/com/binance/connector/client/convert/rest/trade/QueryLimitOpenOrdersExample.java#L46)

[POST /sapi/v1/convert/getQuote](https://developers.binance.com/docs/convert/trade/Send-quote-request) - sendQuoteRequest - [SendQuoteRequestExample.java:49](/examples/convert/src/main/java/com/binance/connector/client/convert/rest/trade/SendQuoteRequestExample.java#L49)

4 changes: 2 additions & 2 deletions clients/convert/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<modelVersion>4.0.0</modelVersion>
<artifactId>binance-convert</artifactId>
<name>convert</name>
<version>1.2.1</version>
<version>2.0.0</version>
<packaging>jar</packaging>

<parent>
Expand All @@ -31,7 +31,7 @@
<dependency>
<groupId>io.github.binance</groupId>
<artifactId>binance-common</artifactId>
<version>2.0.0</version>
<version>2.3.1</version>
</dependency>
</dependencies>
</project>
Original file line number Diff line number Diff line change
Expand Up @@ -141,9 +141,6 @@ private static Class getClassByDiscriminator(
gsonBuilder.registerTypeAdapterFactory(
new com.binance.connector.client.convert.rest.model.PlaceLimitOrderResponse
.CustomTypeAdapterFactory());
gsonBuilder.registerTypeAdapterFactory(
new com.binance.connector.client.convert.rest.model.QueryLimitOpenOrdersRequest
.CustomTypeAdapterFactory());
gsonBuilder.registerTypeAdapterFactory(
new com.binance.connector.client.convert.rest.model.QueryLimitOpenOrdersResponse
.CustomTypeAdapterFactory());
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,6 @@
import com.binance.connector.client.convert.rest.model.OrderStatusResponse;
import com.binance.connector.client.convert.rest.model.PlaceLimitOrderRequest;
import com.binance.connector.client.convert.rest.model.PlaceLimitOrderResponse;
import com.binance.connector.client.convert.rest.model.QueryLimitOpenOrdersRequest;
import com.binance.connector.client.convert.rest.model.QueryLimitOpenOrdersResponse;
import com.binance.connector.client.convert.rest.model.QueryOrderQuantityPrecisionPerAssetResponse;
import com.binance.connector.client.convert.rest.model.SendQuoteRequestRequest;
Expand Down Expand Up @@ -207,7 +206,7 @@ public ApiResponse<PlaceLimitOrderResponse> placeLimitOrder(
* Query limit open orders (USER_DATA) Request a quote for the requested token pairs Weight:
* 3000(UID)
*
* @param queryLimitOpenOrdersRequest (required)
* @param recvWindow The value cannot be greater than 60000 (optional)
* @return ApiResponse&lt;QueryLimitOpenOrdersResponse&gt;
* @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the
* response body
Expand All @@ -221,9 +220,9 @@ public ApiResponse<PlaceLimitOrderResponse> placeLimitOrder(
* @see <a href="https://developers.binance.com/docs/convert/trade/Query-Order">Query limit open
* orders (USER_DATA) Documentation</a>
*/
public ApiResponse<QueryLimitOpenOrdersResponse> queryLimitOpenOrders(
QueryLimitOpenOrdersRequest queryLimitOpenOrdersRequest) throws ApiException {
return tradeApi.queryLimitOpenOrders(queryLimitOpenOrdersRequest);
public ApiResponse<QueryLimitOpenOrdersResponse> queryLimitOpenOrders(Long recvWindow)
throws ApiException {
return tradeApi.queryLimitOpenOrders(recvWindow);
}

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ public class MarketDataApi {

private static final String USER_AGENT =
String.format(
"binance-convert/1.2.1 (Java/%s; %s; %s)",
"binance-convert/2.0.0 (Java/%s; %s; %s)",
SystemUtil.getJavaVersion(), SystemUtil.getOs(), SystemUtil.getArch());
private static final boolean HAS_TIME_UNIT = false;

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,6 @@
import com.binance.connector.client.convert.rest.model.OrderStatusResponse;
import com.binance.connector.client.convert.rest.model.PlaceLimitOrderRequest;
import com.binance.connector.client.convert.rest.model.PlaceLimitOrderResponse;
import com.binance.connector.client.convert.rest.model.QueryLimitOpenOrdersRequest;
import com.binance.connector.client.convert.rest.model.QueryLimitOpenOrdersResponse;
import com.binance.connector.client.convert.rest.model.SendQuoteRequestRequest;
import com.binance.connector.client.convert.rest.model.SendQuoteRequestResponse;
Expand All @@ -55,7 +54,7 @@ public class TradeApi {

private static final String USER_AGENT =
String.format(
"binance-convert/1.2.1 (Java/%s; %s; %s)",
"binance-convert/2.0.0 (Java/%s; %s; %s)",
SystemUtil.getJavaVersion(), SystemUtil.getOs(), SystemUtil.getArch());
private static final boolean HAS_TIME_UNIT = false;

Expand Down Expand Up @@ -842,7 +841,7 @@ public ApiResponse<PlaceLimitOrderResponse> placeLimitOrder(
/**
* Build call for queryLimitOpenOrders
*
* @param queryLimitOpenOrdersRequest (required)
* @param recvWindow The value cannot be greater than 60000 (optional)
* @return Call to execute
* @throws ApiException If fail to serialize the request body object
* @http.response.details
Expand All @@ -855,8 +854,7 @@ public ApiResponse<PlaceLimitOrderResponse> placeLimitOrder(
* @see <a href="https://developers.binance.com/docs/convert/trade/Query-Order">Query limit open
* orders (USER_DATA) Documentation</a>
*/
private okhttp3.Call queryLimitOpenOrdersCall(
QueryLimitOpenOrdersRequest queryLimitOpenOrdersRequest) throws ApiException {
private okhttp3.Call queryLimitOpenOrdersCall(Long recvWindow) throws ApiException {
String basePath = null;
// Operation Servers
String[] localBasePaths = new String[] {};
Expand All @@ -881,8 +879,8 @@ private okhttp3.Call queryLimitOpenOrdersCall(
Map<String, String> localVarCookieParams = new HashMap<String, String>();
Map<String, Object> localVarFormParams = new HashMap<String, Object>();

if (queryLimitOpenOrdersRequest.getRecvWindow() != null) {
localVarFormParams.put("recvWindow", queryLimitOpenOrdersRequest.getRecvWindow());
if (recvWindow != null) {
localVarQueryParams.addAll(localVarApiClient.parameterToPair("recvWindow", recvWindow));
}

final String[] localVarAccepts = {"application/json"};
Expand All @@ -905,7 +903,7 @@ private okhttp3.Call queryLimitOpenOrdersCall(
return localVarApiClient.buildCall(
basePath,
localVarPath,
"POST",
"GET",
localVarQueryParams,
localVarCollectionQueryParams,
localVarPostBody,
Expand All @@ -916,8 +914,8 @@ private okhttp3.Call queryLimitOpenOrdersCall(
}

@SuppressWarnings("rawtypes")
private okhttp3.Call queryLimitOpenOrdersValidateBeforeCall(
QueryLimitOpenOrdersRequest queryLimitOpenOrdersRequest) throws ApiException {
private okhttp3.Call queryLimitOpenOrdersValidateBeforeCall(Long recvWindow)
throws ApiException {
try {
Validator validator =
Validation.byDefaultProvider()
Expand All @@ -927,15 +925,13 @@ private okhttp3.Call queryLimitOpenOrdersValidateBeforeCall(
.getValidator();
ExecutableValidator executableValidator = validator.forExecutables();

Object[] parameterValues = {queryLimitOpenOrdersRequest};
Method method =
this.getClass()
.getMethod("queryLimitOpenOrders", QueryLimitOpenOrdersRequest.class);
Object[] parameterValues = {recvWindow};
Method method = this.getClass().getMethod("queryLimitOpenOrders", Long.class);
Set<ConstraintViolation<TradeApi>> violations =
executableValidator.validateParameters(this, method, parameterValues);

if (violations.size() == 0) {
return queryLimitOpenOrdersCall(queryLimitOpenOrdersRequest);
return queryLimitOpenOrdersCall(recvWindow);
} else {
throw new ConstraintViolationException((Set) violations);
}
Expand All @@ -952,7 +948,7 @@ private okhttp3.Call queryLimitOpenOrdersValidateBeforeCall(
* Query limit open orders (USER_DATA) Request a quote for the requested token pairs Weight:
* 3000(UID)
*
* @param queryLimitOpenOrdersRequest (required)
* @param recvWindow The value cannot be greater than 60000 (optional)
* @return ApiResponse&lt;QueryLimitOpenOrdersResponse&gt;
* @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the
* response body
Expand All @@ -966,11 +962,9 @@ private okhttp3.Call queryLimitOpenOrdersValidateBeforeCall(
* @see <a href="https://developers.binance.com/docs/convert/trade/Query-Order">Query limit open
* orders (USER_DATA) Documentation</a>
*/
public ApiResponse<QueryLimitOpenOrdersResponse> queryLimitOpenOrders(
@Valid @NotNull QueryLimitOpenOrdersRequest queryLimitOpenOrdersRequest)
public ApiResponse<QueryLimitOpenOrdersResponse> queryLimitOpenOrders(Long recvWindow)
throws ApiException {
okhttp3.Call localVarCall =
queryLimitOpenOrdersValidateBeforeCall(queryLimitOpenOrdersRequest);
okhttp3.Call localVarCall = queryLimitOpenOrdersValidateBeforeCall(recvWindow);
java.lang.reflect.Type localVarReturnType =
new TypeToken<QueryLimitOpenOrdersResponse>() {}.getType();
return localVarApiClient.execute(localVarCall, localVarReturnType);
Expand Down
Loading
Loading