Kraken WS v2 book channel does not send deletes for levels evicted from its top-N window; without client-side truncation those levels lingered forever as phantom quotes, eventually crossing the local book (bid >= ask) and feeding the engine a fake permanent arbitrage (~$62.9M bogus P&L). - BookSide.truncate() removes levels beyond the best depth prices from the internal map (not just the emitted array) - KrakenConnector uses depth 10 consistently (subscription + LocalBook) and truncates both sides after every update - ExchangeConnector.emit() drops internally crossed books, logs and forces a resync (book reset + reconnect for a fresh snapshot) - Unit tests for truncation and the crossed-book guard - OpenSpec: order-book-integrity spec; change archived (2026-07-19) Refs: Linear WAY-77 Co-authored-by: Cursor <cursoragent@cursor.com>
67 lines
1.8 KiB
TypeScript
67 lines
1.8 KiB
TypeScript
import type { ExchangeId } from "../../domain/entities/index.js";
|
|
import { ExchangeConnector } from "./base.js";
|
|
|
|
interface KrakenLevel {
|
|
price: number;
|
|
qty: number;
|
|
}
|
|
|
|
interface KrakenBookData {
|
|
symbol: string;
|
|
bids: KrakenLevel[];
|
|
asks: KrakenLevel[];
|
|
timestamp?: string;
|
|
}
|
|
|
|
interface KrakenMessage {
|
|
channel?: string;
|
|
type?: "snapshot" | "update";
|
|
data?: KrakenBookData[];
|
|
}
|
|
|
|
const KRAKEN_BOOK_DEPTH = 10;
|
|
|
|
/**
|
|
* Kraken WebSocket v2 — `book` channel.
|
|
* Docs: https://docs.kraken.com/websockets-v2/
|
|
* Snapshot replaces the book; updates patch individual price levels (qty 0 = remove).
|
|
* Kraken does NOT send deletes for levels evicted from the top-N window: the
|
|
* client must truncate its local book to the subscribed depth after every
|
|
* update, or evicted levels linger forever as phantom quotes.
|
|
*/
|
|
export class KrakenConnector extends ExchangeConnector {
|
|
readonly id: ExchangeId = "kraken";
|
|
protected readonly url = "wss://ws.kraken.com/v2";
|
|
private readonly symbol = "BTC/USDT";
|
|
|
|
constructor() {
|
|
super(KRAKEN_BOOK_DEPTH);
|
|
}
|
|
|
|
protected subscribeMessage(): unknown {
|
|
return {
|
|
method: "subscribe",
|
|
params: { channel: "book", symbol: [this.symbol], depth: this.depth },
|
|
};
|
|
}
|
|
|
|
protected handleMessage(msg: unknown): void {
|
|
const m = msg as KrakenMessage;
|
|
if (m.channel !== "book" || !Array.isArray(m.data)) return;
|
|
|
|
const data = m.data[0];
|
|
if (!data) return;
|
|
|
|
if (m.type === "snapshot") {
|
|
this.book.reset();
|
|
}
|
|
|
|
for (const lvl of data.bids ?? []) this.book.bids.apply(lvl.price, lvl.qty);
|
|
for (const lvl of data.asks ?? []) this.book.asks.apply(lvl.price, lvl.qty);
|
|
this.book.truncate();
|
|
|
|
const exchangeTs = data.timestamp ? Date.parse(data.timestamp) : null;
|
|
this.emit(Number.isFinite(exchangeTs) ? exchangeTs : null);
|
|
}
|
|
}
|