Skip to main content

Overview

USDC → EUR payouts over SEPA and EUR → USDC deposits over SEPA Instant are priced from an indicative reference rate by default: the final amount is set when the funds arrive. When a rate lock is offered, you can hold a quote whose amounts are fixed. If the transfer is funded with the quoted amount before the lock expires, the quoted destination amount is what lands. A locked rate is priced from an independent mid-market reference. Each locked quote reports that reference as referenceRate, referenceRateAsOf and referenceProvider.

When a lock is offered

Request a quote as usual. lockable: true means you can hold the quote with a locked rate now. A lock is not always available. It depends on your configuration, the amount, the payment rail, current market conditions and available liquidity. When lockable is false, the quote stays indicative. Requesting a lock then returns 400 with the message Exchange rates cannot be locked for this corridor. The rate is indicative until the transfer executes., and nothing is held. A deposit lock needs the exact EUR amount you will send (sourceAmount), and cannot carry a fixed developer fee. A percentage developer fee is supported in both directions. Near the Sunday market reopen, a lock may not be offered if its funding window would run past the reopen.

Hold a locked quote

Request the quote with holdQuote: true, or quote a transfer intent with lock: true:
The response carries the lock:
exchangeRate is the all-in rate, in minor units, after the spread and any developer fee. referenceRate is the mid-market reference, in major units, that the lock was priced from.

Create the transfer

Create the transfer from the quote with confirm: true. A locked quote cannot be used for a draft. The deposit instructions must stay valid for at least four hours after rateLock.expiresAt. If you pass expiresAt on the transfer, it must be at or after that time; the default expiry already covers it. Each awaiting-deposit transfer with a lock must have a unique deposit amount on its deposit account. If another transfer on the same account is already waiting for the same amount, creation is rejected. Change the amount by one minor unit, or wait until the other transfer is funded or expires.

Fund before the lock expires

Send exactly rateLock.lockedSourceAmount before rateLock.expiresAt. Then rateLock.status moves from LOCKED to SETTLED, and rateLock.lockedDestinationAmount is what the recipient receives. Funds that arrive up to four hours after rateLock.expiresAt still get the locked rate, as long as the market has not moved past the lock limit since the quote. Otherwise the lock is voided as EXPIRED and the transfer settles at the market rate. Funds that arrive later than four hours after rateLock.expiresAt always settle at the market rate. Until the lock is settled or voided, rateLock.status stays LOCKED, even once rateLock.expiresAt has passed. If the lock cannot apply, rateLock.status becomes VOIDED, the transfer settles at the market rate, and rateLock.voidReason says why: Transfer responses and transfer webhooks carry the same rateLock object, so you can track it either way.