@newyorkcompute/kalshi-core 0.2.0 → 0.3.0

package/dist/websocket/client.js

@@ -0,0 +1,352 @@
+/**
+ * Kalshi WebSocket Client
+ *
+ * Provides real-time market data streaming from Kalshi.
+ * Features:
+ * - Automatic reconnection with exponential backoff
+ * - Subscription management
+ * - Event-based message handling
+ * - Connection health monitoring
+ */
+import WebSocket from 'ws';
+import { WS_ENDPOINTS, } from './types.js';
+import { generateWsAuthHeaders } from './auth.js';
+/** Default configuration values */
+const DEFAULTS = {
+    autoReconnect: true,
+    reconnectDelay: 1000,
+    maxReconnectAttempts: 10,
+    pingInterval: 30000, // 30 seconds
+    pongTimeout: 10000, // 10 seconds
+};
+/**
+ * Kalshi WebSocket Client
+ *
+ * @example
+ * ```typescript
+ * const client = new KalshiWsClient({
+ *   apiKeyId: 'your-api-key',
+ *   privateKey: 'your-private-key',
+ * });
+ *
+ * client.on('ticker', (data) => {
+ *   console.log('Price update:', data.market_ticker, data.yes_bid);
+ * });
+ *
+ * await client.connect();
+ * client.subscribe(['ticker'], ['KXBTC-25JAN03']);
+ * ```
+ */
+export class KalshiWsClient {
+    config;
+    ws = null;
+    handlers = {};
+    state = 'disconnected';
+    reconnectAttempts = 0;
+    commandId = 0;
+    pingTimer = null;
+    pongTimer = null;
+    subscriptions = {
+        orderbook_delta: new Set(),
+        ticker: new Set(),
+        trade: new Set(),
+        fill: false,
+    };
+    constructor(config) {
+        this.config = {
+            ...config,
+            demo: config.demo ?? false,
+            autoReconnect: config.autoReconnect ?? DEFAULTS.autoReconnect,
+            reconnectDelay: config.reconnectDelay ?? DEFAULTS.reconnectDelay,
+            maxReconnectAttempts: config.maxReconnectAttempts ?? DEFAULTS.maxReconnectAttempts,
+        };
+    }
+    // ===========================================================================
+    // Public API
+    // ===========================================================================
+    /**
+     * Get current connection state
+     */
+    get connectionState() {
+        return this.state;
+    }
+    /**
+     * Check if connected
+     */
+    get isConnected() {
+        return this.state === 'connected';
+    }
+    /**
+     * Register event handlers
+     */
+    on(event, handler) {
+        this.handlers[event] = handler;
+    }
+    /**
+     * Connect to WebSocket server
+     */
+    async connect() {
+        if (this.state === 'connected' || this.state === 'connecting') {
+            return;
+        }
+        this.state = 'connecting';
+        return new Promise((resolve, reject) => {
+            const endpoint = this.config.demo
+                ? WS_ENDPOINTS.demo
+                : WS_ENDPOINTS.production;
+            const headers = generateWsAuthHeaders(this.config.apiKeyId, this.config.privateKey);
+            this.ws = new WebSocket(endpoint, { headers });
+            this.ws.on('open', () => {
+                this.state = 'connected';
+                this.reconnectAttempts = 0;
+                this.startPingPong();
+                this.handlers.onConnect?.();
+                this.resubscribeAll();
+                resolve();
+            });
+            this.ws.on('message', (data) => {
+                this.handleMessage(data);
+            });
+            this.ws.on('close', (code, reason) => {
+                this.handleClose(code, reason.toString());
+            });
+            this.ws.on('error', (error) => {
+                this.handlers.onError?.(error);
+                if (this.state === 'connecting') {
+                    reject(error);
+                }
+            });
+            this.ws.on('pong', () => {
+                this.clearPongTimeout();
+            });
+        });
+    }
+    /**
+     * Disconnect from WebSocket server
+     */
+    disconnect() {
+        this.state = 'disconnected';
+        this.stopPingPong();
+        if (this.ws) {
+            this.ws.close(1000, 'Client disconnect');
+            this.ws = null;
+        }
+    }
+    /**
+     * Subscribe to channels for specific market tickers
+     *
+     * @param channels - Channels to subscribe to
+     * @param marketTickers - Market tickers (not needed for 'fill' channel)
+     */
+    subscribe(channels, marketTickers) {
+        if (!this.ws || this.state !== 'connected') {
+            // Store for later subscription when connected
+            this.updateLocalSubscriptions(channels, marketTickers, 'add');
+            return;
+        }
+        const command = {
+            id: ++this.commandId,
+            cmd: 'subscribe',
+            params: {
+                channels,
+                ...(marketTickers && { market_tickers: marketTickers }),
+            },
+        };
+        this.send(command);
+        this.updateLocalSubscriptions(channels, marketTickers, 'add');
+    }
+    /**
+     * Unsubscribe from channels
+     */
+    unsubscribe(channels, marketTickers) {
+        if (!this.ws || this.state !== 'connected') {
+            this.updateLocalSubscriptions(channels, marketTickers, 'remove');
+            return;
+        }
+        const command = {
+            id: ++this.commandId,
+            cmd: 'unsubscribe',
+            params: {
+                channels,
+                ...(marketTickers && { market_tickers: marketTickers }),
+            },
+        };
+        this.send(command);
+        this.updateLocalSubscriptions(channels, marketTickers, 'remove');
+    }
+    /**
+     * Add markets to existing subscription
+     */
+    addMarkets(channels, marketTickers) {
+        if (!this.ws || this.state !== 'connected') {
+            this.updateLocalSubscriptions(channels, marketTickers, 'add');
+            return;
+        }
+        const command = {
+            id: ++this.commandId,
+            cmd: 'update_subscription',
+            params: {
+                channels,
+                market_tickers: marketTickers,
+                action: 'add_markets',
+            },
+        };
+        this.send(command);
+        this.updateLocalSubscriptions(channels, marketTickers, 'add');
+    }
+    /**
+     * Remove markets from existing subscription
+     */
+    removeMarkets(channels, marketTickers) {
+        if (!this.ws || this.state !== 'connected') {
+            this.updateLocalSubscriptions(channels, marketTickers, 'remove');
+            return;
+        }
+        const command = {
+            id: ++this.commandId,
+            cmd: 'update_subscription',
+            params: {
+                channels,
+                market_tickers: marketTickers,
+                action: 'remove_markets',
+            },
+        };
+        this.send(command);
+        this.updateLocalSubscriptions(channels, marketTickers, 'remove');
+    }
+    /**
+     * Get currently subscribed tickers for a channel
+     */
+    getSubscribedTickers(channel) {
+        if (channel === 'fill')
+            return [];
+        return Array.from(this.subscriptions[channel]);
+    }
+    // ===========================================================================
+    // Private Methods
+    // ===========================================================================
+    send(data) {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(data));
+        }
+    }
+    handleMessage(data) {
+        try {
+            const message = JSON.parse(data.toString());
+            switch (message.type) {
+                case 'subscribed':
+                    this.handlers.onSubscribed?.(message.msg.channel, message.msg.market_tickers);
+                    break;
+                case 'error':
+                    this.handlers.onError?.(new Error(`WebSocket error ${message.msg.code}: ${message.msg.message}`));
+                    break;
+                case 'orderbook_delta':
+                    this.handlers.onOrderbookDelta?.(message.msg);
+                    break;
+                case 'ticker':
+                    this.handlers.onTicker?.(message.msg);
+                    break;
+                case 'trade':
+                    this.handlers.onTrade?.(message.msg);
+                    break;
+                case 'fill':
+                    this.handlers.onFill?.(message.msg);
+                    break;
+            }
+        }
+        catch (error) {
+            this.handlers.onError?.(error instanceof Error ? error : new Error('Failed to parse message'));
+        }
+    }
+    handleClose(code, reason) {
+        this.stopPingPong();
+        this.handlers.onDisconnect?.(code, reason);
+        if (this.config.autoReconnect &&
+            this.state !== 'disconnected' &&
+            this.reconnectAttempts < this.config.maxReconnectAttempts) {
+            this.scheduleReconnect();
+        }
+        else {
+            this.state = 'disconnected';
+        }
+    }
+    scheduleReconnect() {
+        this.state = 'reconnecting';
+        this.reconnectAttempts++;
+        // Exponential backoff
+        const delay = this.config.reconnectDelay * Math.pow(2, this.reconnectAttempts - 1);
+        setTimeout(() => {
+            if (this.state === 'reconnecting') {
+                this.connect().catch((error) => {
+                    this.handlers.onError?.(error);
+                });
+            }
+        }, delay);
+    }
+    resubscribeAll() {
+        // Resubscribe to all previously active subscriptions
+        const channels = [];
+        const tickers = [];
+        for (const [channel, data] of Object.entries(this.subscriptions)) {
+            if (channel === 'fill') {
+                if (data === true) {
+                    this.subscribe(['fill']);
+                }
+            }
+            else if (data instanceof Set && data.size > 0) {
+                channels.push(channel);
+                tickers.push(...data);
+            }
+        }
+        if (channels.length > 0 && tickers.length > 0) {
+            const uniqueTickers = [...new Set(tickers)];
+            this.subscribe(channels, uniqueTickers);
+        }
+    }
+    updateLocalSubscriptions(channels, tickers, action) {
+        for (const channel of channels) {
+            if (channel === 'fill') {
+                this.subscriptions.fill = action === 'add';
+            }
+            else if (tickers) {
+                for (const ticker of tickers) {
+                    if (action === 'add') {
+                        this.subscriptions[channel].add(ticker);
+                    }
+                    else {
+                        this.subscriptions[channel].delete(ticker);
+                    }
+                }
+            }
+        }
+    }
+    startPingPong() {
+        this.pingTimer = setInterval(() => {
+            if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+                this.ws.ping();
+                this.setPongTimeout();
+            }
+        }, DEFAULTS.pingInterval);
+    }
+    stopPingPong() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        this.clearPongTimeout();
+    }
+    setPongTimeout() {
+        this.pongTimer = setTimeout(() => {
+            // No pong received, connection might be dead
+            this.handlers.onError?.(new Error('Pong timeout - connection may be dead'));
+            this.ws?.terminate();
+        }, DEFAULTS.pongTimeout);
+    }
+    clearPongTimeout() {
+        if (this.pongTimer) {
+            clearTimeout(this.pongTimer);
+            this.pongTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/websocket/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/websocket/client.ts"],"names":[],"mappings":"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"}

package/dist/websocket/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Kalshi WebSocket Module
+ *
+ * Real-time market data streaming from Kalshi.
+ */
+export { KalshiWsClient } from './client.js';
+export { generateWsAuthHeaders, generateSignedWsUrl } from './auth.js';
+export { type KalshiWsConfig, type KalshiWsEventHandlers, type SubscriptionChannel, type ConnectionState, type ActiveSubscriptions, type OrderbookDeltaMessage, type TickerMessage, type TradeMessage, type FillMessage, type WsMessage, WS_ENDPOINTS, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/websocket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/websocket/index.js

@@ -0,0 +1,9 @@
+/**
+ * Kalshi WebSocket Module
+ *
+ * Real-time market data streaming from Kalshi.
+ */
+export { KalshiWsClient } from './client.js';
+export { generateWsAuthHeaders, generateSignedWsUrl } from './auth.js';
+export { WS_ENDPOINTS, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/websocket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAWL,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/websocket/types.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Kalshi WebSocket Types
+ *
+ * Message formats for Kalshi's WebSocket API
+ * Based on: https://docs.kalshi.com/websockets
+ */
+/** WebSocket connection configuration */
+export interface KalshiWsConfig {
+    /** API Key ID */
+    apiKeyId: string;
+    /** API Private Key (PEM format) */
+    privateKey: string;
+    /** Use demo environment (default: false) */
+    demo?: boolean;
+    /** Auto-reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Reconnect delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Max reconnect attempts (default: 10) */
+    maxReconnectAttempts?: number;
+}
+/** WebSocket endpoints */
+export declare const WS_ENDPOINTS: {
+    readonly production: "wss://api.elections.kalshi.com/trade-api/ws/v2";
+    readonly demo: "wss://demo-api.kalshi.co/trade-api/ws/v2";
+};
+/** Available subscription channels */
+export type SubscriptionChannel = 'orderbook_delta' | 'ticker' | 'trade' | 'fill';
+/** Subscription command */
+export interface SubscribeCommand {
+    id: number;
+    cmd: 'subscribe';
+    params: {
+        channels: SubscriptionChannel[];
+        market_tickers?: string[];
+    };
+}
+/** Unsubscribe command */
+export interface UnsubscribeCommand {
+    id: number;
+    cmd: 'unsubscribe';
+    params: {
+        channels: SubscriptionChannel[];
+        market_tickers?: string[];
+    };
+}
+/** Update subscription command */
+export interface UpdateSubscriptionCommand {
+    id: number;
+    cmd: 'update_subscription';
+    params: {
+        channels: SubscriptionChannel[];
+        market_tickers: string[];
+        action: 'add_markets' | 'remove_markets';
+    };
+}
+export type WsCommand = SubscribeCommand | UnsubscribeCommand | UpdateSubscriptionCommand;
+/** Base message structure */
+interface BaseMessage {
+    type: string;
+    sid?: number;
+}
+/** Subscription confirmation */
+export interface SubscribedMessage extends BaseMessage {
+    type: 'subscribed';
+    msg: {
+        channel: SubscriptionChannel;
+        market_tickers?: string[];
+    };
+}
+/** Error message */
+export interface ErrorMessage extends BaseMessage {
+    type: 'error';
+    msg: {
+        code: number;
+        message: string;
+    };
+}
+/** Orderbook delta update */
+export interface OrderbookDeltaMessage extends BaseMessage {
+    type: 'orderbook_delta';
+    msg: {
+        market_ticker: string;
+        price: number;
+        delta: number;
+        side: 'yes' | 'no';
+    };
+}
+/** Ticker update (market price change) */
+export interface TickerMessage extends BaseMessage {
+    type: 'ticker';
+    msg: {
+        market_ticker: string;
+        yes_bid: number;
+        yes_ask: number;
+        no_bid: number;
+        no_ask: number;
+        last_price: number;
+        volume: number;
+        open_interest: number;
+    };
+}
+/** Trade execution */
+export interface TradeMessage extends BaseMessage {
+    type: 'trade';
+    msg: {
+        market_ticker: string;
+        trade_id: string;
+        price: number;
+        count: number;
+        taker_side: 'yes' | 'no';
+        created_time: string;
+    };
+}
+/** User fill notification (authenticated) */
+export interface FillMessage extends BaseMessage {
+    type: 'fill';
+    msg: {
+        trade_id: string;
+        order_id: string;
+        market_ticker: string;
+        side: 'yes' | 'no';
+        action: 'buy' | 'sell';
+        count: number;
+        price: number;
+        created_time: string;
+    };
+}
+/** All possible server messages */
+export type WsMessage = SubscribedMessage | ErrorMessage | OrderbookDeltaMessage | TickerMessage | TradeMessage | FillMessage;
+/** WebSocket event handlers */
+export interface KalshiWsEventHandlers {
+    /** Called when connection is established */
+    onConnect?: () => void;
+    /** Called when connection is closed */
+    onDisconnect?: (code: number, reason: string) => void;
+    /** Called on any error */
+    onError?: (error: Error) => void;
+    /** Called when subscription is confirmed */
+    onSubscribed?: (channel: SubscriptionChannel, tickers?: string[]) => void;
+    /** Called on orderbook update */
+    onOrderbookDelta?: (data: OrderbookDeltaMessage['msg']) => void;
+    /** Called on ticker update */
+    onTicker?: (data: TickerMessage['msg']) => void;
+    /** Called on trade */
+    onTrade?: (data: TradeMessage['msg']) => void;
+    /** Called on fill (user's order filled) */
+    onFill?: (data: FillMessage['msg']) => void;
+}
+/** WebSocket connection state */
+export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+/** Active subscriptions */
+export interface ActiveSubscriptions {
+    orderbook_delta: Set<string>;
+    ticker: Set<string>;
+    trade: Set<string>;
+    fill: boolean;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/websocket/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/websocket/types.ts"],"names":[],"mappings":"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"}

package/dist/websocket/types.js

@@ -0,0 +1,12 @@
+/**
+ * Kalshi WebSocket Types
+ *
+ * Message formats for Kalshi's WebSocket API
+ * Based on: https://docs.kalshi.com/websockets
+ */
+/** WebSocket endpoints */
+export const WS_ENDPOINTS = {
+    production: 'wss://api.elections.kalshi.com/trade-api/ws/v2',
+    demo: 'wss://demo-api.kalshi.co/trade-api/ws/v2',
+};
+//# sourceMappingURL=types.js.map

package/dist/websocket/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/websocket/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,0BAA0B;AAC1B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU,EAAE,gDAAgD;IAC5D,IAAI,EAAE,0CAA0C;CACxC,CAAC"}

package/dist/websocket/types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.test.d.ts.map

package/dist/websocket/types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.d.ts","sourceRoot":"","sources":["../../src/websocket/types.test.ts"],"names":[],"mappings":""}

package/dist/websocket/types.test.js

@@ -0,0 +1,17 @@
+import { describe, it, expect } from 'vitest';
+import { WS_ENDPOINTS } from './types.js';
+describe('WebSocket Types', () => {
+    describe('WS_ENDPOINTS', () => {
+        it('has production endpoint', () => {
+            expect(WS_ENDPOINTS.production).toBe('wss://api.elections.kalshi.com/trade-api/ws/v2');
+        });
+        it('has demo endpoint', () => {
+            expect(WS_ENDPOINTS.demo).toBe('wss://demo-api.kalshi.co/trade-api/ws/v2');
+        });
+        it('endpoints use secure WebSocket protocol', () => {
+            expect(WS_ENDPOINTS.production.startsWith('wss://')).toBe(true);
+            expect(WS_ENDPOINTS.demo.startsWith('wss://')).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/websocket/types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.js","sourceRoot":"","sources":["../../src/websocket/types.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;YACjC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;YAC3B,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newyorkcompute/kalshi-core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Shared utilities for Kalshi prediction market tools — SDK configuration, formatting, and types",
   "author": "NewYorkCompute",
   "license": "MIT",
@@ -39,15 +39,19 @@
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "kalshi-typescript": "^3.3.0"
+    "kalshi-typescript": "^3.3.0",
+    "ws": "^8.18.0"
   },
   "devDependencies": {
+    "@eslint/js": "^9.28.0",
     "@types/node": "^22.15.29",
+    "@types/ws": "^8.5.13",
+    "@vitest/coverage-v8": "^3.2.4",
     "eslint": "^9.28.0",
-    "@eslint/js": "^9.28.0",
     "typescript-eslint": "^8.33.1",
     "vitest": "^3.2.3"
   }