Crash Recovery Reconciliation Kit

What's Inside

A complete implementation of crash recovery reconciliation for trading bots in TypeScript—detect state drift on startup and fix it before resuming trading.

Files in This Package

The Problem This Solves

Your bot crashes. On restart:

• Did that last order go through? Unknown.
• Place it again? Maybe double your position.
• Skip it? Maybe miss the trade entirely.

Without reconciliation, you're guessing. Guessing destroys accounts.

What the Reconciliation Loop Does

1. Detects orphan orders — Orders on exchange that you don't have locally
2. Removes ghost orders — Orders you think exist but never reached the exchange
3. Backfills stale fills — Fills that happened while you were down
4. Verifies position — Final truth check against exchange

Key Features

• Type-safe — Full TypeScript types for orders, positions, state
• Error handling — Timeout protection, rate limit retry, exchange-down detection
• Periodic mode — Light-weight version for runtime drift detection
• Configurable — Adopt vs. cancel orphans, drift thresholds, timeouts

Integration

Uses ccxt-style exchange interface. Implement three methods:

• fetchOpenOrders(symbol)
• fetchOrder(clientOrderId)
• fetchPosition(symbol)

Works with Binance, Bybit, OKX, and any ccxt-compatible exchange.

Related Posts

• Crash Recovery: Reconciliation Loops That Prevent Double Orders
• Idempotency Keys for Exchange APIs