SDKs & Tools

Java

Copy page

The official Java connector for the Binance Web3 Wallet API, designed for backend applications and services running on the JVM.

The connector provides an idiomatic Java interface to the Web3 Wallet REST API. It includes built-in request signing and strongly typed request and response models to help you build reliable and maintainable integrations.

For source code, issues, and release notes, see the binance-web3-connector-java repository on GitHub.

Supported environments

• Java 11 or newer
• Backend Java applications and JVM-based services

This connector is intended for server-side usage only.

Typical use cases

• Backend services querying balances, transactions, and supported chains
• Building and submitting swap and transfer transactions
• Integrating Web3 Wallet market and pricing data into backend systems

Key features

• Support for the Binance Web3 Wallet REST API
• Built-in request signing for authenticated endpoints
• Strongly typed request and response models
• Consistent and idiomatic Java API design

Getting started

Add the dependency for the Web3 Wallet connector:

Code
<dependency>
  <groupId>io.github.binance</groupId>
  <artifactId>binance-web3-wallet</artifactId>
  <version><!-- latest version --></version>
</dependency>

Create a client and send a request:

Code
import com.binance.connector.client.common.configuration.ClientConfiguration;
import com.binance.connector.client.common.configuration.SignatureConfiguration;
import com.binance.connector.client.web3_wallet.rest.Web3WalletRestApiUtil;
import com.binance.connector.client.web3_wallet.rest.api.Web3WalletRestApi;

public class Main {
    public static void main(String[] args) throws Exception {
        SignatureConfiguration signatureConfiguration = new SignatureConfiguration();
        signatureConfiguration.setApiKey(System.getenv("BINANCE_API_KEY"));
        signatureConfiguration.setSecretKey(System.getenv("BINANCE_API_SECRET"));

        ClientConfiguration clientConfiguration = Web3WalletRestApiUtil.getClientConfiguration();
        clientConfiguration.setSignatureConfiguration(signatureConfiguration);

        Web3WalletRestApi web3WalletApi = new Web3WalletRestApi(clientConfiguration);
        web3WalletApi.getSupportedChains();
    }
}

The example above uses HMAC-based authentication. Asymmetric key authentication using a private key is also supported.

Refer to the package documentation for REST API examples.

Notes and best practices

• Store API keys securely using environment variables or a secrets manager
• Monitor rate limits and endpoint weights when building high-throughput services