> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noxpay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar Conversão

> GET /v2/rfq/{id} — retorna o estado atual e os atributos de uma conversão.

## Parâmetros de path

| Parâmetro | Descrição                                                                        |
| --------- | -------------------------------------------------------------------------------- |
| `id`      | O `rfq_id` retornado por [Criar Conversão](/pt/api-reference/conversions/create) |

<Warning>
  **Este GET tem efeito colateral.** Antes de ler, uma cotação expirada que ainda esteja dentro da janela de `renewable_up_to` é renovada — com taxas novas. Duas leituras consecutivas do mesmo `rfq_id` podem legitimamente devolver valores diferentes para `rate_d0` / `rate_d1` e para os montantes derivados deles. Leia a conversão uma vez, aja sobre aquele retrato, e não assuma que a leitura é idempotente.
</Warning>

## Response `200 OK`

Devolve o envelope padrão do [Objeto de Transação](/pt/api-reference/reference/transaction-object). Acompanhe o progresso por `status` e `substatus`; veja [Status de conversões](/pt/api-reference/reference/statuses#conversions) para o conjunto completo de valores.

### Atributos — a cotação

Presentes desde a criação.

| Campo               | Tipo   | Descrição                                                                                                                                           |
| ------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `from_currency`     | string | Moeda de origem                                                                                                                                     |
| `to_currency`       | string | Moeda de destino                                                                                                                                    |
| `quote_pair`        | string | Par de cotação, no formato `<nome exibido da origem>/<nome exibido do destino>` — nomes exibidos, não códigos de moeda (ex: `USDT (TRX)/BRL (PIX)`) |
| `from_amount_d0`    | float  | Montante D0 a enviar                                                                                                                                |
| `to_amount_d0`      | float  | Montante D0 a receber                                                                                                                               |
| `rate_d0`           | float  | Taxa D0                                                                                                                                             |
| `fee_d0`            | float  | Tarifa que se aplica caso você aceite D0                                                                                                            |
| `from_amount_d1`    | float  | Montante D1 a enviar                                                                                                                                |
| `to_amount_d1`      | float  | Montante D1 a receber                                                                                                                               |
| `rate_d1`           | float  | Taxa D1                                                                                                                                             |
| `fee_d1`            | float  | Tarifa que se aplica caso você aceite D1                                                                                                            |
| `settlement_eta_d0` | string | ETA de liquidação D0 (RFC 3339)                                                                                                                     |
| `settlement_eta_d1` | string | ETA de liquidação D1 (RFC 3339)                                                                                                                     |
| `expires_at`        | string | Quando a taxa atual expira (RFC 3339)                                                                                                               |
| `renewable_up_to`   | string | Último momento em que a cotação pode ser renovada, em vez de recriada (RFC 3339)                                                                    |
| `d0_available`      | string | Se a mesa está aberta para liquidação no mesmo dia                                                                                                  |
| `webhook`           | string | URL de webhook configurada                                                                                                                          |

### Atributos — depois do aceite

**Estas chaves são ausentes até você aceitar**, e é essa ausência que diz que nenhuma decisão foi tomada ainda. Verifique a presença da chave, não se o valor é zero.

| Campo            | Tipo   | Descrição                                                             |
| ---------------- | ------ | --------------------------------------------------------------------- |
| `settlement_day` | string | `d0` ou `d1` — a janela que você escolheu                             |
| `amount_from`    | float  | Montante confirmado enviado                                           |
| `amount_to`      | float  | Montante confirmado recebido                                          |
| `rate`           | float  | Taxa confirmada                                                       |
| `fee_applied`    | float  | A tarifa efetivamente cobrada                                         |
| `settlement_eta` | string | ETA de liquidação confirmada (RFC 3339)                               |
| `wallet_id`      | string | Wallet de destino, em pagamento em cripto                             |
| `pix_key`        | string | Chave Pix de destino, em pagamento em BRL                             |
| `amount_brl`     | float  | Grandeza em BRL da operação aceita — o número que consumiu o seu teto |

<Note>
  `fee_d0` e `fee_d1` continuam visíveis depois do aceite, ao lado de `fee_applied`. As tarifas candidatas não são suprimidas depois da escolha — leia `fee_applied` para saber o que foi efetivamente cobrado.
</Note>

### Atributos — recusas e tetos

Presentes apenas quando aplicável.

| Campo                    | Tipo   | Descrição                                                                                                                                                   |
| ------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `error_detail`           | string | Explicação da recusa ou falha, orientada ao cliente                                                                                                         |
| `limit_block_source`     | string | Qual portão barrou a operação: `operational` para o teto da mesa, `compliance` para a escada de KYB. **Ausente quando a recusa foi por saldo insuficiente** |
| `payout_limit_currency`  | string | Moeda em que o teto de pagamento é denominado                                                                                                               |
| `payout_limit_available` | float  | Folga restante no teto de pagamento                                                                                                                         |
| `payout_limit_projected` | float  | Folga no teto de pagamento após esta operação                                                                                                               |

Os campos `payout_limit_*` são informativos — o eixo de pagamento não é aplicado neste endpoint.

Qualquer atributo de valor vazio é omitido por completo, em vez de vir como `""` ou `null`.

## Códigos de retorno

| HTTP  | Quando                                                                  |
| ----- | ----------------------------------------------------------------------- |
| `200` | Encontrado                                                              |
| `401` | `api-key` ausente ou inválida                                           |
| `404` | Não existe, ou pertence a outra conta — deliberadamente indistinguíveis |
| `500` | Erro interno                                                            |

`401`, `404` e `500` são devolvidos apenas como linha de status, sem corpo.

<RequestExample>
  ```bash cURL theme={null}
  curl https://checkout.noxpay.io/v2/rfq/NOXabc123 \
    -H "api-key: <key>"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://checkout.noxpay.io/v2/rfq/NOXabc123",
      headers={"api-key": "<key>"},
  )
  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://checkout.noxpay.io/v2/rfq/NOXabc123",
    { headers: { "api-key": "<key>" } }
  );
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "version": "v2",
    "end2end": "NOXabc123",
    "created_at": "2026-07-01T12:00:00Z",
    "updated_at": "2026-07-01T12:00:31Z",
    "process": "otc_settlement.awaiting",
    "status": { "en": "Processing", "pt": "Processando", "es": "Procesando" },
    "substatus": { "en": "OTC Delivery Scheduled", "pt": "Entrega OTC Agendada", "es": "Entrega OTC Programada" },
    "message": { "en": "Trade locked; awaiting the settlement window", "pt": "Operação travada; aguardando a janela de liquidação", "es": "Operación fijada; esperando la ventana de liquidación" },
    "error_message": { "en": "", "pt": "", "es": "" },
    "attributes": {
      "from_currency": "TRX_USDT_S2UZ",
      "to_currency": "BRL",
      "quote_pair": "USDT (TRX)/BRL (PIX)",
      "from_amount_d0": 1000.0,
      "to_amount_d0": 5050.0,
      "rate_d0": 5.050,
      "fee_d0": 12.5,
      "from_amount_d1": 1000.0,
      "to_amount_d1": 5060.0,
      "rate_d1": 5.060,
      "fee_d1": 10.0,
      "settlement_eta_d0": "2026-07-01T19:00:00Z",
      "settlement_eta_d1": "2026-07-02T18:00:00Z",
      "expires_at": "2026-07-01T12:00:30Z",
      "renewable_up_to": "2026-07-01T12:10:00Z",
      "d0_available": "true",
      "settlement_day": "d0",
      "amount_from": 1000.0,
      "amount_to": 5050.0,
      "rate": 5.050,
      "fee_applied": 12.5,
      "settlement_eta": "2026-07-01T19:00:00Z",
      "amount_brl": 5050.0,
      "wallet_id": "...",
      "webhook": "https://seuapp.com/webhooks/nox"
    }
  }
  ```
</ResponseExample>
