Live metal pricing feed
Where the gold/silver/platinum prices come from and how often they refresh.
Overview
Katura ships with a live metal-price feed for gold, silver, platinum, and palladium. It powers the volume-pricing calculator, the customer-facing “today's quote” on proposals, and the “market alert” banner that appears in/admin/design when prices move more than 2% in a day.
Where the prices come from
Spot prices are pulled from a paid commodities feed every 5 minutes during market hours and once an hour overnight. Each tick is stored, so you can replay the price at any point in time — useful when a customer says “you quoted $X yesterday.”
The internal endpoint
The current prices are exposed at /api/developer/metal-prices. The shape:
GET /api/developer/metal-prices
{
"asOf": "2026-01-18T14:23:01Z",
"currency": "USD",
"perTroyOunce": {
"gold": 2654.30,
"silver": 30.78,
"platinum": 985.10,
"palladium": 925.00
}
}Where you'll see it
- The marketing CAD page card, “Live metal prices”
- The pricing breakdown in
/admin/designfor any STL-linked product - The customer-facing proposal page (the quote refreshes on page load)
- Virgil quotes, when a shopper asks “how much is the Homage in 18k?”
Warning
You can configure a “quote validity window” (default 24 hours). If a customer accepts a quote within the window, that price is honored even if metals have moved. After the window, the quote is auto-refreshed.