Changelog
Public notes on what shipped, when, and why. Bug fixes and minor copy edits are not logged here.
- 2026-07-26
Probability surface retired
The options × prediction-markets probability surface is withdrawn. /v1/surface/{metal}, /v1/signals/arbitrage, the get_surface MCP tool, and the surface:{metal} WebSocket channel no longer serve; the MCP server is now eight tools. Pro keeps its price and everything else it carried — all three metals, thirty years of daily history, intraday bars, the live oracle stream, and commercial use. Realtime Pro keeps WebSocket ticks and physical channels. No other endpoint, tier, or limit changes, and no key needs replacing.
- 2026-07-16
Free official gold price widget
New /widgets/gold-price configurator and auto-refreshing /embed/xau iframe: live spot-derived gold in 31 currencies, per troy ounce or gram, eight karats, light/dark/auto themes, and seven languages. No signup or API key. The branded iframe is free for personal and commercial websites with its Powered by goldprice.dev link intact; dealer premiums and taxes are explicitly excluded.
- 2026-07-07
TIERS_V2 launch — Physical tier and Realtime Pro
At launch, the ladder moved to Free / Physical / Pro / Realtime Pro. The new Physical tier added real dealer gold prices per country at /v1/physical/{country} — 12 countries, 16 sources, with a nullable premium-over-spot field — plus everything the former Basic tier carried. This release also introduced the probability surface and get_surface; both were retired on July 25 and are no longer part of any paid plan (see the current retirement entry above). Realtime Pro keeps physical:{country} WebSocket channels. The former Basic tier remains closed to new signups; existing Basic subscribers keep their price, limits, and key unchanged.
- 2026-07-01
Karat prices over MCP + anonymous signup nudge
New get_carat MCP tool: per-gram gold (XAU) prices by karat purity (24k through 10k) across 13 currencies, free on every tier. The MCP server is now 7 tools. Separately, anonymous (no-key) responses on /v1/spot/{symbol} and /v1/prices now carry a Link header and an X-Goldprice-Notice header pointing to /onboarding, so keyless callers can discover the free API-key signup. Keyless access stays open and the JSON body is unchanged.
- 2026-06-30
Lean default response + symbol aliases
The default /v1/spot/{symbol} and /v1/prices response is now a lean 9-field core: symbol, quote_currency, unit, contract_type, price, bid, ask, is_stale, computed_at. Provenance, karat grams, and OHLC/stats are opt-in via ?include=sources|karat|stats|all (comma-separable; unknown tokens ignored). Symbol aliases now resolve before the tier gate: gold/XAU, silver/XAG, copper/HG, and bare base-quote such as XAU-USD all map to their canonical symbol, without bypassing tier access. Anonymous and authenticated callers share the same lean default; request ?include=all for the previous full shape.
- 2026-06-26
News feed removed
We removed the commodity news feed to focus on core pricing data. Removed: the /v1/news, /v1/news/sources, and /v1/news.rss endpoints, the /news web page, the RSS ingestion pipeline, and the search_news MCP tool. The MCP server is now 6 tools. Price, history, forward-view, and FAQ-search surfaces are unaffected.
- 2026-06-22
Realtime tier — live WebSocket tick stream
New Realtime tier ($80/mo): a WebSocket stream at wss://api.goldprice.dev/v1/stream pushing live XAU and XAG spot ticks in real time, up to 10 concurrent streams per key and 1M calls/mo, with all Pro features included. Connections are authenticated with your ga_live_ API key. REST polling and the Pro SSE oracle stream (/v1/prices/stream) are unchanged.
- 2026-06-21
Currency-aware decimal precision in /v1/convert and /v1/carat
Converted amounts now follow each currency's natural decimal places. Currencies with no minor unit (JPY, KRW, VND, and others) return whole numbers instead of trailing decimals; most currencies stay at 2 places, and a few (such as BHD and KWD) use 3. This affects the result field of /v1/convert and the per-gram prices in /v1/carat — the values are the same, just rounded to each currency's real precision. The exchange rate field is unchanged and keeps full precision. HTTP shapes and status codes are unchanged.
- 2026-06-19
Unified API error format + new endpoints
Breaking: error responses are now a single shape — {"error","message"} — across every endpoint (some previously returned {"detail":...}). Update any client that parses the error body; HTTP status codes are unchanged. New /v1/convert (metal/currency/unit conversion) and /v1/carat (per-gram price by karat) endpoints. Public endpoints now cache at a cadence matched to their refresh rate. The OpenAPI spec documents error responses, and all timestamps are standardized to Z.
- 2026-06-15
Prediction markets removed
We cut the prediction-market features to focus on core commodity pricing. Removed: the /v1/prediction-market-view and arb endpoints, their two MCP tools (the surface is now 7 tools), and the prediction-market scrapers. /v1/forward-view stays as the futures settlement curve. The price-source divergence flag (live oracle vs futures/spot reference) is unaffected.
- 2026-05-04
Forward view + interpolation
/v1/forward-view ships as the multi-horizon endpoint behind /data/gold: prediction-market range from Polymarket + Kalshi (direction-aware conviction-CDF, includes above/below/upside-touch markets), futures settlement curve, and an analyst-consensus layer. /v1/prediction-market-view gains ?interpolate=true for arbitrary forecast dates between active expiries. New get_forward_view MCP tool. Methodology rewritten to cover both methods.
- 2026-04-30
Public launch
goldprice.dev opens to the public with multi-source XAU spot in 13 currencies, GC futures, XAG spot + futures, HG futures, an MCP server (8 tools), and a freemium API tier.
- 2026-04-27
Pre-launch hardening
AI-bot allowlist expanded for browsing-agent crawlers (ChatGPT-User, OAI-SearchBot, YouBot). FAQPage JSON-LD on /prices/* surfaces. Smithery discovery manifest at /.well-known/mcp.json.
- 2026-04-25
Prediction market view
Polymarket + Kalshi yes-price CDF surfaces on /data/gold and the get_prediction_market_view MCP tool. Cross-venue arb pairs via get_prediction_market_arb.
- 2026-04-23
MCP server live
8 tools across spot pricing, metadata, history, news search, FAQ search, and prediction-market views. Free tier includes MCP access.