FX Transaction Lifecycle

Each FX trade follows a defined lifecycle from execution to settlement. Understanding these stages helps you track and manage your trades effectively.

Transaction States

All FX trades follow a standard lifecycle with the following possible states:

1. Open: State for trades with future value dates or without immediate settlement
2. Settled: State for completed trades where funds have been debited and credited
3. Cancelled: State for cancelled trades (only applicable in specific scenarios)

State Transitions

The lifecycle progression depends on the settlement timing:

• Immediate Settlement (value date today):
  Settled -> (Cancelled, if applicable)

• Future Settlement (value date in future):
  Open -> Settled -> (Cancelled, if applicable)

Example Scenario

Consider a SPOT trade to buy 10,000 EUR against USD:

1. Immediately after execution: Status will be "Open" (settlement occurs in two banking days)
2. On/after settlement date: Status changes to "Settled" (funds are debited/credited to respective currency accounts)

Tracking FX Trades

Our API provides several endpoints to help you track and manage your FX trades throughout their lifecycle.

Trade History and Status

List All Trades

Query your trade history using one of these endpoints:

• JSON Format: GET /api/v2/fx/transactions

  Text

  GET /api/v2/fx/transactions?clientOrderId=YourUniqueReference
  

  Returns a JSON response with trade details including status, amounts, and settlement accounts.

• CSV Format: GET /api/v1/fx/reports/transactions
  Same data as above but in CSV format, useful for bulk analysis or reporting.

Single Trade Lookup

Get details of a specific trade:

• GET /api/v2/fx/transactions/{client-order-id}
  Returns detailed information about a single trade identified by your reference.

Active Trades and Rates

• GET /api/v2/fx/held-rates
  Lists all currently active held rates available for trading.

Settlement Information

• GET /api/v1/fx/calendar/settlement-dates
  Returns available settlement dates for FX trades, accounting for holidays and cut-off times.

• GET /api/v1/fx/settlement-accounts
  Lists accounts available for FX trading and settlement.

Risk Management

• GET /api/v1/fx/exposure/customer/{customer-id}
  Returns FX exposure information for a specific customer, including:
  • Trading line details
  • Collateral account information

Filtering Options

When querying trade history, many of the endpoints support filters to narrow down the results, such as:

• Date ranges
• Account information
• Currencies involved
• Transaction status

Refer to our API Reference section for a complete list of filtering criteria.

Note: Multicurrency Payments are tracked separately through payment endpoints, as they are considered payments rather than FX trades.