FX quotes

FX quotes provide a priced and time-limited conversion proposal.

Two quote styles

Stateless quote (POST /v1/fx/quotes) is indicative — useful for display:

JSON

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "from_currency": "EUR",
  "from_amount": "100000.00",
  "to_currency": "USD",
  "to_amount": "108420.00",
  "rate": "1.0842",
  "spread_bps": 25,
  "source": "sandbox-static",
  "issued_at": "2026-06-01T09:00:00Z",
  "expires_at": "2026-06-01T09:15:00Z"
}

Persisted quote (POST /v1/fx/quote) returns a quote_id you lock and then execute with POST /v1/fx/execute before it expires (~30s):

JSON

{
  "quote_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "from_currency": "EUR",
  "from_amount": "100000.00",
  "to_currency": "USD",
  "to_amount": "108420.00",
  "rate": "1.0842",
  "fee": "120.00",
  "fee_currency": "EUR",
  "expires_at": "2026-06-01T09:00:30Z",
  "expires_in_seconds": 30
}

A persisted quote is short-lived: once expires_in_seconds elapses it can no longer be executed and you must request a new one. See the FX API for the full request/response and execution flow.

Amount direction

Quotes are requested by from_amount (the amount you sell). The engine returns the resulting to_amount for the target currency.

Quote expiry handling

If a quote expires before payment creation, request a new quote. If a quote expires during a partner review, CashXChain may require confirmation or issue an updated quote depending on account settings.

Corridor availability

Not every currency pair or country pair is available in every environment. The API returns clear errors when a corridor is not enabled.