How to get live gold prices in Node.js

npm install decimal.js

// node: goldprice.mjs
// curl-equivalent: https://api.goldprice.dev/v1/spot/XAU-USD-SPOT
import Decimal from "decimal.js";

const API_BASE = "https://api.goldprice.dev";
const API_KEY = process.env.GOLDPRICE_API_KEY;
if (!API_KEY) {
  throw new Error("GOLDPRICE_API_KEY not set");
}

const TTL_MS = 60_000;
const cache = new Map();

/** Fetch live spot price. Cached 60s per symbol, retries 3x on 429. */
export async function spot(symbol = "XAU-USD-SPOT") {
  const cached = cache.get(symbol);
  if (cached && cached.expiresAt > Date.now()) {
    return cached.data;
  }

  let lastErr;
  for (let attempt = 0; attempt < 3; attempt++) {
    const res = await fetch(`${API_BASE}/v1/spot/${symbol}`, {
      headers: { "X-API-Key": API_KEY },
      signal: AbortSignal.timeout(5000),
    });

    if (res.status === 429) {
      lastErr = new Error("goldprice: 429 rate limited");
      const backoffMs = 2 ** attempt * 1000; // 1s, 2s, 4s
      await new Promise((resolve) => setTimeout(resolve, backoffMs));
      continue;
    }
    if (!res.ok) {
      throw new Error(`goldprice: unexpected status ${res.status}`);
    }

    const raw = await res.json();
    const data = {
      symbol: raw.symbol,
      quoteCurrency: raw.quote_currency,
      price: new Decimal(raw.price),
      bid: new Decimal(raw.bid),
      ask: new Decimal(raw.ask),
      isStale: raw.is_stale,
      computedAt: raw.computed_at,
    };
    cache.set(symbol, { data, expiresAt: Date.now() + TTL_MS });
    return data;
  }
  throw lastErr;
}

import { spot } from "./goldprice.mjs";

const r = await spot("XAU-USD-SPOT");
console.log(`${r.symbol}-${r.quoteCurrency}: ${r.price} (computed ${r.computedAt})`);
// XAU-USD: 4726.01 (computed 2026-07-05T04:49:01.706844+00:00)

// USD spot — default
await spot("XAU-USD-SPOT");

// INR — Indian gold market (largest retail gold-search globally)
await spot("XAU-INR-SPOT");

// EUR — European pricing surfaces
await spot("XAU-EUR-SPOT");

// Silver in USD
await spot("XAG-USD-SPOT");