KuCoin JavaScript SDK example: ws-futures-public.ts
KuCoin websocket futures public JavaScript example for the Siebly KuCoin 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/Kucoin/WebSockets/ws-futures-public.ts
What this example covers
- KuCoin WebSocket stream JavaScript example.
- Uses the Siebly KuCoin SDK package
kucoin-apiinstead of hand-written WebSocket plumbing. - Source path:
Kucoin/WebSockets/ws-futures-public.ts. - Imports SDK symbols including
WebsocketClient. - Calls SDK methods such as
on(),connect(),subscribe().
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.
/* eslint-disable @typescript-eslint/no-unused-vars */import { WebsocketClient } from 'kucoin-api'; async function start() { // Optional: fully customise the logging experience by injecting a custom logger // const logger: typeof DefaultLogger = { // ...DefaultLogger, // trace: (...params) => { // if ( // [ // 'Sending ping', // 'Sending upstream ws message: ', // 'Received pong', // ].includes(params[0]) // ) { // return; // } // console.log('trace', params); // }, // }; // const client = new WebsocketClient({}, logger); const client = new WebsocketClient(); client.on('open', (data) => { console.log('open: ', data?.wsKey); }); // Data received client.on('update', (data) => { console.info('data received: ', JSON.stringify(data)); }); // Something happened, attempting to reconnect client.on('reconnect', (data) => { console.log('reconnect: ', data); }); // Reconnect successful client.on('reconnected', (data) => { console.log('reconnected: ', data); }); // Connection closed. If unexpected, expect reconnect -> reconnected. client.on('close', (data) => { console.error('close: ', data); }); // Reply to a request, e.g. "subscribe"/"unsubscribe"/"authenticate" client.on('response', (data) => { console.info('response: ', data); // throw new Error('res?'); }); client.on('exception', (data) => { console.error('exception: ', { msg: data.msg, errno: data.errno, code: data.code, syscall: data.syscall, hostname: data.hostname, }); }); try { // Optional: await a connection to be ready before subscribing (this is not necessary) // await client.connect('futuresPublicV1'); /** * Examples for public futures websocket topics (that don't require authentication). * * These should all subscribe via the "futuresPublicV1" wsKey. For detailed usage, refer to the ws-spot-public.ts example. */ client.subscribe( [ '/contractMarket/tickerV2:XBTUSDM', '/contractMarket/ticker:XBTUSDM', '/contractMarket/level2:XBTUSDM', '/contractMarket/execution:XBTUSDM', '/contractMarket/level2Depth5:XBTUSDM', '/contractMarket/level2Depth50:XBTUSDM', '/contractMarket/limitCandle:XBTUSDTM_1hour', '/contract/instrument:XBTUSDM', '/contract/announcement', '/contractMarket/snapshot:XBTUSDM', ], 'futuresPublicV1', ); } catch (e) { console.error('Subscribe exception: ', e); }} start();