API SDKs & Libraries

// AURUM API Client — JavaScript / Node.js
// Works in browser and Node.js 18+ (native fetch)

class AurumClient {
  constructor(apiKey = '') {
    this.base = 'https://aurumrates.com/api/v1';
    this.headers = apiKey ? { 'X-API-Key': apiKey } : {};
  }

  async _get(path, params = {}) {
    const qs = new URLSearchParams(params).toString();
    const url = this.base + path + (qs ? '?' + qs : '');
    const res = await fetch(url, { headers: this.headers });
    if (!res.ok) throw new Error('HTTP ' + res.status);
    return res.json();
  }

  spot(params = {})        { return this._get('/spot', params); }
  historical(params = {})  { return this._get('/historical', params); }
  signals(params = {})     { return this._get('/signals', params); }
  levels(params = {})      { return this._get('/levels', params); }
  forecast(params = {})    { return this._get('/forecast', params); }
  correlations(params = {}){ return this._get('/correlations', params); }
  ratios()                 { return this._get('/ratios'); }
  volatility(params = {})  { return this._get('/volatility', params); }
  seasonal(params = {})    { return this._get('/seasonal', params); }
  spreads(params = {})     { return this._get('/spreads', params); }
  marketSummary()          { return this._get('/market-summary'); }
  performance(params = {}) { return this._get('/performance', params); }
  currencies()             { return this._get('/currencies'); }
  status()                 { return this._get('/status'); }
  usage()                  { return this._get('/usage'); }
}

// Usage:
const aurum = new AurumClient('your-api-key');
const gold = await aurum.spot({ metal: 'gold', currency: 'EUR' });
console.log(gold);

// Quick start — fetch gold price in 3 lines
const res = await fetch('https://aurumrates.com/api/v1/spot?metal=gold', {
  headers: { 'X-API-Key': 'your-api-key' }
});
const data = await res.json();
console.log('Gold:', data.prices.gold.price, 'USD/oz');

// Multiple metals
const multi = await fetch('https://aurumrates.com/api/v1/spot?metals=gold,silver,platinum');
const metals = await multi.json();
console.log(metals.prices);

// Historical data
const hist = await fetch('https://aurumrates.com/api/v1/historical?metal=gold&from=2025-01-01&to=2026-01-01');
const history = await hist.json();
console.log(history.data.length, 'data points');

// Server-Sent Events — real-time price stream
const source = new EventSource('https://aurumrates.com/api/v1/stream?metals=gold,silver');

source.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Gold:', data.prices?.gold?.price);
  console.log('Silver:', data.prices?.silver?.price);
};

source.onerror = () => {
  console.log('Connection lost, reconnecting...');
  // EventSource auto-reconnects
};

// Close after 5 minutes (server also closes)
setTimeout(() => source.close(), 5 * 60 * 1000);

# AURUM API Client — Python 3.7+
# pip install requests

import requests

class AurumClient:
    BASE = "https://aurumrates.com/api/v1"

    def __init__(self, api_key=""):
        self.session = requests.Session()
        if api_key:
            self.session.headers["X-API-Key"] = api_key

    def _get(self, path, **params):
        r = self.session.get(f"{self.BASE}{path}", params=params)
        r.raise_for_status()
        return r.json()

    def spot(self, **kw):         return self._get("/spot", **kw)
    def historical(self, **kw):   return self._get("/historical", **kw)
    def signals(self, **kw):      return self._get("/signals", **kw)
    def levels(self, **kw):       return self._get("/levels", **kw)
    def forecast(self, **kw):     return self._get("/forecast", **kw)
    def correlations(self, **kw): return self._get("/correlations", **kw)
    def ratios(self):             return self._get("/ratios")
    def volatility(self, **kw):   return self._get("/volatility", **kw)
    def seasonal(self, **kw):     return self._get("/seasonal", **kw)
    def spreads(self, **kw):      return self._get("/spreads", **kw)
    def market_summary(self):     return self._get("/market-summary")
    def performance(self, **kw):  return self._get("/performance", **kw)
    def currencies(self):         return self._get("/currencies")
    def status(self):             return self._get("/status")
    def usage(self):              return self._get("/usage")

# Usage:
aurum = AurumClient("your-api-key")
gold = aurum.spot(metal="gold", currency="EUR")
print(f"Gold in EUR: {gold}")

# Quick start — Python
import requests

API_KEY = "your-api-key"
BASE = "https://aurumrates.com/api/v1"
headers = {"X-API-Key": API_KEY}

# Get gold spot price
r = requests.get(f"{BASE}/spot?metal=gold", headers=headers)
print(r.json())

# Get technical signals
signals = requests.get(f"{BASE}/signals?metal=gold", headers=headers)
print(signals.json()["signal"])  # "buy", "sell", or "hold"

# Get seasonal analysis
seasonal = requests.get(f"{BASE}/seasonal?metal=gold&years=3", headers=headers)
print(seasonal.json()["best_month"])

# Spot price
curl -H "X-API-Key: your-api-key" \
  "https://aurumrates.com/api/v1/spot?metal=gold"

# Spot price in EUR
curl -H "X-API-Key: your-api-key" \
  "https://aurumrates.com/api/v1/spot?metal=gold&currency=EUR"

# Technical signals
curl "https://aurumrates.com/api/v1/signals?metal=gold&short_period=10&long_period=50"

# Seasonal analysis
curl "https://aurumrates.com/api/v1/seasonal?metal=gold&years=3"

# Support/resistance levels
curl "https://aurumrates.com/api/v1/levels?metal=gold&method=fibonacci"

# Market summary
curl "https://aurumrates.com/api/v1/market-summary"

# API health status
curl "https://aurumrates.com/api/v1/status"