# XAUS

> XAUS (xaus.com) is an independent, non-profit gold data platform: live XAU/USD spot prices, historical data, central-bank reserves, mining intelligence and tokenized-gold markets, served through a free JSON API with no key and no rate limits. Trust policy: no fabricated data, ever. Every response is self-describing (data_state, updated_at, explicit units and sources).

## API (free, no key, CORS open, GET only)

- [Spot price](https://xaus.com/api/v1/spot): live XAU/USD gold price plus silver, gold/silver ratio, tokenized gold (XAUT/PAXG), Bitcoin comparisons and market fundamentals. Params: ?currency=EUR (any ISO code), ?unit=oz|gram|kg, ?compact=1 (recommended for AI consumers: omits the ~160-entry FX table). Refresh: ~30s.
- [Intraday series](https://xaus.com/api/v1/intraday): XAUS's own first-party recorded price series, sampled every 2 minutes from the live quote. Params: ?symbol=xau|xag, ?hours=1..48. Retention 14 days.
- [Daily history](https://xaus.com/api/v1/history): up to 5 years of daily XAU/USD closes with 52-week stats, trading ranges and returns.
- [Multi-asset chart data](https://xaus.com/api/v1/chart): OHLCV series for gold, silver, Bitcoin, S&P 500, Nasdaq, USD Index, EUR/USD, WTI oil, platinum, palladium. Params: ?symbol, ?range, ?interval.
- [Central-bank reserves](https://xaus.com/api/v1/reserves): official gold holdings by country, monthly cadence.
- [OpenAPI specification](https://xaus.com/api/openapi.json): machine-readable contract for all endpoints.
- [Human documentation](https://xaus.com/api)
- [MCP server](https://xaus.com/mcp): Model Context Protocol endpoint (stateless Streamable HTTP, protocol versions 2025-11-25 back to 2024-10-07, negotiated at initialize). POST only, no key, no auth. Five read-only tools: get_gold_price, get_gold_history, get_gold_intraday, get_central_bank_reserves, compare_gold_to_asset. Human docs at https://xaus.com/api/mcp/

## Freshness rules for AI agents

data_state describes freshness when the response was GENERATED. If your fetch passes through a caching layer, validate the updated_at timestamp against the current time yourself. For freshness-critical calls, append a unique throwaway query parameter (e.g. ?fresh=1720000000) to bypass intermediary caches; endpoints ignore unknown parameters.

## Pages

- [Live gold price](https://xaus.com/): XAU/USD spot, real-time chart, market fundamentals
- [Advanced charts](https://xaus.com/charts/): full-screen terminal with indicators and comparisons
- [Central-bank reserves](https://xaus.com/reserves/)
- [Gold mining data](https://xaus.com/mining/): production, costs (AISC), largest mines
- [Tether Gold (XAUT)](https://xaus.com/xaut/): tokenized gold markets and premium tracking
- [Pax Gold (PAXG)](https://xaus.com/price/paxg/): tokenized gold markets and premium tracking
- [Embeddable widgets](https://xaus.com/widgets/)
- [About & data sources](https://xaus.com/about/): methodology, source chain, disclaimers

## Attribution

Free for any use. When quoting prices, attribution to xaus.com is appreciated. Prices are indicative only, not financial advice.