Get Buy Prices

Get the current price of crypto assets in fiat. Returns the price per 1 unit of each crypto asset.

GEThttps://api.zenpayz.com/payment/api/v1/on-ramp/prices

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
assets REQUIRED	string	Comma-separated crypto IDs (e.g. btc_bitcoin,eth_ethereum)
fiat REQUIRED	string	Fiat currency (e.g. usd)
country OPTIONAL	string	ISO country code

Response

Success (200 OK)

{
  "success": true,
  "data": [
    {
      "asset": "btc_bitcoin",
      "fiat": "usd",
      "price": 89285.71,
      "timestamp": "2026-03-11T04:44:00.000Z"
    },
    {
      "asset": "eth_ethereum",
      "fiat": "usd",
      "price": 3200.50,
      "timestamp": "2026-03-11T04:44:00.000Z"
    }
  ],
  "message": "Prices retrieved"
}

Response Fields

Parameter	Type	Description
asset OPTIONAL	string	Crypto asset ID
fiat OPTIONAL	string	Fiat currency
price OPTIONAL	number	Price of 1 unit of crypto in fiat
timestamp OPTIONAL	string	ISO 8601 timestamp

Error Responses

Code	HTTP	Message
RAMP_PRICES_FAILED	500	Failed to get prices

Examples

cURL

curl "https://api.zenpayz.com/payment/api/v1/on-ramp/prices?assets=btc_bitcoin,eth_ethereum&fiat=usd"

JavaScript

const params = new URLSearchParams({
  assets: 'btc_bitcoin,eth_ethereum',
  fiat: 'usd',
});

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

prices.forEach(p => {
  console.log(`${p.asset}: $${p.price.toLocaleString()}`);
});
// btc_bitcoin: $89,285.71
// eth_ethereum: $3,200.50

Python

import requests

response = requests.get(
    "https://api.zenpayz.com/payment/api/v1/on-ramp/prices",
    params={"assets": "btc_bitcoin,eth_ethereum", "fiat": "usd"},
)
prices = response.json()["data"]

for p in prices:
    print(f"{p['asset']}: ${p['price']:,.2f}")

Next Steps

• Buy Quotes -- Get detailed quotes with fees
• Buy Rates -- Get rates with fee breakdown