Create a quote
Locks an FX rate for a short window. Required by every operation creation endpoint.
Authorizations
JWT bearer token. Include as Authorization: Bearer <token>. See the Authentication guide for how to obtain one.
Body
Quotes lock an FX rate (or a 1:1 spot for same-asset) for a short window and are required by the withdrawal, swap and deposit operation endpoints. A quote belongs to your customer, not to an account: any of your accounts can consume it, and it can be consumed by exactly one operation.
Provide exactly one of sourceAmountValue or targetAmountValue. Sending both, or neither, fails with EXACTLY_ONE_AMOUNT_MUST_BE_PROVIDED. A field the request does not define, such as accountId or sourceAmount, is ignored, so a request that names the amount with the wrong field fails the same way.
sourceAmountValue— fix the amount you'll spend; the destination side is computed.targetAmountValue— fix the amount the beneficiary receives; the source side is computed.
The amount must be greater than zero and at least 1.00, whichever field carries it.
Same-asset quotes (sourceAsset == targetAsset) are valid and return a 1:1 spot with zero spread.
ISO 4217 currency code or stablecoin ticker. The maximum decimal scale of an AmountValue paired with this asset depends on the asset:
Requests accept only these three assets. Any other asset fails with 400 INVALID_DATA (INVALID_ENUM).
BRL, USDT, USDC "BRL"
ISO 4217 currency code or stablecoin ticker. The maximum decimal scale of an AmountValue paired with this asset depends on the asset:
Requests accept only these three assets. Any other asset fails with 400 INVALID_DATA (INVALID_ENUM).
BRL, USDT, USDC "BRL"
Response
Quote created.
A quote that can be consumed by an operation. Expires after a short window, except a same-asset quote, which does not expire.