Repository navigation
Spec drift: kalshi — outcome_side/book_side replacing direction field (May 28 deadline) #514
Description
Summary
Kalshi added outcome_side and book_side fields to Order, Fill, and Trade objects on May 6 2026, and has officially deprecated direction. The direction field will be removed on May 28 2026. Our spec and normalizer still use direction.
Impact
CRITICAL — hard breaking deadline of May 28 2026. After that date, direction will not be present in any Order/Fill/Trade response and all order-direction logic will silently fail.
Details
- New fields:
outcome_side(string:"yes"|"no") andbook_side(string:"bid"|"ask") - Deprecated field:
direction(string:"buy"|"sell") — removal date May 28 2026 - Affected schemas: Order, Fill, Trade in
core/specs/kalshi.yaml - The semantic mapping:
direction: "buy"≈ buying Yes =outcome_side: "yes",book_side: "bid"
Required Fix
- Add
outcome_sideandbook_sideto the Order, Fill, and Trade schemas incore/specs/kalshi.yaml - Mark
directionas deprecated in the spec - Update the Kalshi normalizer to read
outcome_side/book_sidewith a fallback todirectionfor any in-flight responses - Remove the
directionfallback after May 28 2026 (or immediately if deploying post-deadline)
Activity
realfishsam commentedon Sep 4, 2026
Additional context from duplicate #1188: the
outcome_side/book_sidegap also applies specifically to the Fill schema, where the deprecated fields aresideandaction(notdirectionas stated above) with a May 14, 2026 removal deadline (earlier than the May 28 deadline cited here fordirection). Kalshi appears to use different legacy field names per object type (directionon Order,side+actionon Fill) that are all being consolidated into the sameoutcome_side/book_sidereplacement pair.Note: the companion Trade-schema drift (
taker_side→taker_outcome_side/taker_book_side/is_block_trade) was already tracked and fixed separately in #1187 (merged via #1282). This issue should be understood as still covering the Order and Fill schema portions of theoutcome_side/book_sidemigration.Generated by Claude Code