Get Quote

Get real-time exchange rate quote

POST

texttext

/api/v2/lookup/quote

Returns a real-time exchange rate quote for converting between fiat and cryptocurrency. Use this to display accurate pricing to users before they initiate a transaction.

Request Body Parameters

partnerApiKeystringrequired

Your public API key

fiatCurrencystringrequired

Source fiat currency code (e.g., "USD")

cryptoCurrencystringrequired

Target cryptocurrency code (e.g., "ETH")

fiatAmountnumber

Fiat amount to convert from

cryptoAmountnumber

Crypto amount to convert to (alternative to fiatAmount)

networkstringrequired

Blockchain network (e.g., "ethereum", "polygon")

quoteCountryCodestring

Country code for region-specific pricing

paymentMethodstring

Payment method ID for fee calculation

Response Schema

responseValuenumber

Converted amount (crypto if fiatAmount given, or vice versa)

responseCurrencystring

Currency of the response value

fromCurrencystring

Source currency

toCurrencystring

Target currency

ratestring

Exchange rate as a decimal string

networkFeeobject

Object containing amount and currency

partnerFeeobject

Object containing amount, currency and percentage

OZZOBiTFeeobject

Object containing amount, currency and percentage

totalFeeobject

Object containing amount and currency

quoteIdstring

Unique quote identifier (valid for 30 seconds)

createdAtstring

ISO 8601 timestamp when quote was generated

Example Request

request.shbash

curl -X POST "https://OZZOBiT.com/api/api/v2/lookup/quote" \
  -H "Content-Type: application/json" \
  -d '{
    "partnerApiKey": "YOUR_PUBLIC_KEY",
    "fiatCurrency": "USD",
    "cryptoCurrency": "ETH",
    "fiatAmount": 100,
    "network": "ethereum",
    "quoteCountryCode": "US",
    "paymentMethod": "credit_debit_card"
  }'

Example Response

response.jsonjson

{
  "responseValue": 0.045231,
  "responseCurrency": "ETH",
  "fromCurrency": "USD",
  "toCurrency": "ETH",
  "rate": "0.00045231",
  "networkFee": {
    "amount": 0.83,
    "currency": "USD"
  },
  "partnerFee": {
    "amount": 1.00,
    "currency": "USD",
    "percentage": 1.00
  },
  "OZZOBiTFee": {
    "amount": 3.99,
    "currency": "USD",
    "percentage": 3.99
  },
  "totalFee": {
    "amount": 5.82,
    "currency": "USD"
  },
  "quoteId": "quote_abc123def456",
  "createdAt": "2024-01-15T10:30:00Z"
}