API Documentation

Getting Started

Rzzro API provides access to live commodity prices, market data, and calculation tools. The API is free, requires no authentication, and returns JSON.

Base URL: https://rzzro.com/api

License: CC BY 4.0 — Attribution required. Rate limit: 100 requests/hour for public API. Contact us for higher tiers.

Authentication

The public API requires no authentication. Include your application name in the User-Agent header for tracking:

curl -H "User-Agent: MyApp/1.0" https://rzzro.com/api/prices.json

For authenticated access (higher rate limits, future features), contact api@rzzro.com

Prices API

Retrieve current commodity prices across major exchanges.

GET

/prices.json

Returns: Current prices for 40+ commodities

{
  "copper": {
    "price": 14200,
    "unit": "USD/mt",
    "exchange": "LME 3M",
    "change_pct": 0.47,
    "timestamp": "2026-05-24T16:30:00Z"
  },
  "aluminum": {
    "price": 3150,
    "unit": "USD/mt",
    "exchange": "LME 3M",
    "change_pct": 2.09,
    "timestamp": "2026-05-24T16:30:00Z"
  }
  ...
}

Query Parameters

Parameter	Type	Description
commodity	string	Filter by commodity (e.g., copper, aluminum). Optional.
exchange	string	Filter by exchange: LME, COMEX, SHFE, NYMEX, CBOT. Optional.
currency	string	Return prices in currency (USD default). Support: EUR, GBP, JPY, CNY. Optional.

Examples

# Copper prices only
GET /prices.json?commodity=copper

# LME metals
GET /prices.json?exchange=LME

# Prices in EUR
GET /prices.json?currency=EUR

Code Examples

JavaScript / Node.js

const response = await fetch('https://rzzro.com/api/prices.json');
const data = await response.json();

console.log(data.copper.price);  // 14200
console.log(data.copper.change_pct);  // 0.47

Python

import requests

response = requests.get('https://rzzro.com/api/prices.json')
data = response.json()

print(data['copper']['price'])  # 14200

cURL

curl -H "User-Agent: MyApp/1.0" https://rzzro.com/api/prices.json \
  | jq '.copper.price'

Error Handling

The API returns standard HTTP status codes. 5xx errors include a retry-after header.

Code	Meaning
200	Success
400	Bad request (invalid parameters)
429	Rate limit exceeded. Check Retry-After header.
500	Server error. Check status page.

Rate Limits

Public API: 100 requests/hour per IP. Requests are tracked via X-RateLimit headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1653378000

For higher limits or dedicated access, contact api@rzzro.com with use case details.