Get Quote

Whitelabel API - Get real-time exchange rate quote

POST
texttext
/api/v2/lookup/quote

Returns a real-time exchange rate quote with full fee breakdown for Whitelabel API integrations.

Request Headers

Authorizationstringrequired
Bearer token
Content-TypestringDefault: application/json

Request Body

fiatCurrencystringrequired
Source fiat currency (e.g., "USD")
cryptoCurrencystringrequired
Target crypto currency (e.g., "ETH")
fiatAmountnumber
Fiat amount to convert from
cryptoAmountnumber
Crypto amount (alternative to fiatAmount)
networkstringrequired
Blockchain network
quoteCountryCodestring
Country code for regional pricing
paymentMethodstring
Payment method ID for fee calculation
productsAvailedstringDefault: BUY
Product: BUY, SELL, or NFT

Response Schema

responseValuenumber
Converted amount
responseCurrencystring
Currency of response value
ratestring
Exchange rate
networkFeeobject
Object containing amount and currency
partnerFeeobject
Object containing amount and percentage
OZZOBiTFeeobject
Object containing amount and percentage
totalFeeobject
Object containing amount and currency
quoteIdstring
Unique quote ID (valid 30s)

Example Request

bashbash
curl -X POST "https://OZZOBiT.com/api/api/v2/lookup/quote" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"fiatCurrency":"USD","cryptoCurrency":"ETH","fiatAmount":100,"network":"ethereum"}'

Example Response

jsonjson
{
  "responseValue": 0.045231,
  "responseCurrency": "ETH",
  "rate": "0.00045231",
  "networkFee": { "amount": 0.83, "currency": "USD" },
  "partnerFee": { "amount": 1.00, "percentage": 1.00 },
  "OZZOBiTFee": { "amount": 3.99, "percentage": 3.99 },
  "totalFee": { "amount": 5.82, "currency": "USD" },
  "quoteId": "quote_abc123"
}