Quote

A quote is a price snapshot. It locks the BRL → USDT rate at creation time for 15 minutes. It does not create a conversion, does not issue a Pix QR, does not reserve a limit. Quoting is cheap and disposable.

What the quote carries

id: stable quote identifier.
exchange_rate: the snapshotted BRL → USDT rate, considering the fee mode configured for your organization (see Fees).
source_amount and target_amount: BRL and USDT values implied by the rate.
expires_at: timestamp at which the quote stops being acceptable.

The exact response fields land in the API reference.

What the quote does not do

Issues no Pix QR. The QR is born only when you accept the quote. See Accepting the quote.
Reserves no limit. Reservation happens at accept.
Does not lock the end customer. The (user_id, transaction_type) lock is created on the conversion, not on the quote.
Cannot be modified. Quotes are immutable. If the rate changes before accept, create another quote.

15-minute TTL

The short window is deliberate: the integration is programmatic, and the quote captures the rate immediately before accept. If your UX needs more time between getting the rate and the end customer confirming, quote again at accept, do not try to extend the validity.

Don't poll quotes

A quote is disposable. Create one when you need a fresh rate to show the end customer or to accept immediately. Don't loop, don't store for reuse outside the 15-minute window.

Prerequisites for quoting

End customer with platform KYC approved.
On-chain destination address (destination_wallet_address) and declared network (destination_wallet_network).
Amount in BRL (source_amount) or USDT (target_amount).

Without all three, the call fails with a validation error.

Consumed quote

When you accept a quote, it transitions to consumed and gets linked to the conversion (consumed_by_conversion_id). You cannot accept the same quote twice.

Next steps

Conversion: where the quote is taken when you accept.
Creating a quote: the call walkthrough.