Skip to main content
curl https://checkout.noxpay.io/v2/rfq/NOXabc123 \
  -H "api-key: <key>"

import requests

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

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

{
  "rfq_id": "NOXabc123",
  "component": "settlement_rfq",
  "state": "AWAITING",
  "created_at": "2026-07-01T12:00:00Z",
  "updated_at": "2026-07-01T12:00:31Z",
  "attributes": {
    "from_currency": "USDT",
    "to_currency": "BRL",
    "quote_pair": "USDT_BRL",
    "from_amount_d0": 1000.0,
    "to_amount_d0": 5050.0,
    "rate_d0": 5.050,
    "from_amount_d1": 1000.0,
    "to_amount_d1": 5060.0,
    "rate_d1": 5.060,
    "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",
    "settlement_day": "d0",
    "amount_from": 1000.0,
    "amount_to": 5050.0,
    "rate": 5.050,
    "settlement_eta": "2026-07-01T19:00:00Z",
    "wallet_id": "...",
    "pix_key": null,
    "error_detail": "",
    "webhook": "https://yourapp.com/webhooks/nox"
  }
}

{ "error": "Not Found" }

​
Path parameters

ParameterDescription
idThe rfq_id returned by Create Conversion

​
Response 200 OK

A conversion moves through three internal components in sequence — quote_otc → rfq_swap → settlement_rfq. The component field tells you which stage the conversion is in, and state tells you its status within that stage.

​
Conversion states

quote_otc — the quote itself, before and up to acceptance.
StateMeaning
QUOTEQuote is active; awaiting your acceptance
DONEAccepted — balance validated, trade locked, delivery scheduled
EXPIREDRate expired; a fresh rate was generated automatically — review before accepting
DEPRECATEDRenewal window closed; create a new conversion
ERRORInsufficient balance, limit exceeded, invalid currency, or another business error
rfq_swap — internal ledger entries for the trade (transitions immediately after acceptance; not user-actionable).
StateMeaning
INITIALRecording ledger entries for the swap (transient)
DONELedger entries recorded; converted amount held as a receivable pending delivery
ERRORFailed to record — Noxpay operations notified
settlement_rfq — delivery of the converted funds.
StateMeaning
AWAITINGWaiting for the settlement window (D0 or D1)
DONEDelivery complete; funds moved to your available balance
ERRORDelivery failed; funds remain safely held as a receivable — Noxpay operations notified

​
Attributes

FieldTypeDescription
from_currencystringSource currency
to_currencystringDestination currency
quote_pairstringQuote pair (e.g. USDT_BRL)
from_amount_d0floatD0 amount to send
to_amount_d0floatD0 amount to receive
rate_d0floatD0 rate
from_amount_d1floatD1 amount to send
to_amount_d1floatD1 amount to receive
rate_d1floatD1 rate
settlement_eta_d0stringD0 settlement ETA (RFC 3339)
settlement_eta_d1stringD1 settlement ETA (RFC 3339)
expires_atstringCurrent quote’s expiration (RFC 3339)
renewable_up_tostringLast moment the quote can be accepted (RFC 3339)
settlement_daystringd0 or d1 — populated after accept
amount_fromfloatConfirmed amount sent — populated after accept
amount_tofloatConfirmed amount received — populated after accept
ratefloatConfirmed rate — populated after accept
settlement_etastringConfirmed settlement ETA — populated after accept
wallet_idstringDestination wallet, if applicable
pix_keystringDestination Pix key, if applicable
error_detailstringClient-facing error message, if any
webhookstringConfigured webhook URL
404 — conversion not found or does not belong to your account. 
curl https://checkout.noxpay.io/v2/rfq/NOXabc123 \
  -H "api-key: <key>"

import requests

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

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

{
  "rfq_id": "NOXabc123",
  "component": "settlement_rfq",
  "state": "AWAITING",
  "created_at": "2026-07-01T12:00:00Z",
  "updated_at": "2026-07-01T12:00:31Z",
  "attributes": {
    "from_currency": "USDT",
    "to_currency": "BRL",
    "quote_pair": "USDT_BRL",
    "from_amount_d0": 1000.0,
    "to_amount_d0": 5050.0,
    "rate_d0": 5.050,
    "from_amount_d1": 1000.0,
    "to_amount_d1": 5060.0,
    "rate_d1": 5.060,
    "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",
    "settlement_day": "d0",
    "amount_from": 1000.0,
    "amount_to": 5050.0,
    "rate": 5.050,
    "settlement_eta": "2026-07-01T19:00:00Z",
    "wallet_id": "...",
    "pix_key": null,
    "error_detail": "",
    "webhook": "https://yourapp.com/webhooks/nox"
  }
}

{ "error": "Not Found" }