Bitget V3 UTA JavaScript SDK example: ws-public.ts
Bitget V3 UTA websocket public JavaScript example for the Siebly Bitget SDK, covering exchange REST API and WebSocket integration, setup, and production SDK docs.
We use environment variables in our examples for API keys. It is your responsibility to manage and secure your keys appropriately.
examples/Bitget/V3 - UTA/Websocket/ws-public.ts
What this example covers
- Bitget WebSocket stream JavaScript example.
- Uses the Siebly Bitget SDK package
bitget-apiinstead of hand-written WebSocket plumbing. - Source path:
Bitget/V3 - UTA/Websocket/ws-public.ts. - Example category: V3 UTA.
- 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.
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);})();