Gold API
Gold, silver and copper spot prices, with delayed futures settlement prices and gold conversion across 31 currencies using exchangerate.dev FX. Paid plans get…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Gold, silver and copper spot prices, with delayed futures settlement prices and gold conversion across 31 currencies using exchangerate.dev FX. Paid plans get live spot prices; Free and keyless access get the same prices 15 minutes late. BGN is fixed to the euro (1.95583 BGN per EUR): BGN prices follow the euro, not a separate market rate.
Endpoints 29
system
- GETLiveness probe
/v1/healthMinimal 200 OK if the process is up. No downstream checks. GET is the documented public operation. HEAD is registered separately below so uptime monitors work… - GETReadiness probe — Redis + per-scraper freshness
/v1/statusReturns Redis reachability + per-scraper freshness from scraper_runs. Overall status is ok only when Redis is up, every required scraper's latest successful… - GETPublic tier catalog
/v1/metadata/tiersOrdered list of tiers. Match on key; show only rows with hidden false. Once the 2026 plans are on sale, Free/Basic/Plus/Pro are the visible rows and the… - GETList active API keys for the authed organization
/v1/account/keys - POSTMint a new API key; old key enters a 24h grace period
/v1/account/keys - DELETEHard-revoke a key immediately (revoked_at = now)
/v1/account/keys/:key_id - POSTCreate Checkout
/v1/account/checkout - GETAuthed key's day + month call counters
/v1/account/usage
prices
- GETLatest aggregated price per (symbol, currency, contract_type)
/v1/pricesPaid plans get live prices. Free and keyless callers get the same prices 15 minutes late. bid/ask are paid-only and omitted when no two-sided quote is… - GETLatest spot price for one symbol — flat shape, no envelope (parity convenience)
/v1/spot/:symbolPaid plans get live prices. Free and keyless callers get the same prices 15 minutes late. bid/ask are paid-only and omitted when no two-sided quote is… - GETLive spot SSE stream — Pro-tier (XAU, XAG, and HG)
/v1/prices/stream?symbol=string - GETSymbols whose cross-source price spread exceeds a threshold
/v1/prices/divergence - GETFutures settlement series for GC / SI / HG (Pro+)
/v1/settlements?symbol=string - GETMulti-horizon forward view: futures settlement curve
/v1/forward-view/:asset - GET[DEPRECATED — use /v1/bars] Aggregated close history for a symbol — interval ∈ {1d, 1h}.
/v1/prices/history?symbol=string&from=string&to=stringDispatch to the per-interval handler. The handler is the Module Interface; per-interval helpers are Deep Modules hiding the interval-specific policy + storage…
convert
- GETConvert between metals, currencies, and units
/v1/convert?from=string&to=stringConvert an amount between metals, currencies, and units. metal → currency: spot price in that currency via FX cross through USD currency → metal: inverse of… - GETPer-gram gold price by karat purity
/v1/caratPer-gram XAU price for karats 24 / 22 / 21 / 20 / 18 / 16 / 14 / 10. Logic: per_gram_24k = spot_xau_usd_per_oz / GRAMS_PER_TROY_OUNCE * fx_rate; per_gram_Nk =…
physical
- GETPhysical gold — live country index
/v1/physical§5.1 — which countries are live, how many sources, freshest fetch. ?metal= lists the countries with quotes of that metal and adds products_by_metal (every… - GETPhysical gold — dealer quotes for one country
/v1/physical/:country§5.2 — latest dealer quotes + premium_over_spot_bps for one country.
bars
- GETOHLCV bar history — cursor-paginated, real data, is_closed label
/v1/bars?symbol=string&from=string&to=stringPaginated OHLCV bar history from the canonical price_bars store. Results are ordered DESC by bar_start (newest first). Paginate via next_cursor — pass it as… - GETLatest bar for a symbol+interval — the most-recent settled or forming bar
/v1/bars/latest?symbol=stringReturn the single most-recent bar for a symbol+interval. Ordered by bar_start DESC, returns the first row. Provisional (forming) bars are returned with…
ratios
- GETCross-commodity ratio time-series — date-joined daily closes (Pro+)
/v1/ratios?pair=string&from=string&to=stringPaginated cross-commodity ratio series from the canonical price_bars store. Results are ordered DESC by date (newest first). Paginate via next_cursor — pass… - GETLatest ratio point for a pair — the most-recent shared-date ratio (Pro+)
/v1/ratios/latest?pair=stringReturn the single most-recent shared-date ratio point for a pair. Returns 200 with point: null when no shared date exists (e.g. before either leg is…
download
- GETBulk OHLCV download — presigned Parquet or CSV file (paid plans)
/v1/download?symbol=string&year=1996Bulk download of OHLCV bars for a symbol+interval+year from the archive. Returns a 307 redirect to a time-limited presigned URL (1 hour TTL). Free and…
public
- GETPublic XAU/USD daily-close history (1 year, hourly refresh, no auth)
/v1/public/xau-historyYear-back daily-close series for XAU-USD-SPOT. No auth, no tier gate, no per-IP cap. Refreshes once per hour to deter scraping — callers within the same hour…
alerts
- GETList your price alerts
/v1/alerts - POSTCreate a price alert
/v1/alertsCreates an alert on the plan's allowance. The signing secret is in this response only. - GETGet one price alert
/v1/alerts/:alert_id - DELETEDelete a price alert
/v1/alerts/:alert_id
API details
- Base URL
https://api.goldprice.dev- Authentication
- A bearer token in the Authorization header
An API key in the X-API-Key header - Operations
- 29 operations on 26 pathsGET 24POST 3DELETE 2
- Main resources
- system 8prices 7alerts 4bars 2convert 2physical 2ratios 2download 1public 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
0.1.0 - Links
- OpenAPI document · Support
- Listed from
- Goldprice's published OpenAPI description
How to test the Gold API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Gold API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Liveness probe” (GET /v1/health), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Gold API?
Gold, silver and copper spot prices, with delayed futures settlement prices and gold conversion across 31 currencies using exchangerate.dev FX. Paid plans get… It is listed under Finance & banking and has 29 endpoints.
Who publishes the Gold API?
It is listed from Goldprice's public API description (an OpenAPI document), not published by Goldprice on Swastik Codes. Anyone who controls goldprice.dev can claim the profile by adding a DNS TXT record.
What is the base URL of the Gold API?
Requests go to https://api.goldprice.dev. Endpoint paths are added to this base URL.
How do I authenticate with the Gold API?
It accepts 2 methods: A bearer token in the Authorization header; an API key in the X-API-Key header.
How many endpoints does the Gold API have?
29 operations on 26 paths (24 GET, 3 POST, 2 DELETE). The largest groups are system, prices, alerts, bars.
Is forking the Gold API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.