curl "https://checkout.noxpay.io/v2/rfq/ref_quote?from_currency=USDT&to_currency=BRL&from_amount=1000" \
-H "api-key: <key>"
import requests
response = requests.get(
"https://checkout.noxpay.io/v2/rfq/ref_quote",
headers={"api-key": "<key>"},
params={
"from_currency": "TRX_USDT_S2UZ",
"to_currency": "BRL",
"from_amount": 1000,
},
)
print(response.json())
const params = new URLSearchParams({
from_currency: "TRX_USDT_S2UZ",
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();
{
"quote_pair": "USDT (TRX)/BRL (PIX)",
"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
}
Conversions
Cotação de Referência
GET /v2/rfq/ref_quote — calcula uma taxa indicativa sem criar uma conversão.
curl "https://checkout.noxpay.io/v2/rfq/ref_quote?from_currency=USDT&to_currency=BRL&from_amount=1000" \
-H "api-key: <key>"
import requests
response = requests.get(
"https://checkout.noxpay.io/v2/rfq/ref_quote",
headers={"api-key": "<key>"},
params={
"from_currency": "TRX_USDT_S2UZ",
"to_currency": "BRL",
"from_amount": 1000,
},
)
print(response.json())
const params = new URLSearchParams({
from_currency: "TRX_USDT_S2UZ",
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();
{
"quote_pair": "USDT (TRX)/BRL (PIX)",
"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
}
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.
Um valor não numérico em Response
Códigos de retorno:
Diferente de Criar Conversão, que devolve
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 |
from_amount / to_amount é tratado como 0, em vez de rejeitado.
Response 200 OK
| Campo | Tipo | Descrição |
|---|---|---|
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)) |
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 |
d0_available está sempre presente, inclusive quando é false — é assim que você sabe que a mesa está fechada para liquidação no mesmo dia. É informação de produto, não erro.
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.
O spread aplicado aqui é o seu, não um spread global, então a taxa indicativa que você exibe bate com a conversão que você realmente obteria. Duas chaves de API diferentes podem legitimamente ver preços diferentes para a mesma consulta.
200 OK, 400 Bad Request, 401 Unauthorized, 500 Internal Server Error
| HTTP | Quando |
|---|---|
200 | Taxa calculada |
400 | from_currency ou to_currency ausente, ou código de moeda não reconhecido |
401 | api-key ausente ou inválida |
500 | A cotação não pôde ser calculada |
500 para moeda desconhecida, este endpoint devolve um 400 limpo — útil se você quiser validar um par de moedas antes de criar qualquer coisa.
curl "https://checkout.noxpay.io/v2/rfq/ref_quote?from_currency=USDT&to_currency=BRL&from_amount=1000" \
-H "api-key: <key>"
import requests
response = requests.get(
"https://checkout.noxpay.io/v2/rfq/ref_quote",
headers={"api-key": "<key>"},
params={
"from_currency": "TRX_USDT_S2UZ",
"to_currency": "BRL",
"from_amount": 1000,
},
)
print(response.json())
const params = new URLSearchParams({
from_currency: "TRX_USDT_S2UZ",
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();
{
"quote_pair": "USDT (TRX)/BRL (PIX)",
"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
}