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

# Reference Quote

> GET /v2/rfq/ref_quote — calculate an indicative rate without creating a conversion.

Calculates a quote without creating a conversion process. Useful for showing indicative rates in your UI before a user commits to starting a conversion.

## Query parameters

| Parameter       | Type   | Required    | Description                                |
| --------------- | ------ | ----------- | ------------------------------------------ |
| `from_currency` | string | Yes         | Source currency code                       |
| `to_currency`   | string | Yes         | Destination currency code                  |
| `from_amount`   | float  | Conditional | Source amount (omit for a unit-rate quote) |
| `to_amount`     | float  | Conditional | Destination amount                         |

If no amount is provided, the response returns the rate for 1 unit of `from_currency`.

## Response `200 OK`

| Field               | Type    | Description                                                                       |
| ------------------- | ------- | --------------------------------------------------------------------------------- |
| `quote_pair`        | string  | Quote pair (e.g. `USDT_BRL`)                                                      |
| `rate_d0`           | float   | D0 rate                                                                           |
| `rate_d1`           | float   | D1 rate                                                                           |
| `from_amount_d0`    | float   | D0 amount to send                                                                 |
| `to_amount_d0`      | float   | D0 amount to receive                                                              |
| `from_amount_d1`    | float   | D1 amount to send                                                                 |
| `to_amount_d1`      | float   | D1 amount to receive                                                              |
| `settlement_eta_d0` | string  | D0 settlement ETA (RFC 3339)                                                      |
| `settlement_eta_d1` | string  | D1 settlement ETA (RFC 3339)                                                      |
| `d0_available`      | boolean | `false` means the desk is closed for D0 — after cutoff or outside operating hours |

This endpoint does not return an `rfq_id` and cannot be accepted — it is for display purposes only. To lock in a rate, call [Create Conversion](/noxpay-docs-v2/api-reference/conversions/create).

**Status codes:** `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>