binance 3.0.6 → 3.0.7

package/llms.txt

@@ -1091,6 +1091,63 @@ function onUserDataEvent(data: WsUserDataEvents)
 // wsClient.subscribeMarginUserDataStream();
 // wsClient.subscribeIsolatedMarginUserDataStream('BTCUSDT');
 
+================
+File: examples/WebSockets/ws-userdata-listenKey-testnet.ts
+================
+import {
+  DefaultLogger,
+  isWsFormattedFuturesUserDataEvent,
+  isWsFormattedSpotUserDataEvent,
+  isWsFormattedSpotUserDataExecutionReport,
+  isWsFormattedUserDataEvent,
+  WebsocketClient,
+  WsUserDataEvents,
+} from '../../src/index';
+⋮----
+// or
+// import { DefaultLogger, WebsocketClient } from 'binance';
+⋮----
+// console.log('using api credentials: ', { key, secret });
+⋮----
+// Optional, hook and customise logging behavior
+⋮----
+// If you prefer, you can receive raw unprocessed data without the "beautifier":
+// wsClient.on('message', (data) => {
+//   console.log('raw message received ', JSON.stringify(data, null, 2));
+// });
+⋮----
+function onUserDataEvent(data: WsUserDataEvents)
+⋮----
+// the market denotes which API category it came from
+// if (data.wsMarket.includes('spot')) {
+⋮----
+// or use a type guard, if one exists (PRs welcome)
+⋮----
+// Beautified/formatted events from binance:
+⋮----
+// The wsKey can be parsed to determine the type of message (what websocket it came from)
+// if (!Array.isArray(data) && data.wsKey.includes('userData')) {
+//   return onUserDataEvent(data);
+// }
+⋮----
+// or use a type guard if available
+⋮----
+// response to command sent via WS stream (e.g LIST_SUBSCRIPTIONS)
+⋮----
+// This is a good place to check your own state is still in sync with the account state on the exchange, in case any events were missed while the library was reconnecting:
+// - fetch balances
+// - fetch positions
+// - fetch orders
+⋮----
+// wsClient.subscribeMarginUserDataStream();
+// wsClient.subscribeIsolatedMarginUserDataStream('BTCUSDT');
+// wsClient.subscribeUsdFuturesUserDataStream();
+⋮----
+// setTimeout(() => {
+//   console.log('killing all connections');
+//   wsClient.closeAll();
+// }, 1000 * 15);
+
 ================
 File: src/types/websockets/ws-events-formatted.ts
 ================
@@ -1647,337 +1704,122 @@ export type WsFormattedMessage =
   | WsMessageMarkPriceUpdateEventFormatted[];
 
 ================
-File: src/types/websockets/ws-general.ts
+File: src/types/coin.ts
 ================
-import { AxiosRequestConfig } from 'axios';
-import WebSocket from 'isomorphic-ws';
-⋮----
-import { RestClientOptions } from '../../util/requestUtils';
-import { WsKey } from '../../util/websockets/websocket-util';
+import { FuturesContractType, PositionSide } from './futures';
+import { numberInString, OrderSide } from './shared';
 ⋮----
-export interface MessageEventLike {
-  target: WebSocket;
-  type: 'message';
-  data: string;
+export interface PositionRisk {
+  symbol: string;
+  positionAmt: numberInString;
+  entryPrice: numberInString;
+  markPrice: numberInString;
+  unRealizedProfit: numberInString;
+  liquidationPrice: numberInString;
+  leverage: numberInString;
+  maxQty: numberInString;
+  marginType: string;
+  isolatedMargin: numberInString;
+  isAutoAddMargin: boolean;
+  positionSide: PositionSide;
+  updateTime: number;
 }
 ⋮----
-export function isMessageEvent(msg: unknown): msg is MessageEventLike
-⋮----
-export type WsMarket =
-  | 'spot'
-  | 'spotTestnet'
-  | 'crossMargin'
-  | 'isolatedMargin'
-  | 'riskDataMargin'
-  | 'usdm'
-  | 'usdmTestnet'
-  | 'coinm'
-  | 'coinmTestnet'
-  | 'options'
-  | 'optionsTestnet'
-  | 'portfoliom';
-⋮----
-export interface WsSharedBase {
-  wsMarket: WsMarket;
-  wsKey: WsKey;
-  streamName: string;
+export interface CoinMOpenInterest {
+  symbol: string;
+  pair: string;
+  openInterest: numberInString;
+  contractType: FuturesContractType;
+  time: number;
 }
+export type SymbolOrPair =
+  | { pair: string; symbol?: never }
+  | { pair?: never; symbol: string };
 ⋮----
-export interface WsResponse {
-  type: 'message';
-  data: {
-    result: boolean | string[] | null;
-    id: number;
-    isWSAPIResponse: boolean;
-    wsKey: WsKey;
-  };
+export interface CoinMSymbolOrderBookTicker {
+  symbol: string;
+  pair: string;
+  bidPrice: numberInString;
+  bidQty: numberInString;
+  askPrice: numberInString;
+  askQty: numberInString;
+  time: number;
 }
 ⋮----
-// Same as inverse futures
-export type WsPublicInverseTopic =
-  | 'orderBookL2_25'
-  | 'orderBookL2_200'
-  | 'trade'
-  | 'insurance'
-  | 'instrument_info'
-  | 'klineV2';
+export interface CoinMPaginatedRequest {
+  fromId?: number;
+  startTime?: number;
+  endTime?: number;
+  limit?: number;
+}
 ⋮----
-export type WsPublicUSDTPerpTopic =
-  | 'orderBookL2_25'
-  | 'orderBookL2_200'
-  | 'trade'
-  | 'insurance'
-  | 'instrument_info'
-  | 'kline';
+export interface CoinMAccountTradeParamsWithPair extends CoinMPaginatedRequest {
+  pair: string;
+  symbol?: never;
+  fromId?: never;
+}
 ⋮----
-export type WsPublicSpotV1Topic =
-  | 'trade'
-  | 'realtimes'
-  | 'kline'
-  | 'depth'
-  | 'mergedDepth'
-  | 'diffDepth';
+export interface CoinMAccountTradeParamsWithSymbol
+  extends CoinMPaginatedRequest {
+  symbol: string;
+  pair?: never;
+}
 ⋮----
-export type WsPublicSpotV2Topic =
-  | 'depth'
-  | 'kline'
-  | 'trade'
-  | 'bookTicker'
-  | 'realtimes';
+export interface CoinMAccountTradeParamsWithFromId
+  extends CoinMPaginatedRequest {
+  fromId: number;
+  startTime?: never;
+  endTime?: never;
+}
 ⋮----
-export type WsPublicTopics =
-  | WsPublicInverseTopic
-  | WsPublicUSDTPerpTopic
-  | WsPublicSpotV1Topic
-  | WsPublicSpotV2Topic
-  | string;
+export type CoinMAccountTradeParams =
+  | CoinMAccountTradeParamsWithSymbol
+  | CoinMAccountTradeParamsWithPair
+  | CoinMAccountTradeParamsWithFromId;
 ⋮----
-// Same as inverse futures
-export type WsPrivateInverseTopic =
-  | 'position'
-  | 'execution'
-  | 'order'
-  | 'stop_order';
+export interface CoinMPositionTrade {
+  symbol: string;
+  id: number;
+  orderId: number;
+  pair: string;
+  side: OrderSide;
+  price: numberInString;
+  qty: numberInString;
+  realizedPnl: numberInString;
+  marginAsset: string;
+  baseQty: numberInString;
+  commission: numberInString;
+  commissionAsset: string;
+  time: number;
+  positionSide: PositionSide;
+  buyer: boolean;
+  maker: boolean;
+}
 ⋮----
-export type WsPrivateUSDTPerpTopic =
-  | 'position'
-  | 'execution'
-  | 'order'
-  | 'stop_order'
-  | 'wallet';
+export interface FundingRate {
+  symbol: string;
+  adjustedFundingRateCap: string;
+  adjustedFundingRateFloor: string;
+  fundingIntervalHours: number;
+  disclaimer: boolean;
+}
 ⋮----
-export type WsPrivateSpotTopic =
-  | 'outboundAccountInfo'
-  | 'executionReport'
-  | 'ticketInfo';
+export interface GetClassicPortfolioMarginNotionalLimitParams {
+  symbol?: string;
+  pair?: string;
+}
 ⋮----
-export type WsPrivateTopic =
-  | WsPrivateInverseTopic
-  | WsPrivateUSDTPerpTopic
-  | WsPrivateSpotTopic
-  | string;
+export interface ClassicPortfolioMarginNotionalLimit {
+  symbol: string;
+  pair: string;
+  notionalLimit: string;
+}
 ⋮----
-export type WsTopic = WsPublicTopics | WsPrivateTopic;
-⋮----
-export interface WSClientConfigurableOptions {
-  /** Your API key */
-  api_key?: string;
-
-  /** Your API secret */
-  api_secret?: string;
-
-  beautify?: boolean;
-
-  /**
-   * If true, log a warning if the beautifier is missing anything for an event
-   */
-  beautifyWarnIfMissing?: boolean;
-
-  /**
-   * Set to `true` to connect to Binance's testnet environment.
-   *
-   * Notes:
-   * - Not all WebSocket categories support testnet.
-   * - If testing a strategy, this is not recommended. Testnet market data is very different from real market conditions. More guidance here: https://github.com/tiagosiebler/awesome-crypto-examples/wiki/CEX-Testnets
-   */
-  testnet?: boolean;
-
-  /** Define a recv window when preparing a private websocket signature. This is in milliseconds, so 5000 == 5 seconds */
-  recvWindow?: number;
-
-  // Disable ping/pong ws heartbeat mechanism (not recommended)
-  disableHeartbeat?: boolean;
-
-  /** How often to check if the connection is alive */
-  pingInterval?: number;
-
-  /** How long to wait for a pong (heartbeat reply) before assuming the connection is dead */
-  pongTimeout?: number;
-
-  /** Delay in milliseconds before respawning the connection */
-  reconnectTimeout?: number;
-
-  restOptions?: RestClientOptions;
-
-  requestOptions?: AxiosRequestConfig;
-
-  wsOptions?: {
-    protocols?: string[];
-    agent?: any;
-  };
-
-  wsUrl?: string;
-
-  /**
-   * Allows you to provide a custom "signMessage" function, e.g. to use node's much faster createHmac method
-   *
-   * Look in the examples folder for a demonstration on using node's createHmac instead.
-   */
-  customSignMessageFn?: (message: string, secret: string) => Promise<string>;
-}
-⋮----
-/** Your API key */
-⋮----
-/** Your API secret */
-⋮----
-/**
-   * If true, log a warning if the beautifier is missing anything for an event
-   */
-⋮----
-/**
-   * Set to `true` to connect to Binance's testnet environment.
-   *
-   * Notes:
-   * - Not all WebSocket categories support testnet.
-   * - If testing a strategy, this is not recommended. Testnet market data is very different from real market conditions. More guidance here: https://github.com/tiagosiebler/awesome-crypto-examples/wiki/CEX-Testnets
-   */
-⋮----
-/** Define a recv window when preparing a private websocket signature. This is in milliseconds, so 5000 == 5 seconds */
-⋮----
-// Disable ping/pong ws heartbeat mechanism (not recommended)
-⋮----
-/** How often to check if the connection is alive */
-⋮----
-/** How long to wait for a pong (heartbeat reply) before assuming the connection is dead */
-⋮----
-/** Delay in milliseconds before respawning the connection */
-⋮----
-/**
-   * Allows you to provide a custom "signMessage" function, e.g. to use node's much faster createHmac method
-   *
-   * Look in the examples folder for a demonstration on using node's createHmac instead.
-   */
-⋮----
-/**
- * WS configuration that's always defined, regardless of user configuration
- * (usually comes from defaults if there's no user-provided values)
- */
-export interface WebsocketClientOptions extends WSClientConfigurableOptions {
-  pongTimeout: number;
-  pingInterval: number;
-  reconnectTimeout: number;
-  recvWindow: number;
-  authPrivateConnectionsOnConnect: boolean;
-  authPrivateRequests: boolean;
-}
-
-================
-File: src/types/coin.ts
-================
-import { FuturesContractType, PositionSide } from './futures';
-import { numberInString, OrderSide } from './shared';
-⋮----
-export interface PositionRisk {
-  symbol: string;
-  positionAmt: numberInString;
-  entryPrice: numberInString;
-  markPrice: numberInString;
-  unRealizedProfit: numberInString;
-  liquidationPrice: numberInString;
-  leverage: numberInString;
-  maxQty: numberInString;
-  marginType: string;
-  isolatedMargin: numberInString;
-  isAutoAddMargin: boolean;
-  positionSide: PositionSide;
-  updateTime: number;
-}
-⋮----
-export interface CoinMOpenInterest {
-  symbol: string;
-  pair: string;
-  openInterest: numberInString;
-  contractType: FuturesContractType;
-  time: number;
-}
-export type SymbolOrPair =
-  | { pair: string; symbol?: never }
-  | { pair?: never; symbol: string };
-⋮----
-export interface CoinMSymbolOrderBookTicker {
-  symbol: string;
-  pair: string;
-  bidPrice: numberInString;
-  bidQty: numberInString;
-  askPrice: numberInString;
-  askQty: numberInString;
-  time: number;
-}
-⋮----
-export interface CoinMPaginatedRequest {
-  fromId?: number;
-  startTime?: number;
-  endTime?: number;
-  limit?: number;
-}
-⋮----
-export interface CoinMAccountTradeParamsWithPair extends CoinMPaginatedRequest {
-  pair: string;
-  symbol?: never;
-  fromId?: never;
-}
-⋮----
-export interface CoinMAccountTradeParamsWithSymbol
-  extends CoinMPaginatedRequest {
-  symbol: string;
-  pair?: never;
-}
-⋮----
-export interface CoinMAccountTradeParamsWithFromId
-  extends CoinMPaginatedRequest {
-  fromId: number;
-  startTime?: never;
-  endTime?: never;
-}
-⋮----
-export type CoinMAccountTradeParams =
-  | CoinMAccountTradeParamsWithSymbol
-  | CoinMAccountTradeParamsWithPair
-  | CoinMAccountTradeParamsWithFromId;
-⋮----
-export interface CoinMPositionTrade {
-  symbol: string;
-  id: number;
-  orderId: number;
-  pair: string;
-  side: OrderSide;
-  price: numberInString;
-  qty: numberInString;
-  realizedPnl: numberInString;
-  marginAsset: string;
-  baseQty: numberInString;
-  commission: numberInString;
-  commissionAsset: string;
-  time: number;
-  positionSide: PositionSide;
-  buyer: boolean;
-  maker: boolean;
-}
-⋮----
-export interface FundingRate {
-  symbol: string;
-  adjustedFundingRateCap: string;
-  adjustedFundingRateFloor: string;
-  fundingIntervalHours: number;
-  disclaimer: boolean;
-}
-⋮----
-export interface GetClassicPortfolioMarginNotionalLimitParams {
-  symbol?: string;
-  pair?: string;
-}
-⋮----
-export interface ClassicPortfolioMarginNotionalLimit {
-  symbol: string;
-  pair: string;
-  notionalLimit: string;
-}
-⋮----
-export interface ClassicPortfolioMarginAccount {
-  maxWithdrawAmountUSD: string;
-  asset: string;
-  maxWithdrawAmount: string;
-}
+export interface ClassicPortfolioMarginAccount {
+  maxWithdrawAmountUSD: string;
+  asset: string;
+  maxWithdrawAmount: string;
+}
 ⋮----
 export interface FuturesTransactionHistoryDownloadLink {
   downloadId: string;
@@ -5706,443 +5548,248 @@ import { DefaultLogger, WebsocketClient } from '../../src/index';
 // arrays also supported:
 
 ================
-File: examples/WebSockets/ws-public.ts
+File: examples/WebSockets/ws-userdata-README.MD
 ================
-/* eslint-disable @typescript-eslint/no-unused-vars */
-import { DefaultLogger, WebsocketClient } from '../../src';
-⋮----
-// or, with the npm package
-/*
-import {
-  WebsocketClient,
-  DefaultLogger,
-  isWsFormatted24hrTicker,
-  isWsFormattedKline,
-} from 'binance';
-*/
-⋮----
-// Without typescript:
-// const logger = {
-⋮----
-/* trace: (...params) => {
-      // A simple way to suppress heartbeats but receive all other traces
-      // if (params[0].includes('ping') || params[0].includes('pong')) {
-      //   return;
-      // }
-      console.log('\n', new Date(), 'trace ', ...params);
-    } ,*/
-⋮----
-// Optional: when enabled, the SDK will try to format incoming data into more readable objects.
-// Beautified data is emitted via the "formattedMessage" event
-⋮----
-logger, // Optional: customise logging behaviour by extending or overwriting the default logger implementation
-⋮----
-// Raw unprocessed incoming data, e.g. if you have the beautifier disabled
-⋮----
-// console.log('raw message received ', JSON.stringify(data, null, 2));
-// console.log('raw message received ', JSON.stringify(data));
-//console.log('log rawMessage: ', data);
-⋮----
-// Formatted data that has gone through the beautifier
-⋮----
-//console.log('log formattedMessage: ', data);
-/**
-     * Optional: we've included type-guards for many formatted websocket topics.
-     *
-     * These can be used within `if` blocks to narrow down specific event types (even for non-typescript users).
-     */
-// if (isWsAggTradeFormatted(data)) {
-//   console.log('log agg trade: ', data);
-//   return;
-// }
-// // For one symbol
-// if (isWsFormattedMarkPriceUpdateEvent(data)) {
-//   console.log('log mark price: ', data);
-//   return;
-// }
-// // for many symbols
-// if (isWsFormattedMarkPriceUpdateArray(data)) {
-//   console.log('log mark prices: ', data);
-//   return;
-// }
-// if (isWsFormattedKline(data)) {
-//   console.log('log kline: ', data);
-//   return;
-// }
-// if (isWsFormattedTrade(data)) {
-//   return console.log('log trade: ', data);
-// }
-// if (isWsFormattedForceOrder(data)) {
-//   return console.log('log force order: ', data);
-// }
-// if (isWsFormatted24hrTickerArray(data)) {
-//   return console.log('log 24hr ticker array: ', data);
-// }
-// if (isWsFormattedRollingWindowTickerArray(data)) {
-//   return console.log('log rolling window ticker array: ', data);
-// }
-// if (isWsFormatted24hrTicker(data)) {
-//   return console.log('log 24hr ticker: ', data);
-// }
-// if (isWsPartialBookDepthEventFormatted(data)) {
-//   return console.log('log partial book depth event: ', data);
-// }
-⋮----
-//console.log('log formattedUserDataMessage: ', data);
-⋮----
-// response to command sent via WS stream (e.g LIST_SUBSCRIPTIONS)
+# User Data Streams - Binance
+
+The user data streams are the WebSocket method for asynchronously receiving events when any changes happen on your account. Including but not limited to:
+- order events (filled/cancelled/updated/etc)
+- position events
+- balance events (deposit/withdraw/etc)
+- misc events (leverage changed, position mode changed, etc)
+
+## Mechanisms
+
+There are currently two key mechanisms for subscribing to user data events
+
+### Mechanisms - Listen Key
+
+The older and original mechanism involves a listen key. This is requested via the REST API and then used when opening a connection to the user data stream.
+
+The listen key can expire and needs a regular "ping" (a REST API call) to keep it alive.
+
+With the "binance" Node.js & JavaScript SDK, you can easily subscribe to the user data stream via the listen key workflow, through just one function call.
+
+The SDK will automatically:
+- fetch a listen key
+- perform regular keep alive requests on the listen key
+- handle listen key expiry/refresh
+- handle reconnects, if a connection is temporarily lost
+
+All you have to do is ask for the user data stream and process incoming events - the SDK will handle the rest!
+
+For a working example, refer to the [ws-userdata-listenkey](./ws-userdata-listenkey.ts) example.
+
+**Deprecation warning: As of April 2025, the listen key workflow is also deprecated for Spot markets (no known ETA for removal).** Refer to the changelog for details: https://developers.binance.com/docs/binance-spot-api-docs/CHANGELOG#2025-04-07
+
+### Mechanisms - WS API User Data Stream
+
+The newer mechanism for the user data stream is via an active WebSocket API connection. This is a simpler mechanism in that it does not require a listen key. You can easily use this new mechanism via the WebsocketClient (or WebsocketAPIClient) within this SDK.
+
+For a working example, refer to the [ws-userdata-wsapi](./ws-userdata-wsapi.ts) example.
+
+================
+File: examples/WebSockets/ws-userdata-wsapi.ts
+================
+/* eslint-disable @typescript-eslint/no-unused-vars */
+// or
+// import { WebsocketAPIClient, WebsocketClient, WS_KEY_MAP } from 'binance';
+// or
+// const { WebsocketAPIClient, WebsocketClient, WS_KEY_MAP } = require('binance');
 ⋮----
-// No action needed here, unless you need to query the REST API after being reconnected.
+import {
+  isWsFormattedFuturesUserDataEvent,
+  isWsFormattedSpotBalanceUpdate,
+  isWsFormattedSpotOutboundAccountPosition,
+  isWsFormattedSpotUserDataEvent,
+  isWsFormattedUserDataEvent,
+  WebsocketAPIClient,
+  WebsocketClient,
+  WS_KEY_MAP,
+} from '../../src';
 ⋮----
 /**
-     * The Websocket Client will automatically manage connectivity and active topics/subscriptions for you.
-     *
-     * Simply call wsClient.subscribe(topic, wsKey) as many times as you want, with or without an array.
-     */
+ * The WS API only works with an Ed25519 API key.
+ *
+ * Check the rest-private-ed25519.md in this folder for more guidance
+ * on preparing this Ed25519 API key.
+ */
 ⋮----
-// // E.g. one at a time, routed to the coinm futures websockets:
-// wsClient.subscribe('btcusd@indexPrice', 'coinm');
-// wsClient.subscribe('btcusd@miniTicker', 'coinm');
+// returned by binance, generated using the publicKey (above)
+// const key = 'BVv39ATnIme5TTZRcC3I04C3FqLVM7vCw3Hf7mMT7uu61nEZK8xV1V5dmhf9kifm';
+// Your Ed25519 private key is passed as the "secret"
+// const secret = privateKey;
 ⋮----
-// // Or send many topics at once to a stream, e.g. the usdm futures stream:
-// wsClient.subscribe(
-//   [
-//     'btcusdt@aggTrade',
-//     'btcusdt@markPrice',
-//     '!ticker@arr',
-//     '!miniTicker@arr',
-//   ],
-//   'usdm',
-// );
+function attachEventHandlers<TWSClient extends WebsocketClient>(
+  wsClient: TWSClient,
+): void
 ⋮----
 /**
-     * Subscribe to each available type of spot market topic, the new way
-     */
-⋮----
-// Aggregate Trade Streams
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#aggregate-trade-streams
-⋮----
-// Trade Streams
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#trade-streams
+   * General event handlers for monitoring the WebsocketClient
+   */
 ⋮----
-// Kline/Candlestick Streams for UTC
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#klinecandlestick-streams-for-utc
+// Raw events received from binance, as is:
 ⋮----
-// Kline/Candlestick Streams with timezone offset
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#klinecandlestick-streams-with-timezone-offset
+// console.log('raw message received ', JSON.stringify(data));
 ⋮----
-// Individual Symbol Mini Ticker Stream
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#individual-symbol-mini-ticker-stream
+// Formatted events from the built-in beautifier, with fully readable property names and parsed floats:
 ⋮----
-// All Market Mini Tickers Stream
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#all-market-mini-tickers-stream
+// We've included type guards for many events, especially on the user data stream, to help easily
+// identify events using simple `if` checks.
+//
+// Use `if` checks to narrow down specific events from the user data stream
 ⋮----
-// Individual Symbol Ticker Streams
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#individual-symbol-ticker-streams
+//// More general handlers, if you prefer:
 ⋮----
-// All Market Tickers Stream
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#all-market-tickers-stream
+// Any user data event in spot:
 ⋮----
-// Individual Symbol Rolling Window Statistics Streams
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#individual-symbol-rolling-window-statistics-streams
+// Any user data event in futures:
 ⋮----
-// All Market Rolling Window Statistics Streams
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#all-market-rolling-window-statistics-streams
+// Any user data event on any market (spot + futures)
 ⋮----
-// Individual Symbol Book Ticker Streams
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#individual-symbol-book-ticker-streams
+// Formatted user data events also have a dedicated event handler, but that's optional and no different to the above
+// wsClient.on('formattedUserDataMessage', (data) => {
+//   if (isWsFormattedSpotOutboundAccountPosition(data)) {
+//     return;
+//     // console.log(
+//     //   'formattedUserDataMessage->isWsFormattedSpotOutboundAccountPosition: ',
+//     //   data,
+//     // );
+//   }
+//   if (isWsFormattedSpotBalanceUpdate(data)) {
+//     return console.log(
+//       'formattedUserDataMessage->isWsFormattedSpotBalanceUpdate: ',
+//       data,
+//     );
+//   }
+//   console.log('formattedUserDataMessage: ', data);
+// });
 ⋮----
-// Average Price
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#average-price
+// console.log('ws response: ', JSON.stringify(data));
 ⋮----
-// Partial Book Depth Streams
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#partial-book-depth-streams
+async function main()
 ⋮----
-// Diff. Depth Stream
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#diff-depth-stream
+// Enforce testnet ws connections, regardless of supplied wsKey:
 ⋮----
-// Look at the `WS_KEY_URL_MAP` for a list of values here:
-// https://github.com/tiagosiebler/binance/blob/master/src/util/websockets/websocket-util.ts
-// "main" connects to wss://stream.binance.com:9443/stream
-// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams
+// Note: unless you set this to false, the SDK will automatically call
+// the `subscribeUserDataStream()` method again if reconnected (if you called it before):
+// resubscribeUserDataStreamAfterReconnect: true,
 ⋮----
-// Aggregate Trade Stream
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Aggregate-Trade-Streams
+// If you want your own event handlers instead of the default ones with logs, disable this setting and see the `attachEventHandlers` example below:
 ⋮----
-// Mark Price Stream
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Mark-Price-Stream
+// Attach your own event handlers to process incoming events
+// You may want to disable the default ones to avoid unnecessary logs (via attachEventListeners:false, above)
 ⋮----
-// Mark Price Stream for All market
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Mark-Price-Stream-for-All-market
+// Optional, if you see RECV Window errors, you can use this to manage time issues.
+// ! However, make sure you sync your system clock first!
+// https://github.com/tiagosiebler/awesome-crypto-examples/wiki/Timestamp-for-this-request-is-outside-of-the-recvWindow
+// wsClient.setTimeOffsetMs(-5000);
 ⋮----
-// Kline/Candlestick Streams
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Kline-Candlestick-Streams
-// 'btcusdt@kline_1m',
-// Continuous Contract Kline/Candlestick Streams
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Continuous-Contract-Kline-Candlestick-Streams
-// 'btcusdt_perpetual@continuousKline_1m', // DOESNT EXIST AS TYPE GUARD, ONLY IN BEAUTIFIER
-// Individual Symbol Mini Ticker Stream
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Individual-Symbol-Mini-Ticker-Stream
-// 'btcusdt@miniTicker', // DOESNT EXIST AS TYPE GUARD, ONLY FOR RAW MESSAGE
-// All Market Mini Tickers Stream
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Market-Mini-Tickers-Stream
-// '!miniTicker@arr', // DOESNT EXIST AS TYPE GUARD
-// Individual Symbol Ticker Streams
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Individual-Symbol-Ticker-Streams
-//'btcusdt@ticker',
-// All Market Tickers Stream
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Market-Tickers-Stream
-// '!ticker@arr', // DOESNT EXIST AS TYPE GUARD
-// Individual Symbol Book Ticker Streams
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Individual-Symbol-Book-Ticker-Streams
-//'btcusdt@bookTicker', // DOESNT EXIST AS TYPE GUARD
-// All Book Tickers Stream
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Book-Tickers-Stream
-// '!bookTicker', // DOESNT EXIST AS TYPE GUARD
-// Liquidation Order Stream
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Liquidation-Order-Streams
-// 'btcusdt@forceOrder',
-// Liquidation Order Stream for All market
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams
-//'!forceOrder@arr',
-// Partial Book Depth Streams
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Partial-Book-Depth-Streams
-//'btcusdt@depth5',
-// 'btcusdt@depth10@100ms'
-// Diff. Book Depth Stream
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Diff-Book-Depth-Streams
+// Note: unless you set resubscribeUserDataStreamAfterReconnect to false, the SDK will
+// automatically call this method again if reconnected,
 ⋮----
-// Composite Index Symbol Information Streams
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Composite-Index-Symbol-Information-Streams
-// 'btcusdt@compositeIndex' // DOESNT EXIST AS TYPE GUARD
-// Contract Info Stream
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Contract-Info-Stream
-// '!contractInfo' // DOESNT EXIST AS TYPE GUARD
-// Multi-Assets Mode Asset Index Stream
-// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Multi-Assets-Mode-Asset-Index
-// '!assetIndex@arr' // DOESNT EXIST AS TYPE GUARD
-// 'btcusdt@assetIndex'
+WS_KEY_MAP.mainWSAPI, // The `mainWSAPI` wsKey will connect to the "spot" Websocket API on Binance.
 ⋮----
-/**
-     * Subscribe to each available european options market data websocket topic, the new way:
-     *
-     * https://developers.binance.com/docs/derivatives/option/websocket-market-streams/New-Symbol-Info
-     *
-     * https://eapi.binance.com/eapi/v1/exchangeInfo
-     */
-⋮----
-// /**
-//  *
-//  * For those that used the Node.js Binance SDK before the v3 release, you can
-//  * still subscribe to available market topics the "old" way, for convenience
-//  * when migrating from the old WebsocketClient to the new multiplex client):
-//  *
-//  */
-⋮----
-// wsClient.subscribeAggregateTrades(symbol, 'usdm');
-// wsClient.subscribeTrades(symbol, 'spot');
-// wsClient.subscribeTrades(symbol, 'usdm');
-// wsClient.subscribeTrades(coinMSymbol, 'coinm');
-// wsClient.subscribeCoinIndexPrice(coinMSymbol2);
-// wsClient.subscribeAllBookTickers('usdm');
-// wsClient.subscribeSpotKline(symbol, '1m');
-// wsClient.subscribeMarkPrice(symbol, 'usdm');
-// wsClient.subscribeMarkPrice(coinMSymbol, 'coinm');
-// wsClient.subscribeAllMarketMarkPrice('usdm');
-// wsClient.subscribeAllMarketMarkPrice('coinm');
-// wsClient.subscribeKlines(symbol, '1m', 'usdm');
-// wsClient.subscribeContinuousContractKlines(
-//   symbol,
-//   'perpetual',
-//   '1m',
-//   'usdm',
-// );
-// wsClient.subscribeIndexKlines(coinMSymbol2, '1m');
-// wsClient.subscribeMarkPriceKlines(coinMSymbol, '1m');
-// wsClient.subscribeSymbolMini24hrTicker(symbol, 'spot'); // 0116 265 5309, opt 1
-// wsClient.subscribeSymbolMini24hrTicker(symbol, 'usdm');
-// wsClient.subscribeSymbolMini24hrTicker(coinMSymbol, 'coinm');
-// wsClient.subscribeSymbol24hrTicker(symbol, 'spot');
-// wsClient.subscribeSymbol24hrTicker(symbol, 'usdm');
-// wsClient.subscribeSymbol24hrTicker(coinMSymbol, 'coinm');
-// wsClient.subscribeAllMini24hrTickers('spot');
-// wsClient.subscribeAllMini24hrTickers('usdm');
-// wsClient.subscribeAllMini24hrTickers('coinm');
-// wsClient.subscribeAll24hrTickers('spot');
-// wsClient.subscribeAll24hrTickers('usdm');
-// wsClient.subscribeAll24hrTickers('coinm');
-// wsClient.subscribeSymbolLiquidationOrders(symbol, 'usdm');
-// wsClient.subscribeAllLiquidationOrders('usdm');
-// wsClient.subscribeAllLiquidationOrders('coinm');
-// wsClient.subscribeSpotSymbol24hrTicker(symbol);
-// wsClient.subscribeSpotPartialBookDepth('ETHBTC', 5, 1000);
-// wsClient.subscribeAllRollingWindowTickers('spot', '1d');
-// wsClient.subscribeSymbolBookTicker(symbol, 'spot');
-// wsClient.subscribePartialBookDepths(symbol, 5, 100, 'spot');
-// wsClient.subscribeDiffBookDepth(symbol, 100, 'spot');
-// wsClient.subscribeContractInfoStream('usdm');
-// wsClient.subscribeContractInfoStream('coinm');
+// Start executing the example workflow
 
 ================
-File: examples/WebSockets/ws-userdata-listenKey-testnet.ts
+File: examples/README.md
 ================
-import {
-  DefaultLogger,
-  isWsFormattedFuturesUserDataEvent,
-  isWsFormattedSpotUserDataEvent,
-  isWsFormattedSpotUserDataExecutionReport,
-  isWsFormattedUserDataEvent,
-  WebsocketClient,
-  WsUserDataEvents,
-} from '../../src/index';
-⋮----
-// or
-// import { DefaultLogger, WebsocketClient } from 'binance';
-⋮----
-// console.log('using api credentials: ', { key, secret });
-⋮----
-// Optional, hook and customise logging behavior
-⋮----
-// If you prefer, you can receive raw unprocessed data without the "beautifier":
-// wsClient.on('message', (data) => {
-//   console.log('raw message received ', JSON.stringify(data, null, 2));
-// });
-⋮----
-function onUserDataEvent(data: WsUserDataEvents)
-⋮----
-// the market denotes which API category it came from
-// if (data.wsMarket.includes('spot')) {
-⋮----
-// or use a type guard, if one exists (PRs welcome)
-⋮----
-// Beautified/formatted events from binance:
-⋮----
-// The wsKey can be parsed to determine the type of message (what websocket it came from)
-// if (!Array.isArray(data) && data.wsKey.includes('userData')) {
-//   return onUserDataEvent(data);
-// }
-⋮----
-// or use a type guard if available
-⋮----
-// response to command sent via WS stream (e.g LIST_SUBSCRIPTIONS)
-⋮----
-// This is a good place to check your own state is still in sync with the account state on the exchange, in case any events were missed while the library was reconnecting:
-// - fetch balances
-// - fetch positions
-// - fetch orders
-⋮----
-// wsClient.subscribeMarginUserDataStream();
-// wsClient.subscribeIsolatedMarginUserDataStream('BTCUSDT');
-// wsClient.subscribeUsdFuturesUserDataStream();
-⋮----
-// setTimeout(() => {
-//   console.log('killing all connections');
-//   wsClient.closeAll();
-// }, 1000 * 15);
+# Binance API - Examples
 
-================
-File: examples/WebSockets/ws-userdata-wsapi.ts
-================
-/* eslint-disable @typescript-eslint/no-unused-vars */
-// or
-// import { WebsocketAPIClient, WebsocketClient, WS_KEY_MAP } from 'binance';
-// or
-// const { WebsocketAPIClient, WebsocketClient, WS_KEY_MAP } = require('binance');
-⋮----
-import {
-  isWsFormattedFuturesUserDataEvent,
-  isWsFormattedSpotBalanceUpdate,
-  isWsFormattedSpotOutboundAccountPosition,
-  isWsFormattedSpotUserDataEvent,
-  isWsFormattedUserDataEvent,
-  WebsocketAPIClient,
-  WebsocketClient,
-  WS_KEY_MAP,
-} from '../../src';
-⋮----
-/**
- * The WS API only works with an Ed25519 API key.
- *
- * Check the rest-private-ed25519.md in this folder for more guidance
- * on preparing this Ed25519 API key.
- */
-⋮----
-// returned by binance, generated using the publicKey (above)
-// const key = 'BVv39ATnIme5TTZRcC3I04C3FqLVM7vCw3Hf7mMT7uu61nEZK8xV1V5dmhf9kifm';
-// Your Ed25519 private key is passed as the "secret"
-// const secret = privateKey;
-⋮----
-function attachEventHandlers<TWSClient extends WebsocketClient>(
-  wsClient: TWSClient,
-): void
-⋮----
-/**
-   * General event handlers for monitoring the WebsocketClient
-   */
-⋮----
-// Raw events received from binance, as is:
-⋮----
-// console.log('raw message received ', JSON.stringify(data));
-⋮----
-// Formatted events from the built-in beautifier, with fully readable property names and parsed floats:
-⋮----
-// We've included type guards for many events, especially on the user data stream, to help easily
-// identify events using simple `if` checks.
-//
-// Use `if` checks to narrow down specific events from the user data stream
-⋮----
-//// More general handlers, if you prefer:
-⋮----
-// Any user data event in spot:
-⋮----
-// Any user data event in futures:
-⋮----
-// Any user data event on any market (spot + futures)
-⋮----
-// Formatted user data events also have a dedicated event handler, but that's optional and no different to the above
-// wsClient.on('formattedUserDataMessage', (data) => {
-//   if (isWsFormattedSpotOutboundAccountPosition(data)) {
-//     return;
-//     // console.log(
-//     //   'formattedUserDataMessage->isWsFormattedSpotOutboundAccountPosition: ',
-//     //   data,
-//     // );
-//   }
-//   if (isWsFormattedSpotBalanceUpdate(data)) {
-//     return console.log(
-//       'formattedUserDataMessage->isWsFormattedSpotBalanceUpdate: ',
-//       data,
-//     );
-//   }
-//   console.log('formattedUserDataMessage: ', data);
-// });
-⋮----
-// console.log('ws response: ', JSON.stringify(data));
-⋮----
-async function main()
-⋮----
-// Enforce testnet ws connections, regardless of supplied wsKey:
-⋮----
-// Note: unless you set this to false, the SDK will automatically call
-// the `subscribeUserDataStream()` method again if reconnected (if you called it before):
-// resubscribeUserDataStreamAfterReconnect: true,
-⋮----
-// If you want your own event handlers instead of the default ones with logs, disable this setting and see the `attachEventHandlers` example below:
-⋮----
-// Attach your own event handlers to process incoming events
-// You may want to disable the default ones to avoid unnecessary logs (via attachEventListeners:false, above)
-⋮----
-// Optional, if you see RECV Window errors, you can use this to manage time issues.
-// ! However, make sure you sync your system clock first!
-// https://github.com/tiagosiebler/awesome-crypto-examples/wiki/Timestamp-for-this-request-is-outside-of-the-recvWindow
-// wsClient.setTimeOffsetMs(-5000);
-⋮----
-// Note: unless you set resubscribeUserDataStreamAfterReconnect to false, the SDK will
-// automatically call this method again if reconnected,
-⋮----
-WS_KEY_MAP.mainWSAPI, // The `mainWSAPI` wsKey will connect to the "spot" Websocket API on Binance.
-⋮----
-// Start executing the example workflow
+This folder contains ready to go examples demonstrating various aspects of this API implementation, written in TypeScript (but they are compatible with pure JavaScript projects).
+
+Found something difficult to implement? Contribute to these examples and help others!
+
+## Getting started
+
+- Clone the project (or download it as a zip, or install the module in your own project `npm install binance`).
+- Edit the sample as needed (some samples require edits, e.g API keys or import statements to import from npm, not src).
+- Execute the sample using tsx: `tsx examples/REST/rest-spot-public.ts`.
+
+Samples that refer to API credentials using `process.env.API_KEY_COM` can be spawned with environment variables. Unix/macOS example:
+```
+APIKEY='apikeypastedhere' APISECRET='apisecretpastedhere' tsx examples/WebSockets/ws-userdata-listenkey.ts
+```
+
+Or edit the example directly to hardcode your API keys.
+
+### WebSockets
+
+All examples relating to WebSockets can be found in the [examples/WebSockets](./WebSockets/) folder. High level summary of available examples:
+
+#### Consumers
+
+These are purely for receiving data from Binance's WebSockets (market data, account updates, etc).
+
+##### Market Data
+
+These examples demonstrate subscribing to & receiving market data from Binance's WebSockets:
+
+- ws-public.ts
+  - Demonstration on general usage of the WebSocket client to subscribe to / unsubscribe from one or more market data topics.
+- ws-public-spot-orderbook.ts
+  - Subscribing to orderbook events for multiple symbols in spot markets.
+-	ws-public-spot-trades.ts
+  - Subscribing to raw trades for multiple symbols in spot markets.
+- ws-unsubscribe.ts
+  - Subscribing to a list of topics, and then unsubscribing from a few topics in that list.
+- ws-public-usdm-funding.ts
+  - Simple example subscribing to a general topic, and how to process incoming events to only extract funding rates from those events.
+
+##### Account Data
+
+These examples demonstrate receiving account update events from Binance's WebSockets:
+
+-	ws-userdata-listenkey.ts
+  - Demonstration on subscribing to various user data streams (spot, margin, futures),
+  - Handling incoming user data events
+  - Using provided type guards to determine which product group the user data event is for (spot, margin, futures, etc).
+- ws-userdata-listenKey-testnet.ts
+  - Similar to above, but on testnet.
+- ws-userdata-connection-safety.ts
+  - Demonstration on extra safety around the first user data stream connection.
+  - Note: this is overkill in most situations...
+
+##### WebSocket API
+
+These examples demonstrate how to send commands using Binance's WebSocket API (e.g. submitting orders). Very similar to the REST API, but using a persisted WebSocket connection instead of HTTP requests.
+
+- ws-api-client.ts
+  - Demonstration of using Binance's WebSocket API in Node.js/JavaScript/TypeScript, using the WebsocketAPIClient.
+  - This WebsocketAPIClient is very similar to a REST client, with one method per available command (endpoint) and fully typed requests & responses.
+  - Routing is automatically handled via the WebsocketClient, including authentication and connection persistence. Just call the functions you need - the SDK does the rest.
+  - From a usage perspective, it feels like a REST API - you can await responses just like a HTTP request.
+- ws-api-raw-promises.ts
+  - More verbose usage of the WebSocket API using the `sendWSAPIRequest()` method.
+  - The `WebsocketAPIClient` uses this method too, so in most cases it is simple to just use the `WebsocketAPIClient` instead.
+- ws-userdata-wsapi.ts
+  - The listenKey workflow for the user data stream is deprecated (in spot markets).
+  - This example demonstrates how to subscribe to the user data stream in spot markets, without a listen key, using the WebSocket API.
+
+##### Misc Workflows
+
+These are miscellaneous examples that cover one or more of the above categories:
+
+- ws-close.ts
+  - Closing the (old listen-key driven) user data stream.
+  - Unsubscribing from various topics.
+- ws-proxy-socks.ts
+  - Using WebSockets over a SOCKS proxy.
+- deprecated-ws-public.ts
+
+
+### REST APIs
+
+All examples relating to REST APIs can be found in the [examples/REST](./REST/) folder. Most examples are named around functionality & product group. Any examples with "private" involve API calls relating to your account (such as changing settings or submitting orders, etc),
+
+High level summary for some of the available examples, but check the folder for a complete list:
+
+#### REST USDM Examples
+
+- `rest-future-bracket-order.ts` Creates three order, entry, TP, SL and submit them all at once using `submitMultipleOrders`
+- `rest-usdm-order.ts` Creates single entry, using `submitNewOrder`
+- `rest-usdm-order-sl.ts` Modify current Stop Loss order(HedgeMode only)
 
 ================
 File: src/types/websockets/ws-api-responses.ts
@@ -7840,225 +7487,455 @@ export interface WsMessageFuturesUserDataOrderTradeUpdateEventRaw
   };
 }
 ⋮----
-pP: boolean; // ignore
-si: numberInString; // ignore
-ss: numberInString; // ignore
+pP: boolean; // ignore
+si: numberInString; // ignore
+ss: numberInString; // ignore
+⋮----
+export interface WsMessageFuturesUserDataTradeLiteEventRaw
+  extends WsSharedBase {
+  e: 'TRADE_LITE'; // Event Type
+  E: number; // Event Time
+  T: number; // Transaction Time
+  s: string; // Symbol
+  q: string; // Original Quantity
+  p: string; // Original Price
+  m: boolean; // Is this trade the maker side?
+  c: string; // Client Order Id
+  S: 'BUY' | 'SELL'; // Side
+  L: string; // Last Filled Price
+  l: string; // Order Last Filled Quantity
+  t: number; // Trade Id
+  i: number; // Order Id
+}
+⋮----
+e: 'TRADE_LITE'; // Event Type
+E: number; // Event Time
+T: number; // Transaction Time
+s: string; // Symbol
+q: string; // Original Quantity
+p: string; // Original Price
+m: boolean; // Is this trade the maker side?
+c: string; // Client Order Id
+S: 'BUY' | 'SELL'; // Side
+L: string; // Last Filled Price
+l: string; // Order Last Filled Quantity
+t: number; // Trade Id
+i: number; // Order Id
+⋮----
+export interface WsMessageFuturesUserDataAccountConfigUpdateEventRaw
+  extends WsSharedBase {
+  e: 'ACCOUNT_CONFIG_UPDATE';
+  E: number;
+  T: number;
+  ac?: {
+    s: string;
+    l: number;
+  };
+  ai?: {
+    j: boolean;
+  };
+}
+⋮----
+export interface WsMessageIndexPriceUpdateEventRaw extends WsSharedBase {
+  e: 'indexPriceUpdate';
+  E: number;
+  i: string;
+  p: numberInString;
+}
+⋮----
+export interface WsMessageMarkPriceUpdateEventRaw extends WsSharedBase {
+  e: 'markPriceUpdate';
+  E: number;
+  s: string;
+  p: string;
+  P: string;
+  i: string;
+  r: string;
+  T: number;
+}
+⋮----
+export interface WsMessageForceOrderRaw extends WsSharedBase {
+  e: 'forceOrder';
+  E: number;
+  o: {
+    s: string;
+    S: string;
+    o: string;
+    f: string;
+    q: string;
+    p: string;
+    ap: string;
+    X: string;
+    l: string;
+    z: string;
+    T: number;
+  };
+}
+⋮----
+export interface WsMessageFuturesUserDataStrategyUpdateRaw
+  extends WsSharedBase {
+  e: 'STRATEGY_UPDATE'; // Event Type
+  T: number; // Transaction Time
+  E: number; // Event Time
+  su: {
+    si: number; // Strategy ID
+    st: string; // Strategy Type
+    ss: string; // Strategy Status
+    s: string; // Symbol
+    ut: number; // Update Time
+    c: number; // opCode
+  };
+}
+⋮----
+e: 'STRATEGY_UPDATE'; // Event Type
+T: number; // Transaction Time
+E: number; // Event Time
+⋮----
+si: number; // Strategy ID
+st: string; // Strategy Type
+ss: string; // Strategy Status
+s: string; // Symbol
+ut: number; // Update Time
+c: number; // opCode
+⋮----
+export interface WsMessageFuturesUserDataGridUpdateRaw extends WsSharedBase {
+  e: 'GRID_UPDATE'; // Event Type
+  T: number; // Transaction Time
+  E: number; // Event Time
+  gu: {
+    si: number; // Strategy ID
+    st: string; // Strategy Type
+    ss: string; // Strategy Status
+    s: string; // Symbol
+    r: numberInString; // Realized PNL
+    up: numberInString; // Unmatched Average Price
+    uq: numberInString; // Unmatched Qty
+    uf: numberInString; // Unmatched Fee
+    mp: numberInString; // Matched PNL
+    ut: number; // Update Time
+  };
+}
+⋮----
+e: 'GRID_UPDATE'; // Event Type
+T: number; // Transaction Time
+E: number; // Event Time
+⋮----
+si: number; // Strategy ID
+st: string; // Strategy Type
+ss: string; // Strategy Status
+s: string; // Symbol
+r: numberInString; // Realized PNL
+up: numberInString; // Unmatched Average Price
+uq: numberInString; // Unmatched Qty
+uf: numberInString; // Unmatched Fee
+mp: numberInString; // Matched PNL
+ut: number; // Update Time
+⋮----
+export interface WsMessageFuturesUserDataContractInfoRaw extends WsSharedBase {
+  e: 'contractInfo'; // Event Type
+  E: number; // Event Time
+  s: string; // Symbol
+  ps: string; // Pair
+  ct: string; // Contract type
+  dt: number; // Delivery date time
+  ot: number; // onboard date time
+  cs: string; // Contract status
+  bks: {
+    bs: number; // Notional bracket
+    bnf: number; // Floor notional of this bracket
+    bnc: number; // Cap notional of this bracket
+    mmr: number; // Maintenance ratio for this bracket
+    cf: number; // Auxiliary number for quick calculation
+    mi: number; // Min leverage for this bracket
+    ma: number; // Max leverage for this bracket
+  }[];
+}
+⋮----
+e: 'contractInfo'; // Event Type
+E: number; // Event Time
+s: string; // Symbol
+ps: string; // Pair
+ct: string; // Contract type
+dt: number; // Delivery date time
+ot: number; // onboard date time
+cs: string; // Contract status
+⋮----
+bs: number; // Notional bracket
+bnf: number; // Floor notional of this bracket
+bnc: number; // Cap notional of this bracket
+mmr: number; // Maintenance ratio for this bracket
+cf: number; // Auxiliary number for quick calculation
+mi: number; // Min leverage for this bracket
+ma: number; // Max leverage for this bracket
+⋮----
+export type WsRawSpotUserDataEventRaw =
+  | WsMessageSpotUserDataExecutionReportEventRaw
+  | WsMessageSpotOutboundAccountPositionRaw
+  | WsMessageSpotBalanceUpdateRaw
+  | WsMessageSpotUserDataListStatusEventRaw;
+⋮----
+export type WsMessageFuturesUserDataEventRaw =
+  | WsMessageFuturesUserDataAccountUpdateRaw
+  | WsMessageFuturesUserDataListenKeyExpiredRaw
+  | WsMessageFuturesUserDataMarginCallRaw
+  | WsMessageFuturesUserDataOrderTradeUpdateEventRaw
+  | WsMessageFuturesUserDataAccountConfigUpdateEventRaw
+  | WsMessageFuturesUserDataCondOrderTriggerRejectEventRaw
+  | WsMessageFuturesUserDataTradeLiteEventRaw
+  | WsMessageFuturesUserDataStrategyUpdateRaw
+  | WsMessageFuturesUserDataGridUpdateRaw
+  | WsMessageFuturesUserDataContractInfoRaw;
+⋮----
+export type WsRawMessage =
+  | WsMessageKlineRaw
+  | WsMessageAggTradeRaw
+  | WsMessageTradeRaw
+  | WsMessage24hrMiniTickerRaw
+  | WsMessage24hrMiniTickerRaw[]
+  | WsMessage24hrTickerRaw
+  | WsMessage24hrTickerRaw[]
+  | WsMessageRollingWindowTickerRaw[]
+  | WsMessageBookTickerEventRaw
+  | WsMessagePartialBookDepthEventRaw
+  | WsMessageForceOrderRaw
+  | WsRawSpotUserDataEventRaw
+  | WsMessageIndexPriceUpdateEventRaw
+  | WsMessageFuturesUserDataAccountUpdateRaw
+  | WsMessageFuturesUserDataListenKeyExpiredRaw
+  | WsMessageFuturesUserDataMarginCallRaw
+  | WsMessageFuturesUserDataOrderTradeUpdateEventRaw
+  | WsMessageFuturesUserDataAccountConfigUpdateEventRaw
+  | WsMessageFuturesUserDataCondOrderTriggerRejectEventRaw;
+
+================
+File: src/types/websockets/ws-general.ts
+================
+import { AxiosRequestConfig } from 'axios';
+import WebSocket from 'isomorphic-ws';
+⋮----
+import { RestClientOptions } from '../../util/requestUtils';
+import { WsKey } from '../../util/websockets/websocket-util';
+⋮----
+export interface MessageEventLike {
+  target: WebSocket;
+  type: 'message';
+  data: string;
+}
+⋮----
+export function isMessageEvent(msg: unknown): msg is MessageEventLike
 ⋮----
-export interface WsMessageFuturesUserDataTradeLiteEventRaw
-  extends WsSharedBase {
-  e: 'TRADE_LITE'; // Event Type
-  E: number; // Event Time
-  T: number; // Transaction Time
-  s: string; // Symbol
-  q: string; // Original Quantity
-  p: string; // Original Price
-  m: boolean; // Is this trade the maker side?
-  c: string; // Client Order Id
-  S: 'BUY' | 'SELL'; // Side
-  L: string; // Last Filled Price
-  l: string; // Order Last Filled Quantity
-  t: number; // Trade Id
-  i: number; // Order Id
-}
+export type WsMarket =
+  | 'spot'
+  | 'spotTestnet'
+  | 'crossMargin'
+  | 'isolatedMargin'
+  | 'riskDataMargin'
+  | 'usdm'
+  | 'usdmTestnet'
+  | 'coinm'
+  | 'coinmTestnet'
+  | 'options'
+  | 'optionsTestnet'
+  | 'portfoliom';
 ⋮----
-e: 'TRADE_LITE'; // Event Type
-E: number; // Event Time
-T: number; // Transaction Time
-s: string; // Symbol
-q: string; // Original Quantity
-p: string; // Original Price
-m: boolean; // Is this trade the maker side?
-c: string; // Client Order Id
-S: 'BUY' | 'SELL'; // Side
-L: string; // Last Filled Price
-l: string; // Order Last Filled Quantity
-t: number; // Trade Id
-i: number; // Order Id
+export interface WsSharedBase {
+  wsMarket: WsMarket;
+  wsKey: WsKey;
+  streamName: string;
+}
 ⋮----
-export interface WsMessageFuturesUserDataAccountConfigUpdateEventRaw
-  extends WsSharedBase {
-  e: 'ACCOUNT_CONFIG_UPDATE';
-  E: number;
-  T: number;
-  ac?: {
-    s: string;
-    l: number;
-  };
-  ai?: {
-    j: boolean;
+export interface WsResponse {
+  type: 'message';
+  data: {
+    result: boolean | string[] | null;
+    id: number;
+    isWSAPIResponse: boolean;
+    wsKey: WsKey;
   };
 }
 ⋮----
-export interface WsMessageIndexPriceUpdateEventRaw extends WsSharedBase {
-  e: 'indexPriceUpdate';
-  E: number;
-  i: string;
-  p: numberInString;
-}
+// Same as inverse futures
+export type WsPublicInverseTopic =
+  | 'orderBookL2_25'
+  | 'orderBookL2_200'
+  | 'trade'
+  | 'insurance'
+  | 'instrument_info'
+  | 'klineV2';
 ⋮----
-export interface WsMessageMarkPriceUpdateEventRaw extends WsSharedBase {
-  e: 'markPriceUpdate';
-  E: number;
-  s: string;
-  p: string;
-  P: string;
-  i: string;
-  r: string;
-  T: number;
-}
+export type WsPublicUSDTPerpTopic =
+  | 'orderBookL2_25'
+  | 'orderBookL2_200'
+  | 'trade'
+  | 'insurance'
+  | 'instrument_info'
+  | 'kline';
 ⋮----
-export interface WsMessageForceOrderRaw extends WsSharedBase {
-  e: 'forceOrder';
-  E: number;
-  o: {
-    s: string;
-    S: string;
-    o: string;
-    f: string;
-    q: string;
-    p: string;
-    ap: string;
-    X: string;
-    l: string;
-    z: string;
-    T: number;
-  };
-}
+export type WsPublicSpotV1Topic =
+  | 'trade'
+  | 'realtimes'
+  | 'kline'
+  | 'depth'
+  | 'mergedDepth'
+  | 'diffDepth';
 ⋮----
-export interface WsMessageFuturesUserDataStrategyUpdateRaw
-  extends WsSharedBase {
-  e: 'STRATEGY_UPDATE'; // Event Type
-  T: number; // Transaction Time
-  E: number; // Event Time
-  su: {
-    si: number; // Strategy ID
-    st: string; // Strategy Type
-    ss: string; // Strategy Status
-    s: string; // Symbol
-    ut: number; // Update Time
-    c: number; // opCode
-  };
-}
+export type WsPublicSpotV2Topic =
+  | 'depth'
+  | 'kline'
+  | 'trade'
+  | 'bookTicker'
+  | 'realtimes';
 ⋮----
-e: 'STRATEGY_UPDATE'; // Event Type
-T: number; // Transaction Time
-E: number; // Event Time
+export type WsPublicTopics =
+  | WsPublicInverseTopic
+  | WsPublicUSDTPerpTopic
+  | WsPublicSpotV1Topic
+  | WsPublicSpotV2Topic
+  | string;
 ⋮----
-si: number; // Strategy ID
-st: string; // Strategy Type
-ss: string; // Strategy Status
-s: string; // Symbol
-ut: number; // Update Time
-c: number; // opCode
+// Same as inverse futures
+export type WsPrivateInverseTopic =
+  | 'position'
+  | 'execution'
+  | 'order'
+  | 'stop_order';
 ⋮----
-export interface WsMessageFuturesUserDataGridUpdateRaw extends WsSharedBase {
-  e: 'GRID_UPDATE'; // Event Type
-  T: number; // Transaction Time
-  E: number; // Event Time
-  gu: {
-    si: number; // Strategy ID
-    st: string; // Strategy Type
-    ss: string; // Strategy Status
-    s: string; // Symbol
-    r: numberInString; // Realized PNL
-    up: numberInString; // Unmatched Average Price
-    uq: numberInString; // Unmatched Qty
-    uf: numberInString; // Unmatched Fee
-    mp: numberInString; // Matched PNL
-    ut: number; // Update Time
+export type WsPrivateUSDTPerpTopic =
+  | 'position'
+  | 'execution'
+  | 'order'
+  | 'stop_order'
+  | 'wallet';
+⋮----
+export type WsPrivateSpotTopic =
+  | 'outboundAccountInfo'
+  | 'executionReport'
+  | 'ticketInfo';
+⋮----
+export type WsPrivateTopic =
+  | WsPrivateInverseTopic
+  | WsPrivateUSDTPerpTopic
+  | WsPrivateSpotTopic
+  | string;
+⋮----
+export type WsTopic = WsPublicTopics | WsPrivateTopic;
+⋮----
+export interface WSClientConfigurableOptions {
+  /** Your API key */
+  api_key?: string;
+
+  /** Your API secret */
+  api_secret?: string;
+
+  beautify?: boolean;
+
+  /**
+   * If true, log a warning if the beautifier is missing anything for an event
+   */
+  beautifyWarnIfMissing?: boolean;
+
+  /**
+   * Set to `true` to connect to Binance's testnet environment.
+   *
+   * Notes:
+   * - Not all WebSocket categories support testnet.
+   * - If testing a strategy, this is not recommended. Testnet market data is very different from real market conditions. More guidance here: https://github.com/tiagosiebler/awesome-crypto-examples/wiki/CEX-Testnets
+   */
+  testnet?: boolean;
+
+  /**
+   * Default: false. If true, use market maker endpoints when available.
+   * Eligible for high-frequency trading users who have enrolled and qualified
+   * in at least one of the Futures Liquidity Provider Programs.
+   * More info: https://www.binance.com/en/support/faq/detail/7df7f3838c3b49e692d175374c3a3283
+   */
+  useMMEndpoints?: boolean;
+
+  /** Define a recv window when preparing a private websocket signature. This is in milliseconds, so 5000 == 5 seconds */
+  recvWindow?: number;
+
+  // Disable ping/pong ws heartbeat mechanism (not recommended)
+  disableHeartbeat?: boolean;
+
+  /** How often to check if the connection is alive */
+  pingInterval?: number;
+
+  /** How long to wait for a pong (heartbeat reply) before assuming the connection is dead */
+  pongTimeout?: number;
+
+  /** Delay in milliseconds before respawning the connection */
+  reconnectTimeout?: number;
+
+  restOptions?: RestClientOptions;
+
+  requestOptions?: AxiosRequestConfig;
+
+  wsOptions?: {
+    protocols?: string[];
+    agent?: any;
   };
+
+  wsUrl?: string;
+
+  /**
+   * Allows you to provide a custom "signMessage" function, e.g. to use node's much faster createHmac method
+   *
+   * Look in the examples folder for a demonstration on using node's createHmac instead.
+   */
+  customSignMessageFn?: (message: string, secret: string) => Promise<string>;
 }
 ⋮----
-e: 'GRID_UPDATE'; // Event Type
-T: number; // Transaction Time
-E: number; // Event Time
+/** Your API key */
 ⋮----
-si: number; // Strategy ID
-st: string; // Strategy Type
-ss: string; // Strategy Status
-s: string; // Symbol
-r: numberInString; // Realized PNL
-up: numberInString; // Unmatched Average Price
-uq: numberInString; // Unmatched Qty
-uf: numberInString; // Unmatched Fee
-mp: numberInString; // Matched PNL
-ut: number; // Update Time
+/** Your API secret */
 ⋮----
-export interface WsMessageFuturesUserDataContractInfoRaw extends WsSharedBase {
-  e: 'contractInfo'; // Event Type
-  E: number; // Event Time
-  s: string; // Symbol
-  ps: string; // Pair
-  ct: string; // Contract type
-  dt: number; // Delivery date time
-  ot: number; // onboard date time
-  cs: string; // Contract status
-  bks: {
-    bs: number; // Notional bracket
-    bnf: number; // Floor notional of this bracket
-    bnc: number; // Cap notional of this bracket
-    mmr: number; // Maintenance ratio for this bracket
-    cf: number; // Auxiliary number for quick calculation
-    mi: number; // Min leverage for this bracket
-    ma: number; // Max leverage for this bracket
-  }[];
-}
+/**
+   * If true, log a warning if the beautifier is missing anything for an event
+   */
 ⋮----
-e: 'contractInfo'; // Event Type
-E: number; // Event Time
-s: string; // Symbol
-ps: string; // Pair
-ct: string; // Contract type
-dt: number; // Delivery date time
-ot: number; // onboard date time
-cs: string; // Contract status
+/**
+   * Set to `true` to connect to Binance's testnet environment.
+   *
+   * Notes:
+   * - Not all WebSocket categories support testnet.
+   * - If testing a strategy, this is not recommended. Testnet market data is very different from real market conditions. More guidance here: https://github.com/tiagosiebler/awesome-crypto-examples/wiki/CEX-Testnets
+   */
 ⋮----
-bs: number; // Notional bracket
-bnf: number; // Floor notional of this bracket
-bnc: number; // Cap notional of this bracket
-mmr: number; // Maintenance ratio for this bracket
-cf: number; // Auxiliary number for quick calculation
-mi: number; // Min leverage for this bracket
-ma: number; // Max leverage for this bracket
+/**
+   * Default: false. If true, use market maker endpoints when available.
+   * Eligible for high-frequency trading users who have enrolled and qualified
+   * in at least one of the Futures Liquidity Provider Programs.
+   * More info: https://www.binance.com/en/support/faq/detail/7df7f3838c3b49e692d175374c3a3283
+   */
 ⋮----
-export type WsRawSpotUserDataEventRaw =
-  | WsMessageSpotUserDataExecutionReportEventRaw
-  | WsMessageSpotOutboundAccountPositionRaw
-  | WsMessageSpotBalanceUpdateRaw
-  | WsMessageSpotUserDataListStatusEventRaw;
+/** Define a recv window when preparing a private websocket signature. This is in milliseconds, so 5000 == 5 seconds */
 ⋮----
-export type WsMessageFuturesUserDataEventRaw =
-  | WsMessageFuturesUserDataAccountUpdateRaw
-  | WsMessageFuturesUserDataListenKeyExpiredRaw
-  | WsMessageFuturesUserDataMarginCallRaw
-  | WsMessageFuturesUserDataOrderTradeUpdateEventRaw
-  | WsMessageFuturesUserDataAccountConfigUpdateEventRaw
-  | WsMessageFuturesUserDataCondOrderTriggerRejectEventRaw
-  | WsMessageFuturesUserDataTradeLiteEventRaw
-  | WsMessageFuturesUserDataStrategyUpdateRaw
-  | WsMessageFuturesUserDataGridUpdateRaw
-  | WsMessageFuturesUserDataContractInfoRaw;
+// Disable ping/pong ws heartbeat mechanism (not recommended)
 ⋮----
-export type WsRawMessage =
-  | WsMessageKlineRaw
-  | WsMessageAggTradeRaw
-  | WsMessageTradeRaw
-  | WsMessage24hrMiniTickerRaw
-  | WsMessage24hrMiniTickerRaw[]
-  | WsMessage24hrTickerRaw
-  | WsMessage24hrTickerRaw[]
-  | WsMessageRollingWindowTickerRaw[]
-  | WsMessageBookTickerEventRaw
-  | WsMessagePartialBookDepthEventRaw
-  | WsMessageForceOrderRaw
-  | WsRawSpotUserDataEventRaw
-  | WsMessageIndexPriceUpdateEventRaw
-  | WsMessageFuturesUserDataAccountUpdateRaw
-  | WsMessageFuturesUserDataListenKeyExpiredRaw
-  | WsMessageFuturesUserDataMarginCallRaw
-  | WsMessageFuturesUserDataOrderTradeUpdateEventRaw
-  | WsMessageFuturesUserDataAccountConfigUpdateEventRaw
-  | WsMessageFuturesUserDataCondOrderTriggerRejectEventRaw;
+/** How often to check if the connection is alive */
+⋮----
+/** How long to wait for a pong (heartbeat reply) before assuming the connection is dead */
+⋮----
+/** Delay in milliseconds before respawning the connection */
+⋮----
+/**
+   * Allows you to provide a custom "signMessage" function, e.g. to use node's much faster createHmac method
+   *
+   * Look in the examples folder for a demonstration on using node's createHmac instead.
+   */
+⋮----
+/**
+ * WS configuration that's always defined, regardless of user configuration
+ * (usually comes from defaults if there's no user-provided values)
+ */
+export interface WebsocketClientOptions extends WSClientConfigurableOptions {
+  pongTimeout: number;
+  pingInterval: number;
+  reconnectTimeout: number;
+  recvWindow: number;
+  authPrivateConnectionsOnConnect: boolean;
+  authPrivateRequests: boolean;
+}
 
 ================
 File: src/types/futures.ts
@@ -10349,133 +10226,34 @@ async function main()
 // the `subscribeUserDataStream()` method again if reconnected (if you called it before):
 // resubscribeUserDataStreamAfterReconnect: true,
 ⋮----
-// If you want your own event handlers instead of the default ones with logs, disable this setting and see the `attachEventHandlers` example below:
-// attachEventListeners: false
-⋮----
-// Optional, attach basic event handlers, so nothing is left unhandled
-// attachEventHandlers(wsClient.getWSClient());
-⋮----
-// Optional, if you see RECV Window errors, you can use this to manage time issues.
-// ! However, make sure you sync your system clock first!
-// https://github.com/tiagosiebler/awesome-crypto-examples/wiki/Timestamp-for-this-request-is-outside-of-the-recvWindow
-// wsClient.setTimeOffsetMs(-5000);
-⋮----
-// Optional. Can be used to prepare a connection before sending commands.
-// Can be done as part of a bootstrapping workflow, to reduce initial latency when sending the first command
-// await wsClient.getWSClient().connectWSAPI(WS_KEY_MAP.mainWSAPI);
-⋮----
-// SPOT - Market data requests
-⋮----
-// SPOT - Trading requests
-⋮----
-// SPOT - Account requests
-⋮----
-// FUTURES - Market data requests
-⋮----
-// FUTURES - Trading requests
-⋮----
-// FUTURES - Account requests
-⋮----
-// Start executing the example workflow
-
-================
-File: examples/README.md
-================
-# Binance API - Examples
-
-This folder contains ready to go examples demonstrating various aspects of this API implementation, written in TypeScript (but they are compatible with pure JavaScript projects).
-
-Found something difficult to implement? Contribute to these examples and help others!
-
-## Getting started
-
-- Clone the project (or download it as a zip, or install the module in your own project `npm install binance`).
-- Edit the sample as needed (some samples require edits, e.g API keys or import statements to import from npm, not src).
-- Execute the sample using tsx: `tsx examples/REST/rest-spot-public.ts`.
-
-Samples that refer to API credentials using `process.env.API_KEY_COM` can be spawned with environment variables. Unix/macOS example:
-```
-APIKEY='apikeypastedhere' APISECRET='apisecretpastedhere' tsx examples/WebSockets/ws-userdata-listenkey.ts
-```
-
-Or edit the example directly to hardcode your API keys.
-
-### WebSockets
-
-All examples relating to WebSockets can be found in the [examples/WebSockets](./WebSockets/) folder. High level summary of available examples:
-
-#### Consumers
-
-These are purely for receiving data from Binance's WebSockets (market data, account updates, etc).
-
-##### Market Data
-
-These examples demonstrate subscribing to & receiving market data from Binance's WebSockets:
-
-- ws-public.ts
-  - Demonstration on general usage of the WebSocket client to subscribe to / unsubscribe from one or more market data topics.
-- ws-public-spot-orderbook.ts
-  - Subscribing to orderbook events for multiple symbols in spot markets.
--	ws-public-spot-trades.ts
-  - Subscribing to raw trades for multiple symbols in spot markets.
-- ws-unsubscribe.ts
-  - Subscribing to a list of topics, and then unsubscribing from a few topics in that list.
-- ws-public-usdm-funding.ts
-  - Simple example subscribing to a general topic, and how to process incoming events to only extract funding rates from those events.
-
-##### Account Data
-
-These examples demonstrate receiving account update events from Binance's WebSockets:
-
--	ws-userdata-listenkey.ts
-  - Demonstration on subscribing to various user data streams (spot, margin, futures),
-  - Handling incoming user data events
-  - Using provided type guards to determine which product group the user data event is for (spot, margin, futures, etc).
-- ws-userdata-listenKey-testnet.ts
-  - Similar to above, but on testnet.
-- ws-userdata-connection-safety.ts
-  - Demonstration on extra safety around the first user data stream connection.
-  - Note: this is overkill in most situations...
-
-##### WebSocket API
-
-These examples demonstrate how to send commands using Binance's WebSocket API (e.g. submitting orders). Very similar to the REST API, but using a persisted WebSocket connection instead of HTTP requests.
-
-- ws-api-client.ts
-  - Demonstration of using Binance's WebSocket API in Node.js/JavaScript/TypeScript, using the WebsocketAPIClient.
-  - This WebsocketAPIClient is very similar to a REST client, with one method per available command (endpoint) and fully typed requests & responses.
-  - Routing is automatically handled via the WebsocketClient, including authentication and connection persistence. Just call the functions you need - the SDK does the rest.
-  - From a usage perspective, it feels like a REST API - you can await responses just like a HTTP request.
-- ws-api-raw-promises.ts
-  - More verbose usage of the WebSocket API using the `sendWSAPIRequest()` method.
-  - The `WebsocketAPIClient` uses this method too, so in most cases it is simple to just use the `WebsocketAPIClient` instead.
-- ws-userdata-wsapi.ts
-  - The listenKey workflow for the user data stream is deprecated (in spot markets).
-  - This example demonstrates how to subscribe to the user data stream in spot markets, without a listen key, using the WebSocket API.
-
-##### Misc Workflows
-
-These are miscellaneous examples that cover one or more of the above categories:
-
-- ws-close.ts
-  - Closing the (old listen-key driven) user data stream.
-  - Unsubscribing from various topics.
-- ws-proxy-socks.ts
-  - Using WebSockets over a SOCKS proxy.
-- deprecated-ws-public.ts
-
-
-### REST APIs
-
-All examples relating to REST APIs can be found in the [examples/REST](./REST/) folder. Most examples are named around functionality & product group. Any examples with "private" involve API calls relating to your account (such as changing settings or submitting orders, etc),
-
-High level summary for some of the available examples, but check the folder for a complete list:
-
-#### REST USDM Examples
-
-- `rest-future-bracket-order.ts` Creates three order, entry, TP, SL and submit them all at once using `submitMultipleOrders`
-- `rest-usdm-order.ts` Creates single entry, using `submitNewOrder`
-- `rest-usdm-order-sl.ts` Modify current Stop Loss order(HedgeMode only)
+// If you want your own event handlers instead of the default ones with logs, disable this setting and see the `attachEventHandlers` example below:
+// attachEventListeners: false
+⋮----
+// Optional, attach basic event handlers, so nothing is left unhandled
+// attachEventHandlers(wsClient.getWSClient());
+⋮----
+// Optional, if you see RECV Window errors, you can use this to manage time issues.
+// ! However, make sure you sync your system clock first!
+// https://github.com/tiagosiebler/awesome-crypto-examples/wiki/Timestamp-for-this-request-is-outside-of-the-recvWindow
+// wsClient.setTimeOffsetMs(-5000);
+⋮----
+// Optional. Can be used to prepare a connection before sending commands.
+// Can be done as part of a bootstrapping workflow, to reduce initial latency when sending the first command
+// await wsClient.getWSClient().connectWSAPI(WS_KEY_MAP.mainWSAPI);
+⋮----
+// SPOT - Market data requests
+⋮----
+// SPOT - Trading requests
+⋮----
+// SPOT - Account requests
+⋮----
+// FUTURES - Market data requests
+⋮----
+// FUTURES - Trading requests
+⋮----
+// FUTURES - Account requests
+⋮----
+// Start executing the example workflow
 
 ================
 File: examples/WebSockets/ws-api-raw-promises.ts
@@ -17826,107 +17604,362 @@ l: number; // last trade ID
 T: number; // timestamp
 m: boolean; // is buyer market maker
 ⋮----
-export interface AlphaKlinesParams {
-  symbol: string;
-  interval: string; // 1s, 15s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M
-  limit?: number;
-  startTime?: number;
-  endTime?: number;
-}
+export interface AlphaKlinesParams {
+  symbol: string;
+  interval: string; // 1s, 15s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M
+  limit?: number;
+  startTime?: number;
+  endTime?: number;
+}
+⋮----
+interval: string; // 1s, 15s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M
+⋮----
+export type AlphaKline = [
+  string, // Open time
+  string, // Open price
+  string, // High price
+  string, // Low price
+  string, // Close price
+  string, // Volume
+  string, // Close time
+  string, // Quote asset volume
+  string, // Number of trades
+  string, // Taker buy base asset volume
+  string, // Taker buy quote asset volume
+  string, // Ignore (always "0")
+];
+⋮----
+string, // Open time
+string, // Open price
+string, // High price
+string, // Low price
+string, // Close price
+string, // Volume
+string, // Close time
+string, // Quote asset volume
+string, // Number of trades
+string, // Taker buy base asset volume
+string, // Taker buy quote asset volume
+string, // Ignore (always "0")
+⋮----
+export interface AlphaTickerParams {
+  symbol: string;
+}
+⋮----
+export interface AlphaTicker {
+  symbol: string;
+  priceChange: string;
+  priceChangePercent: string;
+  weightedAvgPrice: string;
+  lastPrice: string;
+  lastQty: string;
+  openPrice: string;
+  highPrice: string;
+  lowPrice: string;
+  volume: string;
+  quoteVolume: string;
+  openTime: number;
+  closeTime: number;
+  firstId: number;
+  lastId: number;
+  count: number;
+}
+
+================
+File: examples/WebSockets/ws-public.ts
+================
+/* eslint-disable @typescript-eslint/no-unused-vars */
+import {
+  DefaultLogger,
+  isWsAggTradeFormatted,
+  isWsFormatted24hrTicker,
+  isWsFormatted24hrTickerArray,
+  isWsFormattedForceOrder,
+  isWsFormattedKline,
+  isWsFormattedMarkPriceUpdateArray,
+  isWsFormattedMarkPriceUpdateEvent,
+  isWsFormattedRollingWindowTickerArray,
+  isWsFormattedTrade,
+  isWsPartialBookDepthEventFormatted,
+  WebsocketClient,
+} from '../../src';
+⋮----
+// or, with the npm package
+/*
+import {
+  WebsocketClient,
+  DefaultLogger,
+  isWsFormatted24hrTicker,
+  isWsFormattedKline,
+} from 'binance';
+*/
+⋮----
+// Without typescript:
+// const logger = {
+⋮----
+// A simple way to suppress heartbeats but receive all other traces
+// if (params[0].includes('ping') || params[0].includes('pong')) {
+//   return;
+// }
+⋮----
+// Optional: when enabled, the SDK will try to format incoming data into more readable objects.
+// Beautified data is emitted via the "formattedMessage" event
+⋮----
+logger, // Optional: customise logging behaviour by extending or overwriting the default logger implementation
+⋮----
+// Raw unprocessed incoming data, e.g. if you have the beautifier disabled
+⋮----
+// console.log('raw message received ', JSON.stringify(data, null, 2));
+// console.log('raw message received ', JSON.stringify(data));
+⋮----
+// Formatted data that has gone through the beautifier
+⋮----
+/**
+     * Optional: we've included type-guards for many formatted websocket topics.
+     *
+     * These can be used within `if` blocks to narrow down specific event types (even for non-typescript users).
+     */
+// if (isWsAggTradeFormatted(data)) {
+//   console.log('log agg trade: ', data);
+//   return;
+// }
+⋮----
+// // For one symbol
+// if (isWsFormattedMarkPriceUpdateEvent(data)) {
+//   console.log('log mark price: ', data);
+//   return;
+// }
+⋮----
+// // for many symbols
+// if (isWsFormattedMarkPriceUpdateArray(data)) {
+//   console.log('log mark prices: ', data);
+//   return;
+// }
+⋮----
+// if (isWsFormattedKline(data)) {
+//   console.log('log kline: ', data);
+//   return;
+// }
+⋮----
+// if (isWsFormattedTrade(data)) {
+//   return console.log('log trade: ', data);
+// }
+⋮----
+// if (isWsFormattedForceOrder(data)) {
+//   return console.log('log force order: ', data);
+// }
+⋮----
+// if (isWsFormatted24hrTickerArray(data)) {
+//   return console.log('log 24hr ticker array: ', data);
+// }
+⋮----
+// if (isWsFormattedRollingWindowTickerArray(data)) {
+//   return console.log('log rolling window ticker array: ', data);
+// }
+⋮----
+// if (isWsFormatted24hrTicker(data)) {
+//   return console.log('log 24hr ticker: ', data);
+// }
+⋮----
+// if (isWsPartialBookDepthEventFormatted(data)) {
+//   return console.log('log partial book depth event: ', data);
+// }
+⋮----
+// response to command sent via WS stream (e.g LIST_SUBSCRIPTIONS)
+⋮----
+// No action needed here, unless you need to query the REST API after being reconnected.
+⋮----
+/**
+     * The Websocket Client will automatically manage connectivity and active topics/subscriptions for you.
+     *
+     * Simply call wsClient.subscribe(topic, wsKey) as many times as you want, with or without an array.
+     */
+⋮----
+// // E.g. one at a time, routed to the coinm futures websockets:
+// wsClient.subscribe('btcusd@indexPrice', 'coinm');
+// wsClient.subscribe('btcusd@miniTicker', 'coinm');
+⋮----
+// // Or send many topics at once to a stream, e.g. the usdm futures stream:
+// wsClient.subscribe(
+//   [
+//     'btcusdt@aggTrade',
+//     'btcusdt@markPrice',
+//     '!ticker@arr',
+//     '!miniTicker@arr',
+//   ],
+//   'usdm',
+// );
+⋮----
+/**
+     * Subscribe to each available type of spot market topic, the new way
+     */
+⋮----
+// Aggregate Trade Streams
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#aggregate-trade-streams
+⋮----
+// Trade Streams
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#trade-streams
+⋮----
+// Kline/Candlestick Streams for UTC
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#klinecandlestick-streams-for-utc
+⋮----
+// Kline/Candlestick Streams with timezone offset
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#klinecandlestick-streams-with-timezone-offset
+⋮----
+// Individual Symbol Mini Ticker Stream
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#individual-symbol-mini-ticker-stream
+⋮----
+// All Market Mini Tickers Stream
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#all-market-mini-tickers-stream
+⋮----
+// Individual Symbol Ticker Streams
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#individual-symbol-ticker-streams
+⋮----
+// All Market Tickers Stream
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#all-market-tickers-stream
+⋮----
+// Individual Symbol Rolling Window Statistics Streams
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#individual-symbol-rolling-window-statistics-streams
+⋮----
+// All Market Rolling Window Statistics Streams
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#all-market-rolling-window-statistics-streams
+⋮----
+// Individual Symbol Book Ticker Streams
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#individual-symbol-book-ticker-streams
+⋮----
+// Average Price
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#average-price
+⋮----
+// Partial Book Depth Streams
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#partial-book-depth-streams
+⋮----
+// Diff. Depth Stream
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams#diff-depth-stream
+⋮----
+// Look at the `WS_KEY_URL_MAP` for a list of values here:
+// https://github.com/tiagosiebler/binance/blob/master/src/util/websockets/websocket-util.ts
+// "main" connects to wss://stream.binance.com:9443/stream
+// https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams
+⋮----
+// Aggregate Trade Stream
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Aggregate-Trade-Streams
 ⋮----
-interval: string; // 1s, 15s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M
+// Mark Price Stream
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Mark-Price-Stream
 ⋮----
-export type AlphaKline = [
-  string, // Open time
-  string, // Open price
-  string, // High price
-  string, // Low price
-  string, // Close price
-  string, // Volume
-  string, // Close time
-  string, // Quote asset volume
-  string, // Number of trades
-  string, // Taker buy base asset volume
-  string, // Taker buy quote asset volume
-  string, // Ignore (always "0")
-];
+// Mark Price Stream for All market
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Mark-Price-Stream-for-All-market
 ⋮----
-string, // Open time
-string, // Open price
-string, // High price
-string, // Low price
-string, // Close price
-string, // Volume
-string, // Close time
-string, // Quote asset volume
-string, // Number of trades
-string, // Taker buy base asset volume
-string, // Taker buy quote asset volume
-string, // Ignore (always "0")
+// Kline/Candlestick Streams
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Kline-Candlestick-Streams
+// 'btcusdt@kline_1m',
+// Continuous Contract Kline/Candlestick Streams
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Continuous-Contract-Kline-Candlestick-Streams
+// 'btcusdt_perpetual@continuousKline_1m', // DOESNT EXIST AS TYPE GUARD, ONLY IN BEAUTIFIER
+// Individual Symbol Mini Ticker Stream
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Individual-Symbol-Mini-Ticker-Stream
+// 'btcusdt@miniTicker', // DOESNT EXIST AS TYPE GUARD, ONLY FOR RAW MESSAGE
+// All Market Mini Tickers Stream
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Market-Mini-Tickers-Stream
+// '!miniTicker@arr', // DOESNT EXIST AS TYPE GUARD
+// Individual Symbol Ticker Streams
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Individual-Symbol-Ticker-Streams
+//'btcusdt@ticker',
+// All Market Tickers Stream
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Market-Tickers-Stream
+// '!ticker@arr', // DOESNT EXIST AS TYPE GUARD
+// Individual Symbol Book Ticker Streams
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Individual-Symbol-Book-Ticker-Streams
+//'btcusdt@bookTicker', // DOESNT EXIST AS TYPE GUARD
+// All Book Tickers Stream
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Book-Tickers-Stream
+// '!bookTicker', // DOESNT EXIST AS TYPE GUARD
+// Liquidation Order Stream
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Liquidation-Order-Streams
+// 'btcusdt@forceOrder',
+// Liquidation Order Stream for All market
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams
+//'!forceOrder@arr',
+// Partial Book Depth Streams
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Partial-Book-Depth-Streams
+//'btcusdt@depth5',
+// 'btcusdt@depth10@100ms'
+// Diff. Book Depth Stream
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Diff-Book-Depth-Streams
+// 'btcusdt@depth',
+// 'btcusdt@depth@100ms',
+// 'btcusdt@depth@500ms',
+// 'btcusdt@depth@1000ms'
+// Composite Index Symbol Information Streams
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Composite-Index-Symbol-Information-Streams
+// 'btcusdt@compositeIndex' // DOESNT EXIST AS TYPE GUARD
+// Contract Info Stream
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Contract-Info-Stream
+// '!contractInfo' // DOESNT EXIST AS TYPE GUARD
+// Multi-Assets Mode Asset Index Stream
+// https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Multi-Assets-Mode-Asset-Index
+// '!assetIndex@arr' // DOESNT EXIST AS TYPE GUARD
+// 'btcusdt@assetIndex'
 ⋮----
-export interface AlphaTickerParams {
-  symbol: string;
-}
+/**
+     * Subscribe to each available european options market data websocket topic, the new way:
+     *
+     * https://developers.binance.com/docs/derivatives/option/websocket-market-streams/New-Symbol-Info
+     *
+     * https://eapi.binance.com/eapi/v1/exchangeInfo
+     */
 ⋮----
-export interface AlphaTicker {
-  symbol: string;
-  priceChange: string;
-  priceChangePercent: string;
-  weightedAvgPrice: string;
-  lastPrice: string;
-  lastQty: string;
-  openPrice: string;
-  highPrice: string;
-  lowPrice: string;
-  volume: string;
-  quoteVolume: string;
-  openTime: number;
-  closeTime: number;
-  firstId: number;
-  lastId: number;
-  count: number;
-}
-
-================
-File: examples/WebSockets/ws-userdata-README.MD
-================
-# User Data Streams - Binance
-
-The user data streams are the WebSocket method for asynchronously receiving events when any changes happen on your account. Including but not limited to:
-- order events (filled/cancelled/updated/etc)
-- position events
-- balance events (deposit/withdraw/etc)
-- misc events (leverage changed, position mode changed, etc)
-
-## Mechanisms
-
-There are currently two key mechanisms for subscribing to user data events
-
-### Mechanisms - Listen Key
-
-The older and original mechanism involves a listen key. This is requested via the REST API and then used when opening a connection to the user data stream.
-
-The listen key can expire and needs a regular "ping" (a REST API call) to keep it alive.
-
-With the "binance" Node.js & JavaScript SDK, you can easily subscribe to the user data stream via the listen key workflow, through just one function call.
-
-The SDK will automatically:
-- fetch a listen key
-- perform regular keep alive requests on the listen key
-- handle listen key expiry/refresh
-- handle reconnects, if a connection is temporarily lost
-
-All you have to do is ask for the user data stream and process incoming events - the SDK will handle the rest!
-
-For a working example, refer to the [ws-userdata-listenkey](./ws-userdata-listenkey.ts) example.
-
-**Deprecation warning: As of April 2025, the listen key workflow is also deprecated for Spot markets (no known ETA for removal).** Refer to the changelog for details: https://developers.binance.com/docs/binance-spot-api-docs/CHANGELOG#2025-04-07
-
-### Mechanisms - WS API User Data Stream
-
-The newer mechanism for the user data stream is via an active WebSocket API connection. This is a simpler mechanism in that it does not require a listen key. You can easily use this new mechanism via the WebsocketClient (or WebsocketAPIClient) within this SDK.
-
-For a working example, refer to the [ws-userdata-wsapi](./ws-userdata-wsapi.ts) example.
+// /**
+//  *
+//  * For those that used the Node.js Binance SDK before the v3 release, you can
+//  * still subscribe to available market topics the "old" way, for convenience
+//  * when migrating from the old WebsocketClient to the new multiplex client):
+//  *
+//  */
+⋮----
+// wsClient.subscribeAggregateTrades(symbol, 'usdm');
+// wsClient.subscribeTrades(symbol, 'spot');
+// wsClient.subscribeTrades(symbol, 'usdm');
+// wsClient.subscribeTrades(coinMSymbol, 'coinm');
+// wsClient.subscribeCoinIndexPrice(coinMSymbol2);
+// wsClient.subscribeAllBookTickers('usdm');
+// wsClient.subscribeSpotKline(symbol, '1m');
+// wsClient.subscribeMarkPrice(symbol, 'usdm');
+// wsClient.subscribeMarkPrice(coinMSymbol, 'coinm');
+// wsClient.subscribeAllMarketMarkPrice('usdm');
+// wsClient.subscribeAllMarketMarkPrice('coinm');
+// wsClient.subscribeKlines(symbol, '1m', 'usdm');
+// wsClient.subscribeContinuousContractKlines(
+//   symbol,
+//   'perpetual',
+//   '1m',
+//   'usdm',
+// );
+// wsClient.subscribeIndexKlines(coinMSymbol2, '1m');
+// wsClient.subscribeMarkPriceKlines(coinMSymbol, '1m');
+// wsClient.subscribeSymbolMini24hrTicker(symbol, 'spot'); // 0116 265 5309, opt 1
+// wsClient.subscribeSymbolMini24hrTicker(symbol, 'usdm');
+// wsClient.subscribeSymbolMini24hrTicker(coinMSymbol, 'coinm');
+// wsClient.subscribeSymbol24hrTicker(symbol, 'spot');
+// wsClient.subscribeSymbol24hrTicker(symbol, 'usdm');
+// wsClient.subscribeSymbol24hrTicker(coinMSymbol, 'coinm');
+// wsClient.subscribeAllMini24hrTickers('spot');
+// wsClient.subscribeAllMini24hrTickers('usdm');
+// wsClient.subscribeAllMini24hrTickers('coinm');
+// wsClient.subscribeAll24hrTickers('spot');
+// wsClient.subscribeAll24hrTickers('usdm');
+// wsClient.subscribeAll24hrTickers('coinm');
+// wsClient.subscribeSymbolLiquidationOrders(symbol, 'usdm');
+// wsClient.subscribeAllLiquidationOrders('usdm');
+// wsClient.subscribeAllLiquidationOrders('coinm');
+// wsClient.subscribeSpotSymbol24hrTicker(symbol);
+// wsClient.subscribeSpotPartialBookDepth('ETHBTC', 5, 1000);
+// wsClient.subscribeAllRollingWindowTickers('spot', '1d');
+// wsClient.subscribeSymbolBookTicker(symbol, 'spot');
+// wsClient.subscribePartialBookDepths(symbol, 5, 100, 'spot');
+// wsClient.subscribeDiffBookDepth(symbol, 100, 'spot');
+// wsClient.subscribeContractInfoStream('usdm');
+// wsClient.subscribeContractInfoStream('coinm');
 
 ================
 File: src/main-client.ts
@@ -22147,6 +22180,80 @@ client
 
 See [coinm-client.ts](./src/coinm-client.ts) for further information.
 
+## Market Maker Endpoints
+
+Binance provides specialized market maker endpoints for qualified high-frequency trading users who have enrolled in at least one of the Futures Liquidity Provider Programs, including the USDⓈ-M Futures Maker Program, COIN-M Futures Maker Program, and USDⓈ-M Futures Taker Program.
+
+These endpoints provide the same functionality as regular endpoints but with optimized routing for market makers. For more information about eligibility and enrollment, visit: https://www.binance.com/en/support/faq/detail/7df7f3838c3b49e692d175374c3a3283
+
+### Using Market Maker Endpoints
+
+To use market maker endpoints, simply add the `useMMEndpoints: true` option when initializing any client (REST API clients, WebSocket clients, or WebSocket API clients):
+
+#### REST API Clients
+
+```javascript
+import { USDMClient, CoinMClient } from 'binance';
+
+// USD-M Futures with MM endpoints
+const usdmClient = new USDMClient({
+  api_key: API_KEY,
+  api_secret: API_SECRET,
+  useMMEndpoints: true, // Enable market maker endpoints
+});
+
+// COIN-M Futures with MM endpoints
+const coinmClient = new CoinMClient({
+  api_key: API_KEY,
+  api_secret: API_SECRET,
+  useMMEndpoints: true, // Enable market maker endpoints
+});
+```
+
+#### WebSocket Clients
+
+```javascript
+import { WebsocketClient, WebsocketAPIClient } from 'binance';
+
+// WebSocket consumer with MM endpoints
+const wsClient = new WebsocketClient({
+  api_key: API_KEY,
+  api_secret: API_SECRET,
+  useMMEndpoints: true, // Enable market maker endpoints
+});
+
+// WebSocket API client with MM endpoints
+const wsApiClient = new WebsocketAPIClient({
+  api_key: API_KEY,
+  api_secret: API_SECRET,
+  useMMEndpoints: true, // Enable market maker endpoints
+});
+```
+
+**Note:** Market maker endpoints are only available for futures products (USD-M and COIN-M). Spot, margin, and other product groups use the regular endpoints regardless of the `useMMEndpoints` setting. Market maker endpoints are also not available on testnet environments.
+
+### Best practice
+
+Since market maker endpoints are only available for some of the futures endpoints, you may need to use multiple client instances if your algorithm needs to use both regular and MM endpoints.
+
+```javascript
+import { USDMClient } from 'binance';
+
+// MM client for USD-M futures
+const futuresMMClient = new USDMClient({
+  api_key: API_KEY,
+  api_secret: API_SECRET,
+  useMMEndpoints: true, // Use MM endpoints for futures
+});
+
+// Regular client for USD-M futures
+const futuresRegularClient = new USDMClient({
+  api_key: API_KEY,
+  api_secret: API_SECRET,
+  useMMEndpoints: false, // Use regular endpoints for futures
+});
+```
+
 ## WebSockets
 
 ### WebSocket Consumers
@@ -23529,7 +23636,7 @@ File: package.json
 ================
 {
   "name": "binance",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "description": "Professional Node.js & JavaScript SDK for Binance REST APIs & WebSockets, with TypeScript & end-to-end tests.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -23627,6 +23734,7 @@ File: package.json
 
 
 
+
 ================================================================
 End of Codebase
 ================================================================