Public WebSocket subscriptions
WebsocketClientV3 connects when needed, maintains heartbeats and restores requested subscriptions after reconnects.
Subscribe to ticker updates
Install bitget-api and save this example as stream.ts. It subscribes to public BTCUSDT Spot ticker updates without credentials.
import { WebsocketClientV3, WS_KEY_MAP } from 'bitget-api';
const ws = new WebsocketClientV3();
ws.on('update', (message) => {
console.log('Market update:', message);
});
ws.on('response', (message) => {
console.log('Subscription response:', message);
});
ws.on('exception', (error) => {
console.error('Public WebSocket exception:', error);
});
ws.on('reconnect', () => {
console.log('Reconnecting; market data may be stale.');
});
ws.on('reconnected', () => {
console.log('Connection restored; the SDK restores subscriptions automatically. Wait for fresh market data.');
});
ws.subscribe({
topic: 'ticker',
payload: {
instType: 'spot',
symbol: 'BTCUSDT',
},
}, WS_KEY_MAP.v3Public).catch((error) => {
console.error('Public subscription failed:', error);
ws.closeAll();
process.exitCode = 1;
});
process.once('SIGINT', () => {
ws.closeAll();
});Run it on Node.js 24, or compile it with your TypeScript project:
node stream.tsThe example logs subscription responses and incoming market updates. Leave it running to receive new prices, then press Ctrl+C to close the connection.
Subscription acknowledgement and data
subscribe() returns a promise. Listen for response acknowledgements and exception failures as well as update messages; check acknowledgements to confirm that the exchange accepted each subscription. Route updates using arg.topic, arg.instType and arg.symbol. For the ticker subscription, data[0].lastPrice is the latest price as a decimal string.
subscribe() takes a topic/payload object and WS_KEY_MAP.v3Public as the second argument. For multiple topics on that connection, pass an array of objects. Use unsubscribe() with the same topic/payload and connection key when the subscription is no longer needed. See the V3 reference and ticker channel documentation.
Classic V2 alternative
Existing Classic integrations can use WebsocketClientV2.subscribeTopic('SPOT', 'ticker', 'BTCUSDT'), with unsubscribeTopic() for cleanup. Classic topics use instId and uppercase SPOT, unlike V3's symbol and lowercase spot. Classic ticker prices use lastPr, not V3's lastPrice. Check the topic and response fields when switching between API versions.
Recovery and shutdown
The SDK restores subscriptions automatically after reconnecting; you do not need to subscribe again. The reconnected event means the socket is open, not that fresh data has arrived. Treat cached data as stale until fresh updates arrive. For incremental order books, follow the channel's recovery procedure before applying further deltas.
Call closeAll() when shutting down. Browser/mobile views should unsubscribe or close their owned connections when removed; do not reconnect on every render. Closing a socket does not cancel orders.