usagold.com APIusagold.com ↗
Access live gold and silver spot prices, daily closing prices by date, monthly price arrays, weekly summaries, and historical stats via the USAGOLD API.
curl -X GET 'https://api.parse.bot/scraper/7b4c431d-947e-4c59-84a9-86035c7e4925/get_gold_price_by_date?date=2026-04-15' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the gold closing price for a specific date. Returns the price and daily change. Only trading days have data; weekends and holidays return not-found.
| Param | Type | Description |
|---|---|---|
| daterequired | string | Date in YYYY-MM-DD format (e.g. 2026-04-01). Must be a trading day. |
{
"type": "object",
"fields": {
"date": "string, the requested date in YYYY-MM-DD format",
"price": "string, closing price with dollar sign (e.g. '$4,785.21')",
"change": "string, daily change with sign and dollar symbol (e.g. '+$26.31') or null if unavailable"
},
"sample": {
"data": {
"date": "2026-04-01",
"price": "$4,785.21",
"change": "+$26.31"
},
"status": "success"
}
}About the usagold.com API
The USAGOLD API provides 5 endpoints covering live and historical gold and silver prices sourced from USAGOLD. You can retrieve a single day's closing price with daily change via get_gold_price_by_date, pull a full month of trading-day prices with get_gold_prices_by_month, or fetch live spot prices for both metals in a single call with get_live_prices. Responses include structured price strings, directional change values, and period-over-period comparisons.
Live and Point-in-Time Price Data
The get_live_prices endpoint returns current spot prices for both gold and silver with no input parameters required. Each metal object in the response includes price, change, and sign fields, making it straightforward to display real-time market data or trigger alerts on price movement direction. The get_gold_price_by_date endpoint accepts a date parameter in YYYY-MM-DD format and returns the closing price and change for that trading day. Non-trading days (weekends and market holidays) return a not-found response rather than a null price, so callers should account for this when iterating over calendar ranges.
Monthly and Weekly Historical Series
For broader time ranges, get_gold_prices_by_month accepts year, month, and an optional metal parameter ('gold' or 'silver'), returning an array of {date, price, change} objects for every trading day in that month. This makes it practical to build monthly price charts or compute volatility without assembling individual date calls. The get_weekly_gold_prices endpoint accepts an optional year and metal and returns one price entry per week for the full year — useful for long-horizon trend analysis where daily granularity isn't needed.
Summary Statistics
The get_gold_price_history_summary endpoint returns a summary object with three named keys — Yesterday, Last Week, and Last Month — each containing a closing price and a change versus the prior period. This requires no date math on the caller's side and covers both gold and silver via the optional metal parameter. The endpoint is well-suited for dashboard widgets or notification systems that need a quick contextual snapshot without pulling a full price series.
- Displaying a live gold and silver price ticker on a financial dashboard using get_live_prices price and change fields
- Backtesting a precious metals trading strategy by iterating get_gold_price_by_date across specific historical trading days
- Charting a full month of gold price movement by pulling the prices array from get_gold_prices_by_month
- Building a weekly gold price trend line for multi-year comparison using get_weekly_gold_prices with a year parameter
- Populating a portfolio dashboard summary card with yesterday, last week, and last month closing prices from get_gold_price_history_summary
- Tracking silver price changes over a month by passing metal='silver' to get_gold_prices_by_month
- Alerting when daily gold change exceeds a threshold by polling get_live_prices sign and change fields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.