Get Sell Rates

Get off-ramp exchange rates for multiple fiat destinations at once. Returns the best available rate per destination.

GEThttps://api.zenpayz.com/payment/api/v1/off-ramp/rates

Bearer · API key

Request

Headers

Header	Description
x-request-id OPTIONAL	Custom request ID for tracing

Public Endpoint

This endpoint does not require authentication headers.

Query Parameters

Parameter	Type	Description
source REQUIRED	string	Crypto ID (e.g. btc_bitcoin)
destinations REQUIRED	string	Comma-separated fiat currencies (e.g. usd,eur,gbp)
paymentMethod OPTIONAL	string	Filter by payout method
country OPTIONAL	string	ISO country code
amount OPTIONAL	string	Reference amount (default: 100)

Response

Success (200 OK)

{
  "success": true,
  "data": [
    {
      "source": "btc_bitcoin",
      "destination": "usd",
      "rate": 89285.71,
      "paymentMethod": "bank_transfer",
      "networkFee": 2.00,
      "transactionFee": 5.00,
      "minAmount": 0.001,
      "maxAmount": 1.0,
      "timestamp": "2026-03-11T04:44:00.000Z"
    },
    {
      "source": "btc_bitcoin",
      "destination": "eur",
      "rate": 82150.30,
      "paymentMethod": "bank_transfer",
      "networkFee": 2.00,
      "transactionFee": 4.50,
      "minAmount": 0.001,
      "maxAmount": 1.0,
      "timestamp": "2026-03-11T04:44:00.000Z"
    }
  ],
  "message": "Sell rates retrieved"
}

Response Fields

Parameter	Type	Description
source OPTIONAL	string	Crypto asset ID
destination OPTIONAL	string	Fiat currency
rate OPTIONAL	number	Exchange rate
paymentMethod OPTIONAL	string	Best payout method for this rate
networkFee OPTIONAL	number	Blockchain network fee
transactionFee OPTIONAL	number	Processing fee
minAmount OPTIONAL	number	Minimum allowed amount
maxAmount OPTIONAL	number	Maximum allowed amount
timestamp OPTIONAL	string	ISO 8601 timestamp

Error Responses

Code	HTTP	Message
OFFRAMP_RATES_FAILED	500	Failed to get sell rates

Examples

cURL

curl "https://api.zenpayz.com/payment/api/v1/off-ramp/rates?source=btc_bitcoin&destinations=usd,eur,gbp"

JavaScript

const params = new URLSearchParams({
  source: 'btc_bitcoin',
  destinations: 'usd,eur,gbp',
});

const response = await fetch(
  `https://api.zenpayz.com/payment/api/v1/off-ramp/rates?${params}`
);
const { data: rates } = await response.json();

rates.forEach(r => {
  console.log(`BTC → ${r.destination.toUpperCase()}: ${r.rate}`);
});

Python

import requests

response = requests.get(
    "https://api.zenpayz.com/payment/api/v1/off-ramp/rates",
    params={
        "source": "btc_bitcoin",
        "destinations": "usd,eur,gbp",
    },
)
rates = response.json()["data"]

for r in rates:
    print(f"BTC → {r['destination'].upper()}: {r['rate']}")

Next Steps

• Sell Quotes -- Get detailed quotes with multiple options
• Sell Checkout -- Create a sell checkout