SDK 与工具

Java

Copy page

Binance Web3 Wallet API 官方 Java 连接器，专为运行在 JVM 上的后端应用程序和服务而设计。

该连接器为 Web3 Wallet REST API 提供符合 Java 惯例的接口，内置请求签名以及强类型的请求与响应模型，助您构建可靠且易于维护的集成方案。

如需查看源代码、问题反馈及版本说明，请访问 GitHub 上的 binance-web3-connector-java 仓库。

支持的环境

• Java 11 或更高版本
• 后端 Java 应用程序及基于 JVM 的服务

本连接器仅适用于服务端使用。

典型使用场景

• 查询余额、交易记录及支持链的后端服务
• 构建并提交兑换与转账交易
• 将 Web3 Wallet 行情与价格数据集成到后端系统

主要特性

• 支持 Binance Web3 Wallet REST API
• 内置针对需要身份验证接口的请求签名
• 强类型的请求与响应模型
• 一致且符合 Java 惯例的 API 设计

快速开始

添加 Web3 Wallet 连接器依赖项：

Code
<dependency>
  <groupId>io.github.binance</groupId>
  <artifactId>binance-web3-wallet</artifactId>
  <version><!-- 最新版本 --></version>
</dependency>

创建客户端并发送请求：

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();
    }
}

上述示例使用基于 API Secret 的 HMAC 身份验证。同样支持使用私钥的非对称密钥身份验证方式。

如需 REST API 示例，请参阅该包的文档。

注意事项与最佳实践

• 使用环境变量或密钥管理工具安全存储 API 密钥
• 构建高吞吐量服务时，注意监控频率限制和接口权重