FX quotes

Create a quote for the exact amount and currency the beneficiary should receive with POST /v2/transfers/international-wire/fx-quotes. This create request requires X-Idempotency-Key.

{
  "fromAccount": "subaccount_operations123",
  "amount": { "amount": 10000, "currency": "GBP" }
}

An available quote includes the estimated USD debit, effective exchange rate, and authoritative expiration. estimatedDebit.amount is USD cents. exchangeRate is the foreign-currency units received per USD, including the FX fee:

{
  "id": "fx_rate_quote_123",
  "status": "available",
  "amount": { "amount": 10000, "currency": "GBP" },
  "estimatedDebit": { "amount": 12734, "currency": "USD" },
  "exchangeRate": "0.7853",
  "createdAt": "2026-08-18T01:00:00.000Z",
  "expiresAt": "2026-08-18T01:15:00.000Z",
  "updatedAt": "2026-08-18T01:00:00.000Z"
}

Pass id as internationalWire.fxQuoteId before expiresAt. The wire must use the quote’s exact amount; changing either the amount or currency requires a new quote. An expired or already-used quote cannot price another wire. Retrieve the current quote with GET /v2/transfers/international-wire/fx-quotes/{fxQuoteId}. USD international wires do not use FX quotes.

Get started

Concepts

Money movement

Webhooks

Reference