FX trade state change

{ "subscriptionId": "00000000-0000-4000-8000-000000000002", "notificationId": "11111111-1111-4111-8111-111111111102", "notificationType": "fx.trade", "notification": { "id": "22222222-2222-4222-8222-222222222202", "status": "pending_settlement", "updateDate": "2026-08-25T19:08:53.306557Z" }, "timestamp": "2026-08-25T19:08:53.463485823Z", "version": 2 }

Body

application/json

The envelope every v2 webhook notification arrives in. The product-specific fields live in notification.

subscriptionId

string<uuid>

required

ID of the webhook subscription that produced this notification.

notificationId

string<uuid>

required

Unique ID for this event. Stable across retries of the same delivery, so use it to deduplicate.

notificationType

enum<string>

required

The type of notification.

Available options:

fx.trade

notification

any

required

The event payload. The schema of this object depends on notificationType.

timestamp

string<date-time>

required

When the notification was produced.

version

integer

required

The version of the notification schema. Always 2.

Response

200

Webhook received successfully

API overview

Custody API

Mint API

Cross-currency API

Reserve management API

Credit API

Digital Asset-Backed Borrowing

Webhook events

FX trade state change

Body

Response