Skip to main content
POST
Receive Trade Update

Body

application/json

Request model for POST /api/internal/execution/trade-update.

Guarantees Decimal parsing for prices/quantities (QR-I1). Dedup key computed by Go, validated as 64-char hex (SEC-6c).

user_id
string
required
Pattern: ^[0-9a-f-]{36}$
event_type
string
required
Pattern: ^(fill|partial_fill|canceled|rejected|expired|replaced|order_cancel_rejected|done_for_day)$
order_id
string
required
Maximum string length: 64
Pattern: ^[a-f0-9-]+$
dedup_key
string
required
Pattern: ^[0-9a-f]{64}$
client_order_id
string | null
Maximum string length: 64
filled_qty
filled_avg_price
filled_at
string<date-time> | null
updated_at
string<date-time> | null
replaced_by
string | null
Maximum string length: 64
total_order_qty
fill_context
string
default:entry
Pattern: ^(entry|exit)$
source
string
default:websocket
Pattern: ^(websocket)$
received_at
string<date-time> | null

Response

Successful Response

{key}
string