Skip to content

feat: forced-liquidation stream (!forceOrder@arr) → crypto.liquidations - #1

Open
JamesPersonalCode56 wants to merge 1 commit into
mainfrom
feat/liquidations
Open

feat: forced-liquidation stream (!forceOrder@arr) → crypto.liquidations#1
JamesPersonalCode56 wants to merge 1 commit into
mainfrom
feat/liquidations

Conversation

@JamesPersonalCode56

Copy link
Copy Markdown
Owner

Adds the all-market Binance futures forced-liquidation feed — a leading signal that liquidation cascades lead/amplify spot moves — which the collector was missing.

What

  • crypto.liquidations table (ReplacingMergeTree, tuned CODECs)
  • live/parsers.pyliquidation_rows() (SELL = a long was force-closed, BUY = a short)
  • live/main.py_run_liquidations process, futures-only, --no-liquidations flag
  • README updated (table list, live sources, process architecture, flags)

Routing gotcha (verified live)

!forceOrder@arr is delivered only on the /market route — the Public route returns 0 frames, exactly like @aggTrade. One connection covers the whole market (~1–2 events/s), so it intentionally ignores the per-symbol universe: cross-symbol cascades are themselves the signal.

Verification

End-to-end against live Binance: frames parse, decimal/timestamp fields correct, row width matches LIQUIDATIONS_COLS (16). Not yet run against the production ClickHouse (needs migrate.py on the box).

🤖 Generated with Claude Code

…uidations

Adds the all-market futures liquidation feed — a leading signal (cascades lead/
amplify spot moves) that was missing from the collector. One WS connection on the
/market route covers the whole market (~1-2 events/s); the Public route delivers
nothing for this stream (same routing gotcha as @aggTrade, verified live).

- tables.py: crypto.liquidations DDL (ReplacingMergeTree, tuned CODECs) + cols
- live/parsers.py: liquidation_rows() (SELL=long liquidated, BUY=short liquidated)
- live/main.py: _run_liquidations process, futures-only, --no-liquidations flag
- README: table list, live sources, process arch, flags

Verified end-to-end against live Binance: frames parse, row width matches schema.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant