Skip to main content

FX API

The FX API provides quote-driven conversion workflows.

Create quote​

POST /v1/fx/quotes
{
  "source_currency": "EUR",
  "target_currency": "USD",
  "source_amount": "100000.00",
  "beneficiary_country": "US",
  "payment_method": "bank_transfer"
}

Quote response​

{
  "id": "fxq_9Xc2...",
  "source_currency": "EUR",
  "target_currency": "USD",
  "source_amount": "100000.00",
  "target_amount": "108420.00",
  "rate": "1.0842",
  "expires_at": "2026-06-01T09:15:00Z",
  "pricing_type": "guaranteed"
}

Retrieve quote​

GET /v1/fx/quotes/{quote_id}

Create conversion​

Some customers may convert balances without creating an external payment.

POST /v1/fx/conversions
{
  "quote_id": "fxq_9Xc2...",
  "source_wallet_id": "wlt_eur...",
  "target_wallet_id": "wlt_usd..."
}

Quote expiry​

If the quote is expired, the API returns quote_expired. Request a new quote and present updated pricing to the user.

Indicative quotes​

For some corridors, the API may return an indicative quote. Indicative quotes require confirmation before execution.