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
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions clients/wallet/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,26 @@
# Changelog

## 5.0.0 - 2026-06-30

### Added (2)

- `getCountryList()` (`GET /sapi/v1/localentity/country/list`)
- `getRegionList()` (`GET /sapi/v1/localentity/region/list`)

### Changed (3)

- Added parameter `accountType`
- affected methods:
- `dustConvert()` (`POST /sapi/v1/asset/dust-convert/convert`)
- `dustConvertibleAssets()` (`POST /sapi/v1/asset/dust-convert/query-convertible-assets`)
- Modified response for `brokerWithdraw()` (`POST /sapi/v1/localentity/broker/withdraw/apply`):
- property `accepted` added
- property `accpted` deleted

- Modified response for `withdrawTravelRule()` (`POST /sapi/v1/localentity/withdraw/apply`):
- property `accepted` added
- property `accpted` deleted

## 4.0.1 - 2026-04-30

- Update `binance/common` module to version `2.4.2`.
Expand Down
2 changes: 1 addition & 1 deletion clients/wallet/docs/BrokerWithdrawResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
| Name | Type | Description | Notes |
|------------ | ------------- | ------------- | -------------|
|**trId** | **Long** | | [optional] |
|**accpted** | **Boolean** | | [optional] |
|**accepted** | **Boolean** | | [optional] |
|**info** | **String** | | [optional] |


Expand Down
2 changes: 1 addition & 1 deletion clients/wallet/docs/CapitalApi.md
Original file line number Diff line number Diff line change
Expand Up @@ -471,7 +471,7 @@ No authorization required

Withdraw(USER_DATA)

Submit a withdraw request. * If `network` not send, return with default network of the coin. * You can get `network` and `isDefault` in `networkList` of a coin in the response of `Get /sapi/v1/capital/config/getall (HMAC SHA256)`. * To check if travel rule is required, by using `GET /sapi/v1/localentity/questionnaire-requirements` and if it returns anything other than `NIL` you will need update SAPI to `POST /sapi/v1/localentity/withdraw/apply` else you can continue `POST /sapi/v1/capital/withdraw/apply`. Please note that if you are required to comply to travel rule please refer to the Travel Rule SAPI. Weight: 900
Submit a withdraw request. * If `network` not send, return with default network of the coin. * You can get `network` and `isDefault` in `networkList` of a coin in the response of `Get /sapi/v1/capital/config/getall (HMAC SHA256)`. * To check if travel rule is required, by using `GET /sapi/v1/localentity/questionnaire-requirements` and if it returns anything other than `NIL` you will need update SAPI to `POST /sapi/v1/localentity/withdraw/apply` else you can continue `POST /sapi/v1/capital/withdraw/apply`. Please note that if you are required to comply to travel rule please refer to the Travel Rule SAPI. * For networks that do not support memo/tag, submitting a withdrawal request with a non-empty `addressTag` will return error `-4106 TAG_NOT_SUPPORTED_FOR_NETWORK`. Please omit the `addressTag` field for such networks. You can check whether a network requires a tag via `GET /sapi/v1/capital/config/getall`: * If `withdrawTag` = `true` → memo/tag is required. * If `withdrawTag` = `false` → memo/tag is not supported; omit `addressTag`. Weight: 900

### Example
```java
Expand Down
1 change: 1 addition & 0 deletions clients/wallet/docs/DustConvertRequest.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@
| Name | Type | Description | Notes |
|------------ | ------------- | ------------- | -------------|
|**asset** | **String** | | |
|**accountType** | **String** | | [optional] |
|**clientId** | **String** | | [optional] |
|**targetAsset** | **String** | | [optional] |
|**thirdPartyClientId** | **String** | | [optional] |
Expand Down
1 change: 1 addition & 0 deletions clients/wallet/docs/DustConvertibleAssetsRequest.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@

| Name | Type | Description | Notes |
|------------ | ------------- | ------------- | -------------|
|**accountType** | **String** | | [optional] |
|**targetAsset** | **String** | | |
|**dustQuotaAssetToTargetAssetPrice** | **Double** | | [optional] |

Expand Down
14 changes: 14 additions & 0 deletions clients/wallet/docs/GetCountryListResponse.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@


# GetCountryListResponse


## Properties

| Name | Type | Description | Notes |
|------------ | ------------- | ------------- | -------------|
|**countries** | [**List<GetCountryListResponseCountriesInner>**](GetCountryListResponseCountriesInner.md) | | [optional] |
|**lastUpdated** | **Long** | | [optional] |



18 changes: 18 additions & 0 deletions clients/wallet/docs/GetCountryListResponseCountriesInner.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@


# GetCountryListResponseCountriesInner


## Properties

| Name | Type | Description | Notes |
|------------ | ------------- | ------------- | -------------|
|**countryCode** | **String** | | [optional] |
|**countryName** | **String** | | [optional] |
|**blockType** | **String** | | [optional] |
|**depositAllowed** | **Boolean** | | [optional] |
|**withdrawalAllowed** | **Boolean** | | [optional] |
|**hasRegionRestrictions** | **Boolean** | | [optional] |



15 changes: 15 additions & 0 deletions clients/wallet/docs/GetRegionListResponse.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@


# GetRegionListResponse


## Properties

| Name | Type | Description | Notes |
|------------ | ------------- | ------------- | -------------|
|**countryCode** | **String** | | [optional] |
|**regions** | [**List<GetRegionListResponseRegionsInner>**](GetRegionListResponseRegionsInner.md) | | [optional] |
|**lastUpdated** | **Long** | | [optional] |



16 changes: 16 additions & 0 deletions clients/wallet/docs/GetRegionListResponseRegionsInner.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@


# GetRegionListResponseRegionsInner


## Properties

| Name | Type | Description | Notes |
|------------ | ------------- | ------------- | -------------|
|**regionName** | **String** | | [optional] |
|**blockType** | **String** | | [optional] |
|**depositAllowed** | **Boolean** | | [optional] |
|**withdrawalAllowed** | **Boolean** | | [optional] |



126 changes: 124 additions & 2 deletions clients/wallet/docs/TravelRuleApi.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ All URIs are relative to *https://api.binance.com*
| [**depositHistoryTravelRule**](TravelRuleApi.md#depositHistoryTravelRule) | **GET** /sapi/v1/localentity/deposit/history | Deposit History (for local entities that required travel rule) (supporting network) (USER_DATA) |
| [**depositHistoryV2**](TravelRuleApi.md#depositHistoryV2) | **GET** /sapi/v2/localentity/deposit/history | Deposit History V2 (for local entities that required travel rule) (supporting network) (USER_DATA) |
| [**fetchAddressVerificationList**](TravelRuleApi.md#fetchAddressVerificationList) | **GET** /sapi/v1/addressVerify/list | Fetch address verification list (USER_DATA) |
| [**getCountryList**](TravelRuleApi.md#getCountryList) | **GET** /sapi/v1/localentity/country/list | Get Country List (USER_DATA) |
| [**getRegionList**](TravelRuleApi.md#getRegionList) | **GET** /sapi/v1/localentity/region/list | Get Region List (USER_DATA) |
| [**submitDepositQuestionnaire**](TravelRuleApi.md#submitDepositQuestionnaire) | **PUT** /sapi/v1/localentity/broker/deposit/provide-info | Submit Deposit Questionnaire (For local entities that require travel rule) (supporting network) (USER_DATA) |
| [**submitDepositQuestionnaireTravelRule**](TravelRuleApi.md#submitDepositQuestionnaireTravelRule) | **PUT** /sapi/v1/localentity/deposit/provide-info | Submit Deposit Questionnaire (For local entities that require travel rule) (supporting network) (USER_DATA) |
| [**submitDepositQuestionnaireV2**](TravelRuleApi.md#submitDepositQuestionnaireV2) | **PUT** /sapi/v2/localentity/deposit/provide-info | Submit Deposit Questionnaire V2 (For local entities that require travel rule) (supporting network) (USER_DATA) |
Expand Down Expand Up @@ -148,7 +150,7 @@ No authorization required

Deposit History (for local entities that required travel rule) (supporting network) (USER_DATA)

Fetch deposit history for local entities that required travel rule. * Please notice the default `startTime` and `endTime` to make sure that time interval is within * If both ``startTime`` and ``endTime`` are sent, time between ``startTime`` and ``endTime`` must Weight: 1
Fetch deposit history for local entities that required travel rule. * Please notice the default `startTime` and `endTime` to make sure that time interval is within * If both ``startTime`` and ``endTime`` are sent, time between ``startTime`` and ``endTime`` must * Please, note that due to network-specific characteristics, the returned source address may be inaccurate. If multiple source addresses are found, only the first one will be returned. Weight: 1

### Example
```java
Expand Down Expand Up @@ -230,7 +232,7 @@ No authorization required

Deposit History V2 (for local entities that required travel rule) (supporting network) (USER_DATA)

Fetch deposit history for local entities that with required travel rule information. * Please notice the default `startTime` and `endTime` to make sure that time interval is within * If both ``startTime`` and ``endTime`` are sent, time between ``startTime`` and ``endTime`` must Weight: 1
Fetch deposit history for local entities that with required travel rule information. * Please notice the default `startTime` and `endTime` to make sure that time interval is within * If both ``startTime`` and ``endTime`` are sent, time between ``startTime`` and ``endTime`` must * Please, note that due to network-specific characteristics, the returned source address may be inaccurate. If multiple source addresses are found, only the first one will be returned. Weight: 1

### Example
```java
Expand Down Expand Up @@ -364,6 +366,126 @@ No authorization required
|-------------|-------------|------------------|
| **200** | Fetch address verification list | - |

<a id="getCountryList"></a>
# **getCountryList**
> GetCountryListResponse getCountryList()

Get Country List (USER_DATA)

Query the active country list for travel rule questionnaires. Currently, only supports AU entity. Weight: 1

### Example
```java
// Import classes:
import com.binance.connector.client.wallet.ApiClient;
import com.binance.connector.client.wallet.ApiException;
import com.binance.connector.client.wallet.Configuration;
import com.binance.connector.client.wallet.models.*;
import com.binance.connector.client.wallet.rest.api.TravelRuleApi;

public class Example {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
defaultClient.setBasePath("https://api.binance.com");

TravelRuleApi apiInstance = new TravelRuleApi(defaultClient);
try {
GetCountryListResponse result = apiInstance.getCountryList();
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling TravelRuleApi#getCountryList");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
```

### Parameters
This endpoint does not need any parameter.

### Return type

[**GetCountryListResponse**](GetCountryListResponse.md)

### Authorization

No authorization required

### HTTP request headers

- **Content-Type**: application/x-www-form-urlencoded
- **Accept**: application/json

### HTTP response details
| Status code | Description | Response headers |
|-------------|-------------|------------------|
| **200** | Get Country List | - |

<a id="getRegionList"></a>
# **getRegionList**
> GetRegionListResponse getRegionList(countryCode)

Get Region List (USER_DATA)

Query the active region/city list for a given country. Currently, only supports AU entity. Weight: 1

### Example
```java
// Import classes:
import com.binance.connector.client.wallet.ApiClient;
import com.binance.connector.client.wallet.ApiException;
import com.binance.connector.client.wallet.Configuration;
import com.binance.connector.client.wallet.models.*;
import com.binance.connector.client.wallet.rest.api.TravelRuleApi;

public class Example {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
defaultClient.setBasePath("https://api.binance.com");

TravelRuleApi apiInstance = new TravelRuleApi(defaultClient);
String countryCode = "countryCode_example"; // String | ISO 2-digit country code (from `Country List` API).
try {
GetRegionListResponse result = apiInstance.getRegionList(countryCode);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling TravelRuleApi#getRegionList");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
```

### Parameters

| Name | Type | Description | Notes |
|------------- | ------------- | ------------- | -------------|
| **countryCode** | **String**| ISO 2-digit country code (from &#x60;Country List&#x60; API). | |

### Return type

[**GetRegionListResponse**](GetRegionListResponse.md)

### Authorization

No authorization required

### HTTP request headers

- **Content-Type**: application/x-www-form-urlencoded
- **Accept**: application/json

### HTTP response details
| Status code | Description | Response headers |
|-------------|-------------|------------------|
| **200** | Get Region List | - |

<a id="submitDepositQuestionnaire"></a>
# **submitDepositQuestionnaire**
> SubmitDepositQuestionnaireResponse submitDepositQuestionnaire(submitDepositQuestionnaireRequest)
Expand Down
3 changes: 2 additions & 1 deletion clients/wallet/docs/VaspListResponseInner.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,9 @@

| Name | Type | Description | Notes |
|------------ | ------------- | ------------- | -------------|
|**vaspName** | **String** | | [optional] |
|**vaspCode** | **String** | | [optional] |
|**vaspName** | **String** | | [optional] |
|**identifier** | **String** | | [optional] |



2 changes: 1 addition & 1 deletion clients/wallet/docs/WithdrawTravelRuleResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
| Name | Type | Description | Notes |
|------------ | ------------- | ------------- | -------------|
|**trId** | **Long** | | [optional] |
|**accpted** | **Boolean** | | [optional] |
|**accepted** | **Boolean** | | [optional] |
|**info** | **String** | | [optional] |


Expand Down
4 changes: 2 additions & 2 deletions clients/wallet/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-wallet</artifactId>
<version>4.0.0</version>
<version>5.0.0</version>
</dependency>
```

Expand Down Expand Up @@ -91,7 +91,7 @@ by:
<dependency>
<groupId>io.github.binance</groupId>
<artifactId>binance-wallet</artifactId>
<version>4.0.0</version>
<version>5.0.0</version>
</dependency>
```

Expand Down
Loading
Loading