USAGOLD 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.
What is the USAGOLD 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.
curl -X GET 'https://api.parse.bot/scraper/7b4c431d-947e-4c59-84a9-86035c7e4925/get_gold_price_by_date?date=2026-07-04&metal=gold' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace usagold-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.usagold_price_api import USAGold, Metal, Commodity, Quote, DailyPrice, WeeklyPrice, LivePrice, PriceSummaryPeriod
client = USAGold()
# Get live spot prices for both metals
quote = client.quotes.get()
print(quote.gold.price, quote.gold.change, quote.gold.sign)
print(quote.silver.price, quote.silver.change, quote.silver.sign)
# Construct a commodity and get a specific date's closing price
gold = client.commodity(name=Metal.GOLD)
daily = gold.get_price_by_date(date="2026-06-02")
print(daily.date, daily.price, daily.change)
# Get all trading day prices for a month
for price in gold.get_monthly_prices(year="2026", month="5"):
print(price.date, price.price, price.change)
# Get weekly closing prices for silver
silver = client.commodity(name=Metal.SILVER)
for week in silver.get_weekly_prices(year="2026"):
print(week.date, week.price)
# Get summary statistics (Yesterday, Last Week, Last Month)
summary = gold.get_history_summary()
for period, stats in summary.items():
print(period, stats.price, stats.change)
Get the closing price for a specific date and metal. 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. Must be a trading day. |
| metal | string | Metal type to query. |
{
"type": "object",
"fields": {
"date": "string, the requested date in YYYY-MM-DD format",
"price": "string, closing price with dollar sign (e.g. '$4,489.62')",
"change": "string, daily change with sign and dollar symbol (e.g. '+$4.77') or null if unavailable"
},
"sample": {
"data": {
"date": "2026-06-02",
"price": "$4,489.62",
"change": "+$4.77"
},
"status": "success"
}
}About the USAGOLD API
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.
The USAGOLD API is a managed, monitored endpoint for usagold.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when usagold.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official usagold.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.