Exchange

Webhook events will be triggered whenever an FX order is created or its status is updated.

Event Category:

MULTI_CURRENCY_ACCOUNT

Event Type:

MULTI_CURRENCY_ACCOUNT.EXCHANGE.CREATE
MULTI_CURRENCY_ACCOUNT.EXCHANGE.UPDATE

Example webhook event

The data object is expected to have the same structure as the response from the the Retrieve an FX order endpoint.

{
  eventId: 'evt_19571582b0d40732e9',
  eventCategory: 'MULTI_CURRENCY_ACCOUNT',
  eventType: 'MULTI_CURRENCY_ACCOUNT.EXCHANGE.UPDATE',
  eventAction: 'UPDATE',
  data: {
    id: 'df7a46b2-0902-47b2-a901-c1ec3842d19e',
    rate: 0.918105,
    source: { 
      amount: 108.92000370328013, 
      currency: 'USD' 
    },
    status: 'COMPLETED',
    userId: '42c784f4-eb84-4e87-b0de-8c2183aed67c',
    createdAt: '2025-03-07T16:02:34.968768+00:00',
    reference: null,
    requestId: '7b87bf7f-4eae-455e-a211-e6039662b67c',
    updatedAt: '2025-03-07T16:02:38.129+00:00',
    destination: { 
      amount: 100, 
      currency: 'EUR' 
    },
    failedReason: null
  },
  createdAt: '2025-03-07T16:02:38.584Z',
  timestamp: '2025-03-07T16:02:40.576Z',
  version: 'v2'
}