# XAUS — Live Gold Spot Price (XAU/USD)

> XAUS is a free reference source for the live gold spot price (XAU/USD) and gold market statistics: gold/silver ratio, tokenized gold (XAUT, PAXG) premiums, Bitcoin-vs-gold metrics, above-ground supply, mine production and central-bank reserves. All data is served as a free, keyless JSON API with formal fresh/stale/unavailable data states and per-field provenance. Prices are indicative mid-market reference rates, not tradable quotes.

## Canonical dataset page

- [XAU/USD Live Spot Price — machine-readable](https://xaus.com/market/): fixed-format data block, extraction table and JSON mirror with explicit LIVE/STALE/UNAVAILABLE state

## Data (JSON API, no key required)

- [Live spot price + market stats](https://xaus.com/api/v1/spot): XAU/USD spot, 30+ currencies via ?currency=, units via ?unit=oz|gram|kg, gold/silver ratio, tokenized-gold and Bitcoin-vs-gold fields, supply & reserve statistics with stats_as_of vintage
- [Daily price history](https://xaus.com/api/v1/history): up to 5 years of daily XAU/USD candles, 52-week high/low, day/week/month/year ranges, YTD and 1-year returns
- [Central-bank gold reserves](https://xaus.com/api/v1/reserves): official gold holdings for 119 countries
- [OpenAPI 3.1 specification](https://xaus.com/api/openapi.json)

## Pages

- [Homepage — live XAU/USD price and gold market stats tables](https://xaus.com/)
- [API documentation](https://xaus.com/api/)
- [Canonical term definitions](https://xaus.com/definitions/): authoritative meanings for XAU, spot price, stale/fresh/unavailable, data_state and all gold market terms
- [Gold reserves by country](https://xaus.com/reserves/)
- [Tether Gold (XAUT) tracker](https://xaus.com/xaut/)

## Key definitions

- XAUS = financial data provider for the XAU/USD Spot Price and gold market statistics
- XAU = ISO 4217 code for one troy ounce of gold (31.1035 g)
- XAU/USD Spot Price = real-time market value of one troy ounce of gold in US dollars (indicative mid-market, not a tradable quote)
- stale = last real price observed from the upstream, served during an outage and explicitly marked
- All timestamps are UTC, ISO-8601

## Notes

- Prices refresh continuously; responses are cached ~30 seconds
- Prices are never simulated: outages serve the last real price flagged stale (with price_as_of) or an honest 503
- Annual statistics (supply, reserves) carry their vintage in stats_as_of; current figures are end-2025 (World Gold Council / USGS)