---
title: "Cotar um Pix pago com USDT"
method: POST
path: "/carteira-usdt/quote"
tags: ["Carteira USDT"]
---

# Cotar um Pix pago com USDT

`POST /carteira-usdt/quote`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/carteira-usdt/quote`
- Auth: API key in header `X-API-Key`

Prévia sem efeito: quanto USDT sai para pagar o Pix. Pix mínimo em min_payment_brl.

## Request body

- object
  - `brl_amount` string: Valor que o recebedor recebe, em reais. Use OU brl_amount (com pix_key) OU br_code.
  - `br_code` string: Pix Copia e Cola (começa com 000201). O valor e o recebedor vêm do código; não envie brl_amount.
  - `funding_source` 'crypto_usdt': Opcional; só aceita crypto_usdt.

## Response `200`

OK

- CotacaoPixCarteira: Prévia de um Pix pago com USDT. Estimativa: ao confirmar, a cotação é refeita e reservamos até 1% a mais (a sobra volta).
  - `payment_method` 'pix_key' | 'br_code'
  - `brl_amount` string
  - `usdt_order` string: USDT convertidos para pagar o Pix.
  - `withdrawal_fee` string: Custo de envio.
  - `usdt_total` string: Total estimado debitado.
  - `usdt_reserved` string: Quanto fica reservado até o Pix concluir.
  - `quote_id` string: Só com br_code: envie em POST /carteira-usdt/payments para garantir que é o mesmo código.
  - `merchant_name` string, nullable
  - `pix_key` string, nullable
  - `pix_key_type` string, nullable
  - `expires_at` string, date-time
  - `note` string
  - `sandbox` boolean
  - `reserve_usd` string, nullable: Equivalente em USDT da reserva operacional de R$1, convertido na cotacao e ja incluido no total; nao somar novamente. Ordens antigas mantem seu valor original. / USDT equivalent of the BRL 1 operational reserve, converted at quote time and already included in the total; do not add it again. Existing orders retain their original value.
  - `reserve_brl` string, nullable: Reserva operacional fixa de R$1 nas novas ordens, ja incluida no total. Legado preserva a reserva original. / Fixed BRL 1 operational reserve on new orders, already included in the total; existing orders keep their original reserve.

## Other responses

- `400`: `valor_invalido`, `valor_abaixo_do_minimo` (min_brl), `br_code_invalido`, `campos_conflitantes`, `cotacao_recusada`, `funding_source_invalido`.
- `401`: Chave ausente ou inválida.
- `403`: `carteira_nao_liberada`: a carteira não está liberada para este projeto.
- `503`: `carteira_indisponivel` / `pagamentos_indisponiveis`: tente de novo em instantes (`acao: esperar`).

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)