Trade settled

{ "id": "evt_1cKvQ2FnRxDT9BpUcaLK5", "type": "trades", "eventType": "fx.trade.settled", "createdAt": "2026-04-28T09:00:00.618Z", "data": { "object": "trade", "id": "tde_8mK3vQ2FnRxDT9BpUcaLK5", "quoteId": "qte_9NpXvB2LmRtQ7FnKcWzE3D", "buyCurrency": "USD", "sellCurrency": "EUR", "sellAmount": "1000.00", "executedAmount": "999.80", "status": "EXECUTED", "clientReferenceId": "order-123", "tradeSettlementMode": "MANUAL", "createdAt": "2026-04-28T08:00:00.000Z", "settlementWindow": "T1", "settlementStartTime": "2026-04-28T08:32:50.000Z", "settledAt": "2026-04-28T09:00:00.000Z" } }

Headers

X-OpenFX-Signature

string

required

t=<unix-timestamp>,v1=<hex-hmac>: a hex-encoded HMAC-SHA256 signature computed over {timestamp}.{raw_body} (the exact bytes sent, not a re-serialized copy) using your webhook signing secret. Reject if t is more than 300 seconds from now, then verify v1 with a constant-time compare. See Webhook authentication.

Example:

"t=1735689600,v1=5257a869e7bfbe00e0be2007c1b7be16bb2ba57ee233b0d0c4de5d83b3f5e01d"

X-OpenFX-Webhook-Version

string

required

Webhook payload contract version, currently v3. Lets a receiver branch on the envelope version across future changes. See Webhooks.

Example:

"v3"

Body

application/json

Webhook delivery envelope for trade status changes (fx.trade.ready_to_settle, fx.trade.settled, fx.trade.reversed). Matches the Deposit/Withdrawal envelope shape exactly. See Trade webhooks.

string

required

Webhook delivery identifier. The deduplication key for this event family; a single event may be delivered more than once on retries.

Pattern: ^evt_[1-9A-HJ-NP-Za-km-z]{1,22}$

Example:

"evt_9mK3vQ2FnRxDT9BpUcaLK5"

type

string

required

Resource noun naming the event subject. Always trades for trade events.

Example:

"trades"

eventType

enum<string>

required

Dot-namespaced, product-prefixed event name ({product}.{resource}.{action}).

Available options:

fx.trade.ready_to_settle,

fx.trade.settled,

fx.trade.reversed

createdAt

string<date-time>

required

RFC 3339 UTC timestamp at which OpenFX built and dispatched this delivery.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$

Example:

"2026-04-28T10:00:00.000Z"

data

object

required

The trade in its current state. See Trade webhooks.

Show child attributes

Response

200

Return any 2xx to acknowledge receipt. A non-2xx response or a timeout causes OpenFX to retry on its published delivery schedule.

Core concepts

Endpoints

Webhooks

Headers

Body

Response