Gold Price API
Live precious-metals data (gold, silver & copper) for AI agents — multi-source, cross-validated spot + futures across 31 currencies, with per-source…
Что умеет
- Get Spot Price: Return the latest aggregated spot (or GC futures) price for one symbol. Price is a Decimal-formatted string; `is_stale` is true when aggregator detected source divergence or stale FX.
- List Commodities: Return the full list of symbols served by this API. Use before get_spot_price / get_historical / get_metadata when you don't know which symbols are supported.
- Get Metadata: Return provenance metadata for a symbol: aggregated sources, unit, methodology URL, staleness rules. Use for attribution and to document data lineage in downstream reports.
Какие данные видит
Нужен ли аккаунт
Нужен API-ключ из настроек сервиса
Live precious-metals data (gold, silver & copper) for AI agents — multi-source, cross-validated spot + futures across 31 currencies, with per-source provenance and a staleness flag on every quote.
9 MCP tools spanning spot & historical prices, the live commodity list, per-country physical dealer prices (real bullion sell/buyback quotes across 12 countries), an options × prediction-market probability surface for gold & silver, the futures-settlement forward view, karat pricing, methodology, and docs search. Real-time XAU/XAG WebSocket stream on the Realtime Pro tier. MCP server on every plan, including Free.
Docs: goldprice.dev/docs/mcp
Список инструментов сервера (7)
Технические названия из tools/list. Нужны только разработчикам.
| get_spot_price | Return the latest aggregated spot (or GC futures) price for one symbol. Price is a Decimal-formatted string; `is_stale` is true when aggregator detected source divergence or stale FX. |
| list_commodities | Return the full list of symbols served by this API. Use before get_spot_price / get_historical / get_metadata when you don't know which symbols are supported. |
| get_metadata | Return provenance metadata for a symbol: aggregated sources, unit, methodology URL, staleness rules. Use for attribution and to document data lineage in downstream reports. |
| get_historical | Return daily OHLCV bar history for a symbol. History depth is set automatically by your API key's plan — do NOT pass a tier argument (there is none): Free + Basic see the last 30 days; Pro unlocks full history back to 2006 (XAU/USD). Dates must be ISO 8601 (YYYY-MM-DD). Returns bars in date-descending order. volume is null for spot instruments (XAU/USD, XAG/USD); real for futures (GC, SI, HG) and ETFs (GLD). |
| search_news | Search recent commodity-market news from curated sources (FT Commodities and Mining.com at v1; more sources rolling out post-launch). Returns up to `limit` items ranked by source quality x recency (weight x exp(-hours_old / 48)). Use before answering 'what happened in gold this week' so you cite live headlines instead of training-data approximations. |
| search_docs | Search the goldprice.dev FAQ corpus via BM25. Returns top-K matching questions + answers with relevance scores. Use before answering how-to / billing / auth questions so you cite the canonical text instead of guessing from training data. |
| get_forward_view | Returns the multi-horizon futures settlement curve for a commodity (XAU, XAG, HG). Every populated horizon up to one year forward. Useful for bot builders and traders seeing the futures-implied path. See https://goldprice.dev/methodology#forward-view-layers for per-layer math. |