SDKs & Tools

JavaScript

Copy page

The official JavaScript connector for the Binance Web3 Wallet API, designed for backend applications running on Node.js.

The connector is published as the @binance-web3/wallet npm package. It supports the Web3 Wallet REST API and provides built-in request signing, connection management and TypeScript definitions.

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

Supported environments

• Node.js v22.12.0 or newer (LTS versions recommended)
• JavaScript and TypeScript backend applications

This connector is intended for server-side usage only.
Browser environments are not supported at this time.

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
• First-class TypeScript definitions
• Configurable timeouts, retries, and proxy support
• Consistent API design

Getting started

Install the package:

Code
npm install @binance-web3/wallet

Create a client and send a request:

Code
import { Web3Wallet, Web3WalletRestAPI } from "@binance-web3/wallet";

const configurationRestAPI = {
  apiKey: process.env.BINANCE_API_KEY,
  apiSecret: process.env.BINANCE_API_SECRET,
};
const client = new Web3Wallet({ configurationRestAPI });

const response = await client.restAPI.getSupportedChains();
const data = await response.data();

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