Skip to main content
Create a Quote
Usa este endpoint para bloquear una tasa de cambio antes de crear una transferencia. Las cotizaciones (quote) le dan al cliente una tasa de conversión determinista de origen a destino que es válida por una ventana fija (30, 60 o 300 segundos). La cotización captura el monto de origen, el monto de destino, la tasa de cambio y el desglose completo de comisiones (integrador + plataforma) en el momento de su emisión. Una cotización puede ser canjeada exactamente una vez pasando su ID al llamar a Crear Transferencia.
Las cotizaciones son más útiles para trading y pagos transfronterizos donde el cliente necesita ver la tasa exacta que recibirá antes de confirmar la transferencia. Para transferencias con tasa flotante (p. ej. nómina, rebalanceo de tesorería), omite la cotización y llama a /v2/transfer directamente.

Autorizaciones

Authorization
string
header
requerido

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

Cuerpo

application/json
amount
string
requerido

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})?$
Ejemplo:

"100.00"

customerId
string
requerido

The customer's ID.

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

"customer_3faa484998f44cfead9668608b9ee1f5"

destination
object
requerido

The destination currency and network for the quote.

source
object
requerido

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+$
Ejemplo:

"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.

Ejemplo:

60

referenceSide
enum<string>

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

Opciones disponibles:
source,
destination
Ejemplo:

"source"

Respuesta

created
string<date-time>
requerido

The datetime the quote was created.

Ejemplo:

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

customerId
string
requerido

The customer ID.

Ejemplo:

"customer_d243ab2b1de4447d8a046d87fefe58cf"

destination
object
requerido
expiresAt
string<date-time>
requerido

The datetime when this quote expires.

Ejemplo:

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

fees
object
requerido
id
string
requerido

A unique identifier for the quote.

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

"quote_d243ab2b1de4447d8a046d87fefe58cf"

source
object
requerido
type
enum<string>
requerido

The transfer type this quote is for.

Opciones disponibles:
on_ramp,
off_ramp,
fiat_to_fiat
Ejemplo:

"off_ramp"

quoteDurationSeconds
integer

RFQ-only quote duration in seconds.

Rango requerido: x > 0
Ejemplo:

45

referenceSide
enum<string>

RFQ-only side whose amount was referenced for pricing.

Opciones disponibles:
source,
destination
Ejemplo:

"source"

status
enum<string>

The current status of the quote.

Opciones disponibles:
active,
used,
expired
Ejemplo:

"active"

Última modificación el 22 de junio de 2026