Skip to main content
POST
Create Trade Context

Headers

Idempotency-Key
string
required
Required string length: 8 - 128

Body

application/json

Only exact producer identities cross this boundary; no order intent is accepted.

event_ref
EventRef · object
required
chart_session_ref
ExactRef · object
required
contract_version
string
default:1
Allowed value: "1"

Response

Successful Response

contract_version
string
required
Allowed value: "trade-context-v1"
context_id
string
required
revision
integer
required
Required range: x >= 1
execution_effect
string
required
Allowed value: "none"
event_ref
EventRef · object
required
setup
TradeContextSetup · object
required
chart
TradeContextChart · object
required
captured_at
string<date-time>
required
provenance
TradeContextProvenance · object
required
content_hash
string
required
Pattern: ^[0-9a-f]{64}$
revision_hash
string
required
Pattern: ^[0-9a-f]{64}$
replayed
boolean
required
lens_ref
ExactRef · object | null
previous_hash
string | null
Pattern: ^[0-9a-f]{64}$