Cotações

Cotações públicas ajudam o pagador a entender uma conversão. Não são uma promessa de liquidação nem incluem automaticamente tarifas da operadora.

Consultar

GET /v1/quotes?asset=USDT

{
  "data": {
    "asset": "USDT",
    "priceBrl": "5.48000000",
    "source": "Coinbase",
    "asOf": "2026-11-04T12:00:00.000Z",
    "expiresAt": "2026-11-04T12:00:30.000Z",
    "indicative": true
  }
}

O exemplo é ilustrativo. Valores vêm de uma consulta real quando o endpoint é chamado.

Contingência e validade

A busca tenta Coinbase, Binance e CoinGecko, nessa ordem. Cada origem tem timeout; falhas passam à próxima. O cache dura 30 segundos e requisições simultâneas compartilham a mesma busca. Não há retorno silencioso de um preço expirado.

Se todas falharem, a API responde 503 QUOTE_UNAVAILABLE. A interface mostra indisponibilidade e permite atualizar. A validade não obriga que uma fonte pública publique uma nova negociação a cada 30 segundos.

Decisão financeira

priceBrl é string decimal. Use aritmética decimal no backend. A cotação exibida não autoriza creditar saldo; o valor liquidado precisa vir de confirmação verificada da operadora quando a produção for habilitada.

Referência da futura cotação da operadora: 4P Finance — Cotação.