How to get live gold prices in Next.js

import "server-only";

const API_BASE = "https://api.goldprice.dev";

export interface SpotPrice {
  symbol: string;
  quoteCurrency: string;
  price: string;
  bid: string | null;
  ask: string | null;
  isStale: boolean;
  computedAt: string | null;
}

/** Fetch the live spot price for one symbol, e.g. "XAU-USD-SPOT". */
export async function getSpotPrice(symbol = "XAU-USD-SPOT"): Promise<SpotPrice> {
  const apiKey = process.env.GOLDPRICE_API_KEY;
  if (!apiKey) {
    throw new Error("GOLDPRICE_API_KEY is not set");
  }

  const res = await fetch(`${API_BASE}/v1/spot/${symbol}`, {
    headers: { Authorization: `Bearer ${apiKey}` },
    next: { revalidate: 3600 },
  });

  if (res.status === 401) {
    throw new Error("goldprice: invalid API key");
  }
  if (res.status === 429) {
    const retryAfter = res.headers.get("Retry-After");
    throw new Error(`goldprice: rate limited, retry after ${retryAfter ?? "60"}s`);
  }
  if (!res.ok) {
    throw new Error(`goldprice: unexpected status ${res.status}`);
  }

  const raw = await res.json();
  if (typeof raw.symbol !== "string" || typeof raw.price !== "string") {
    throw new Error("goldprice: unexpected response shape");
  }

  return {
    symbol: raw.symbol,
    quoteCurrency: raw.quote_currency,
    price: raw.price,
    bid: raw.bid ?? null,
    ask: raw.ask ?? null,
    isStale: Boolean(raw.is_stale),
    computedAt: raw.computed_at ?? null,
  };
}

import { getSpotPrice } from "@/lib/goldprice";

export default async function Page() {
  const spot = await getSpotPrice("XAU-USD-SPOT");

  return (
    <main>
      <h1>
        {spot.symbol}/{spot.quoteCurrency}: {spot.price}
      </h1>
      <p>Updated: {spot.computedAt}</p>
    </main>
  );
}

// Free-tier-safe default: ~720 calls/month
next: { revalidate: 3600 }

// Paid tier with quota to spare: near-live
next: { revalidate: 60 }

import { getSpotPrice } from "@/lib/goldprice";

export default async function Page() {
  let spot;
  try {
    spot = await getSpotPrice("XAU-USD-SPOT");
  } catch (err) {
    console.error(err);
    return <p>Gold price is temporarily unavailable. Try again shortly.</p>;
  }

  return (
    <main>
      <h1>
        {spot.symbol}/{spot.quoteCurrency}: {spot.price}
      </h1>
    </main>
  );
}