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

# Cotação de Referência

> GET /v2/rfq/ref_quote — calcula uma taxa indicativa sem criar uma conversão.

Calcula uma cotação sem criar um processo de conversão. Útil para exibir taxas indicativas na sua interface antes que o usuário inicie uma conversão.

## Parâmetros de query

| Parâmetro       | Tipo   | Obrigatório | Descrição                                         |
| --------------- | ------ | ----------- | ------------------------------------------------- |
| `from_currency` | string | Sim         | Código da moeda de origem                         |
| `to_currency`   | string | Sim         | Código da moeda de destino                        |
| `from_amount`   | float  | Condicional | Montante de origem (omitir para cotação unitária) |
| `to_amount`     | float  | Condicional | Montante de destino                               |

Se nenhum montante for informado, a resposta retorna a taxa para 1 unidade de `from_currency`.

## Response `200 OK`

| Campo               | Tipo    | Descrição                                                                                               |
| ------------------- | ------- | ------------------------------------------------------------------------------------------------------- |
| `quote_pair`        | string  | Par de cotação (ex: `USDT_BRL`)                                                                         |
| `rate_d0`           | float   | Taxa D0                                                                                                 |
| `rate_d1`           | float   | Taxa D1                                                                                                 |
| `from_amount_d0`    | float   | Montante D0 a enviar                                                                                    |
| `to_amount_d0`      | float   | Montante D0 a receber                                                                                   |
| `from_amount_d1`    | float   | Montante D1 a enviar                                                                                    |
| `to_amount_d1`      | float   | Montante D1 a receber                                                                                   |
| `settlement_eta_d0` | string  | ETA de liquidação D0 (RFC 3339)                                                                         |
| `settlement_eta_d1` | string  | ETA de liquidação D1 (RFC 3339)                                                                         |
| `d0_available`      | boolean | `false` indica que a mesa está fechada para D0 — após o horário de corte ou fora do horário de operação |

Este endpoint não retorna um `rfq_id` e não pode ser aceito — serve apenas para exibição. Para travar uma taxa, chame [Criar Conversão](/noxpay-docs-v2/pt/api-reference/conversions/create).

**Códigos de retorno:** `200 OK`, `400 Bad Request`, `500 Internal Server Error`

<RequestExample>
  ```bash theme={null}
  curl "https://checkout.noxpay.io/v2/rfq/ref_quote?from_currency=USDT&to_currency=BRL&from_amount=1000" \
    -H "api-key: <key>"
  ```

  ```python theme={null}
  import requests

  response = requests.get(
      "https://checkout.noxpay.io/v2/rfq/ref_quote",
      headers={"api-key": "<key>"},
      params={
          "from_currency": "USDT",
          "to_currency": "BRL",
          "from_amount": 1000,
      },
  )
  print(response.json())
  ```

  ```javascript theme={null}
  const params = new URLSearchParams({
    from_currency: "USDT",
    to_currency: "BRL",
    from_amount: "1000",
  });
  const response = await fetch(
    `https://checkout.noxpay.io/v2/rfq/ref_quote?${params}`,
    { headers: { "api-key": "<key>" } }
  );
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "quote_pair":        "USDT_BRL",
    "rate_d0":           5.050,
    "rate_d1":           5.060,
    "from_amount_d0":    1000.0,
    "to_amount_d0":      5050.0,
    "from_amount_d1":    1000.0,
    "to_amount_d1":      5060.0,
    "settlement_eta_d0": "2026-07-01T19:00:00Z",
    "settlement_eta_d1": "2026-07-02T18:00:00Z",
    "d0_available":      true
  }
  ```
</ResponseExample>