Execute an FX Exchange
Exchange a locked quote — debits the sell currency balance and credits
the buy currency balance. The quote must still be within its validity
window; expired quotes return quote_expired.
Rate-limited to 10 per minute per IP. Requires Idempotency-Key.
Authorizations
Per-request DPoP proof JWT (RFC 9449). MUST accompany the Authorization: DPoP <access_token> header on every protected operation. The proof is signed by the merchant's private DPoP key and carries htm, htu, iat, jti, and ath claims.
Headers
Unique key identifying this operation. Sending the same key twice returns the original response instead of creating a duplicate. Keys are retained for 24 hours.
255Body
ID of a quote previously created via POST /v1/fx/quote.
^fxq_[a-zA-Z0-9]+$Response
Exchange executed.
An executed currency exchange between two merchant balances.