Skip to main content
Create a Quote
Use este endpoint para bloquear uma taxa de câmbio antes de criar uma transferência. As cotações (quote) fornecem ao cliente uma taxa de conversão determinística de origem para destino, válida por uma janela fixa (30, 60 ou 300 segundos). A cotação captura o valor de origem, valor de destino, taxa de câmbio e detalhamento completo de taxas (integrador + plataforma) no momento da emissão. Uma cotação pode ser resgatada exatamente uma vez, passando seu ID ao chamar Criar Transferência.
As cotações são mais úteis para trading e pagamentos cross-border onde o cliente precisa ver a taxa exata que receberá antes de confirmar a transferência. Para transferências com taxa flutuante (ex.: folha de pagamento, rebalanceamento de tesouraria), ignore a cotação e chame /v2/transfer diretamente.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Corpo

application/json
amount
string
obrigatório

The quote amount. For MXN/USD RFQ it is denominated by referenceSide; all other corridors retain their existing source-amount behavior.

Pattern: ^\d+(\.\d{2})?$
Exemplo:

"100.00"

customerId
string
obrigatório

The customer's ID.

Pattern: ^customer_[a-z0-9]+$
Exemplo:

"customer_3faa484998f44cfead9668608b9ee1f5"

destination
object
obrigatório

The destination currency and network for the quote.

source
object
obrigatório

The source currency and network for the quote.

integratorBpsFeeRate
string

The integrator BPS fee rate. The BPS rate must be an integer string between 0 and 10000.

Pattern: ^\d+$
Exemplo:

"20"

quoteDurationSeconds
number

For MXN/SPEI to USD/wire or USD/swift quotes, the field may be omitted or must be 45; omission defaults to 45. For all other supported routes, explicit values must be 30, 60, or 300 seconds and omission defaults to 60.

Exemplo:

60

referenceSide
enum<string>

MXN/USD RFQ only. The side denominating amount; defaults to source when omitted.

Opções disponíveis:
source,
destination
Exemplo:

"source"

Resposta

created
string<date-time>
obrigatório

The datetime the quote was created.

Exemplo:

"2025-01-01T00:00:00.000Z"

customerId
string
obrigatório

The customer ID.

Exemplo:

"customer_d243ab2b1de4447d8a046d87fefe58cf"

destination
object
obrigatório
expiresAt
string<date-time>
obrigatório

The datetime when this quote expires.

Exemplo:

"2025-01-01T00:01:00.000Z"

fees
object
obrigatório
id
string
obrigatório

A unique identifier for the quote.

Pattern: ^quote_[a-z0-9]+$
Exemplo:

"quote_d243ab2b1de4447d8a046d87fefe58cf"

source
object
obrigatório
type
enum<string>
obrigatório

The transfer type this quote is for.

Opções disponíveis:
on_ramp,
off_ramp,
fiat_to_fiat
Exemplo:

"off_ramp"

quoteDurationSeconds
integer

RFQ-only quote duration in seconds.

Intervalo obrigatório: x > 0
Exemplo:

45

referenceSide
enum<string>

RFQ-only side whose amount was referenced for pricing.

Opções disponíveis:
source,
destination
Exemplo:

"source"

status
enum<string>

The current status of the quote.

Opções disponíveis:
active,
used,
expired
Exemplo:

"active"

Última modificação em 22 de junho de 2026