Bitget TypeScript SDK example: ws-public.ts

What This Example Covers

• Bitget WebSocket stream example in TypeScript.
• Uses the Siebly Bitget SDK package bitget-api instead of hand-written WebSocket plumbing.
• Source path: Bitget/V3 - UTA/Websocket/ws-public.ts.
• Example category: V3 UTA WebSocket.
• Imports SDK symbols including DefaultLogger, WebsocketClientV3, WS_KEY_MAP.
• Calls SDK methods such as on(), subscribe(), getWsStore().

How To Use This Example

• Start here for the specific request or stream pattern, then check the matching SDK guide for install, credentials, and operational notes.
• For WebSocket examples, keep reconnect, resubscribe, heartbeat, and event-handler behavior explicit in your service.
• Open the repository source when you need the latest committed version: GitHub source file.

Example Path

Bitget/V3 - UTA/Websocket/ws-public.ts

Source Link

Repository source: https://github.com/sieblyio/crypto-api-examples/blob/master/examples/Bitget/V3 - UTA/Websocket/ws-public.ts

Related SDK Docs

• All examples index
• Bitget SDK overview
• Closest matching SDK guide: Bitget TypeScript SDK
• Bitget JavaScript SDK
• Bitget Node.js SDK

Example Source

import { DefaultLogger, WebsocketClientV3, WS_KEY_MAP } from 'bitget-api';

(async () => {
  const logger = {
    ...DefaultLogger,
    trace: (...params: any[]) => console.log('trace', ...params),
  };

  const wsClient = new WebsocketClientV3({}, logger);

  wsClient.on('update', (data) => {
    console.log('WS raw message received ', data);
    // console.log('WS raw message received ', JSON.stringify(data, null, 2));
  });

  wsClient.on('open', (data) => {
    console.log('WS connection opened:', data.wsKey);
  });
  wsClient.on('response', (data) => {
    console.log('WS response: ', JSON.stringify(data, null, 2));
  });
  wsClient.on('reconnect', ({ wsKey }) => {
    console.log('WS automatically reconnecting.... ', wsKey);
  });
  wsClient.on('reconnected', (data) => {
    console.log('WS reconnected ', data?.wsKey);
  });
  wsClient.on('exception', (data) => {
    console.log('WS error', data);
  });

  /**
   * Public events
   */

  // You can subscribe to one topic at a time
  wsClient.subscribe(
    {
      topic: 'ticker',
      payload: {
        instType: 'spot',
        symbol: 'BTCUSDT',
      },
    },
    WS_KEY_MAP.v3Public, // This parameter points to private or public
  );

  // Or multiple at once:
  wsClient.subscribe(
    [
      {
        topic: 'ticker',
        payload: {
          instType: 'spot',
          symbol: 'BTCUSDT',
        },
      },
      {
        topic: 'ticker',
        payload: {
          instType: 'spot',
          symbol: 'ETHUSDT',
        },
      },
      {
        topic: 'ticker',
        payload: {
          instType: 'spot',
          symbol: 'XRPUSDT',
        },
      },
      {
        topic: 'ticker',
        payload: {
          instType: 'usdt-futures',
          symbol: 'BTCUSDT',
        },
      },
      {
        topic: 'ticker',
        payload: {
          instType: 'usdt-futures',
          symbol: 'BTCUSDT',
        },
      },
    ],
    WS_KEY_MAP.v3Public,
  );

  // Topics are tracked per websocket type
  // The below example will pull a list of subscribed topics on that connection (e.g. all public topics), after a 5 second delay:
  setTimeout(() => {
    const publicTopics = wsClient.getWsStore().getTopics(WS_KEY_MAP.v3Public);

    console.log('public topics: ', publicTopics);
  }, 5 * 1000);
})();