On-demand FX

Convert funds on demand when moving liquidity across markets or preparing for payouts. Treasury Autopilot integrates FX conversion directly into the fund movement workflow — no separate FX system required.
Note: Treasury Autopilot focuses on transactional FX — converting funds as part of a transfer or payout. For advanced FX strategies (hedging, rate alerts, AI-powered optimization), refer to the Falcon FX module.

Key Benefits

  • Competitive rates: Access real-time FX rates with the ability to lock quotes.
  • Forward contracts: Lock rates today for future settlement dates, protecting against adverse rate movements.
  • Full lifecycle management: From quote to deal to settlement, manage the entire FX workflow through API.
  • Margin management: Forward deals include margin tracking with webhook notifications for margin charge events.

Sub-modules

Quote

Query live rates and create binding FX quotes before executing a conversion.

Forward Deal

Lock in an exchange rate today for settlement on a future date. Forward deals protect against adverse rate movements and are suitable for businesses with predictable future currency needs.
Deal lifecycle webhooks:
fx.deals.PROCESSING
→
fx.deals.SUCCESS
/
fx.deals.FAIL
/
fx.deals.CANCELED
Margin charge webhooks:
fx.deals.MARGIN_CHARGE_PENDING
→
fx.deals.MARGIN_CHARGE_SUCCESS
/
fx.deals.MARGIN_CHARGE_FAIL
/
fx.deals.MARGIN_CHARGE_OVERDUE
/
fx.deals.MARGIN_CLOSED_OUT
/
fx.deals.MARGIN_CANCELED

Settlement

Execute the actual currency conversion. For spot FX, settlement follows immediately after quoting. For forward deals, settlement is executed on the agreed value date.
Settlement webhooks:
fx.settlements.PROCESSING
→
fx.settlements.SUCCESS
/
fx.settlements.FAIL

Reference

Query supported currencies and trading calendar before initiating FX transactions.

Integration Notes

  1. Quote before settle. Always call Create a Quote
    API
     to lock a rate before calling Create a Settlement
    API
    . Quotes are time-bound — if expired, create a new one.
  1. Forward deals require margin. When creating a forward deal, margin may be required. Subscribe to
    fx.deals.MARGIN_CHARGE_
    webhooks to handle margin call events.
  1. Check the trading calendar for forward deals. Not all dates are valid settlement dates. Use Query Trading Calendar
    API
     to confirm available value dates before creating a forward deal.
  1. Cancellation is time-sensitive. Forward deals can be cancelled before they move to
    PROCESSING
    status. Once in
    PROCESSING
    , cancellation may not be possible.

Webhooks