WebsocketAPIClient: Promise-Based Binance WebSocket API

import { WebsocketAPIClient, WS_KEY_MAP } from 'binance';

const wsClient = new WebsocketAPIClient({
  api_key: process.env.BINANCE_API_KEY,
  api_secret: process.env.BINANCE_API_SECRET,
  beautify: true,
});

async function main() {
  // Market data — no authentication needed
  const orderBook = await wsClient.getSpotOrderBook({
    symbol: 'BTCUSDT',
  });
  console.log('Order book:', orderBook.result);

  // Session status — shows authentication details
  const session = await wsClient.getSpotSessionStatus();
  console.log('Session status:', session.result);

  // Place a limit order (requires authentication)
  const order = await wsClient.submitNewSpotOrder({
    symbol: 'BTCUSDT',
    side: 'BUY',
    type: 'LIMIT',
    timeInForce: 'GTC',
    price: '20000.00',
    quantity: '0.001',
  });
  console.log('Order placed:', order.result);

  // Place a USD-M futures order
  const futuresOrder = await wsClient.submitNewFuturesOrder('usdm', {
    symbol: 'BTCUSDT',
    side: 'BUY',
    type: 'LIMIT',
    positionSide: 'BOTH',
    price: '43000.00',
    quantity: 0.01,
    timeInForce: 'GTC',
    timestamp: Date.now(),
  });
  console.log('Futures order:', futuresOrder.result);
}

main().catch(console.error);

import { WebsocketClient, WS_KEY_MAP, WSAPIWsKey } from 'binance';

const wsClient = new WebsocketClient({
  api_key: process.env.BINANCE_API_KEY,
  api_secret: process.env.BINANCE_API_SECRET,
  beautify: true,
});

wsClient.on('open', ({ wsKey }) => console.log('Connected:', wsKey));
wsClient.on('authenticated', ({ wsKey }) => console.log('Authenticated:', wsKey));
wsClient.on('exception', (err) => console.error('Error:', err));

const WS_API_KEY: WSAPIWsKey = WS_KEY_MAP.mainWSAPI;

async function main() {
  // Optional: pre-warm the connection before sending commands
  // await wsClient.connectWSAPI(WS_API_KEY);

  // Ping
  const pong = await wsClient.sendWSAPIRequest(WS_API_KEY, 'ping');
  console.log('Ping response:', pong);

  // Session status
  const status = await wsClient.sendWSAPIRequest(
    WS_API_KEY,
    'session.status',
  );
  console.log('Session status:', status.result);

  // Place a market sell order
  const order = await wsClient.sendWSAPIRequest(
    WS_API_KEY,
    'order.place',
    {
      symbol: 'BTCUSDT',
      side: 'SELL',
      type: 'MARKET',
      quantity: 0.001,
      timestamp: Date.now(),
    },
  );
  console.log('Order placed:', order.result);
}

main().catch(console.error);