Skip to main content
Update Quote Status
Faça manualmente a transição de uma cotação para fora do estado active. A maioria das transições de cotação acontece automaticamente — uma cotação se torna used quando resgatada por Criar Transferência, e se torna expired quando seu timestamp expiresAt passa. Use este endpoint quando precisar anular explicitamente uma cotação (ex.: cliente abandonou o fluxo) ou marcá-la como consumida por um sistema downstream que não resgata através de /v2/transfer.
Apenas cotações com status active podem ser atualizadas. Tentar atualizar uma cotação que já está used ou expired retorna um erro de validação 422.

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

id
string
obrigatório

The unique quote ID.

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

"quote_d243ab2b1de4447d8a046d87fefe58cf"

Corpo

application/json
status
enum<string>
obrigatório

The new status for the quote. Only active quotes can be updated.

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

"used"

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
status
enum<string>
obrigatório

The current status of the quote.

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

"active"

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"

updated
string<date-time>
obrigatório

The datetime the quote was last updated.

Exemplo:

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

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"

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