FX quotes

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

Quote object

{
  "id": "fxq_9Xc2...",
  "status": "active",
  "source_currency": "EUR",
  "target_currency": "USD",
  "source_amount": "100000.00",
  "target_amount": "108420.00",
  "rate": "1.0842",
  "pricing_type": "guaranteed",
  "expires_at": "2026-06-01T09:15:00Z",
  "route": {
    "type": "hybrid",
    "estimated_settlement": "same_day"
  },
  "fees": {
    "cashxchain": "700.00",
    "fx_spread": "200.00",
    "partner": "100.00"
  }
}

Quote status

Status	Meaning
active	Quote can be used.
expired	Quote expiry passed.
accepted	Quote was attached to a payment.
cancelled	Quote is no longer usable.
replaced	A newer quote should be used.

Source amount vs target amount

A quote can be source-fixed or target-fixed.

• Source-fixed: you know how much the sender pays.
• Target-fixed: you know how much the beneficiary should receive.

Target-fixed quotes may require more precise route and fee assumptions.

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.