binance is an MIT-licensed Node.js and JavaScript SDK for Binance REST APIs and WebSockets, written in TypeScript and aimed at developers who build trading tools, bots, and integrations against Binance.

What it is

The package is a JavaScript and Node.js client library for Binance, published on npm as binance and hosted under the Siebly.io GitHub organisation after a migration from its previous home that requires no changes for existing users. It is promise-driven and TypeScript-first, with type declarations for all API requests and responses. Coverage spans Binance Spot, Margin, Isolated Margin, Portfolio, Options, USDM Futures, and CoinM Futures across both REST and WebSocket interfaces, and it supports every authentication mechanism Binance offers: HMAC, RSA, and Ed25519.

The concrete problem it solves is the integration work that would otherwise be hand-written against Binance directly. Request signing, WebSocket lifecycle, listenKey persistence, and silent connection drops all have to be handled correctly before any trading logic runs. This SDK handles silent WebSocket disconnections with timed heartbeats, including the scheduled 24-hour disconnect, refreshes listenKeys on expiration, and emits a reconnected event when a dropped connection is restored. It also replaces untyped JSON handling with strongly typed requests and responses.

Key capabilities

• REST API support for Binance Spot, Margin, Isolated Margin, Options, USDM and CoinM Futures.
• WebSockets for Spot, Margin, Isolated Margin, Portfolio, Options, USDM and CoinM Futures, with event-driven messaging.
• Authentication via HMAC, RSA and Ed25519; passing a private key as the secret automatically detects whether to switch to RSA or Ed25519.
• WebSocket API access through the WebsocketClient's sendWSAPIRequest() method or the WebsocketAPIClient for a REST-like experience.
• Smart WebSocket persistence: timed heartbeats, the scheduled 24-hour disconnect, listenKey persistence and refresh, and the reconnected event.
• Optional beautification of WebSocket events (one-letter keys expanded to descriptive words, float strings converted to numbers) and REST responses (numeric strings parsed to numbers).
• Proxy support through axios integration, plus typeguards for TypeScript users on most WebSocket events.

Who uses it and how

• Production livenet trading: the README describes the SDK as running with leading trading volume in production.
• JavaScript and TypeScript teams building bot and tooling services against npm, with browser support alongside Node.js.
• Algo traders working from the examples/REST and examples/WebSockets directories and from the related telegram group, Node.js Algo Traders.
• Environments that route outbound traffic through a proxy, which the axios integration covers.
• Maintainers who need release confidence: end-to-end tests run real API calls on most endpoints before anything is published to npm.

Getting started

Install the npm package binance from the npm registry at https://www.npmjs.com/package/binance, then follow the Binance JavaScript QuickStart Guide and the REST and WebSocket examples in the repository.

How it compares

Within the Developer Tools / API Development & Testing category, the facts name no comparable library or wrapper that this package replaces, and no list of paid products is provided. On this registry it stands alone.

When to use it — and when not to

This is a client library rather than a hosted service, so a self-hoster operates no database, storage layer, or SMTP service; the operational burden is API key management for HMAC, RSA, or Ed25519 credentials and the risk that comes with livenet trading. It is the wrong choice for venues other than Binance or for stacks outside JavaScript and TypeScript. One honest weakness: the README's usage and demo trading sections are thin, deferring fuller guidance to the external Siebly documentation, and the project carries 18 open issues.