GoldPrice APIgoldprice.org ↗
Access real-time gold and silver prices, historical data back to 1972, karat breakdowns, performance periods, crypto prices, and news via the GoldPrice.org API.
What is the GoldPrice API?
This API exposes 9 endpoints covering live and historical precious metals data from GoldPrice.org. Use get_current_gold_price to retrieve a real-time gold spot price in any of eight supported currencies, complete with change amount and percentage from the prior close. Other endpoints cover silver spot prices, multi-period performance, per-gram karat pricing, country-level gold rates, gold mining stock listings, cryptocurrency market data, and precious metals news headlines.
curl -X GET 'https://api.parse.bot/scraper/8266964b-44f2-494d-861f-1715609816e4/get_current_gold_price?currency=USD' \ -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 goldprice-org-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.gold_price_api import GoldPrice, Currency, Country, SpotPrice
client = GoldPrice()
# Get live gold spot price in EUR
gold = client.spotprices.gold(currency=Currency.EUR)
print(gold.price_oz, gold.change_percent, gold.timestamp)
# Get live silver spot price in USD
silver = client.spotprices.silver(currency=Currency.USD)
print(silver.price_oz, silver.change_amount, silver.unit)
# Get gold price for India in local currency
india_price = client.spotprices.by_country(country=Country.INDIA)
print(india_price.currency, india_price.price_oz, india_price.change_percent)
# Get gold performance over multiple time periods
perf = client.performances.get(currency=Currency.USD)
print(perf.title, perf.domain)
# Get historical gold prices
history = client.pricehistories.get(currency=Currency.GBP)
print(history.metal, history.currency)
for entry in history.history:
print(entry.date, entry.price)
# Get gold price per gram with karat breakdown
gram = client.gramprices.get(currency=Currency.USD)
print(gram.price_per_gram, gram.timestamp)
# List gold mining stocks
for stock in client.goldstocks.list():
print(stock.name, stock.country, stock.url)
# List current cryptocurrency prices
for crypto in client.cryptos.list():
print(crypto.rank, crypto.name, crypto.price, crypto.change_24h)
# List latest precious metals news
for article in client.newsarticles.list():
print(article.title, article.url)
Retrieve the current live gold spot price in a specified currency. Returns price per troy ounce, change amount, change percent, and timestamp. The price updates in near real-time during market hours (NY time).
| Param | Type | Description |
|---|---|---|
| currency | string | ISO currency code for the price quote. |
{
"type": "object",
"fields": {
"unit": "string, always 'oz'",
"currency": "string, ISO currency code",
"price_oz": "number, gold price per troy ounce",
"timestamp": "string, human-readable NY time timestamp",
"change_amount": "number, price change from close",
"change_percent": "number, percentage change from close"
},
"sample": {
"data": {
"unit": "oz",
"currency": "USD",
"price_oz": 4172.98,
"timestamp": "Jun 10th 2026, 04:53:15 am NY",
"change_amount": -89.22,
"change_percent": -2.0933
},
"status": "success"
}
}About the GoldPrice API
Spot Prices and Per-Gram Karat Breakdown
The get_current_gold_price and get_current_silver_price endpoints both accept an optional currency parameter (ISO codes including USD, EUR, GBP, INR, CAD, AUD, JPY, and CHF) and return price_oz, change_amount, change_percent, and a human-readable NY-time timestamp. The get_gold_price_per_gram endpoint extends this by calculating per-gram prices across five karat grades — 24k, 22k, 18k, 14k, and 10k — derived from the live spot price, along with price_per_gram for pure gold.
Historical and Performance Data
get_gold_price_history returns an array of date/price objects going back to 1972, with each entry carrying a date (YYYY-MM-DD), a Unix timestamp, and a price in the requested currency. get_gold_price_performance provides a higher-level view: a Change array with objects for six labeled periods (Today, 30 Days, 6 Months, 1 Year, 5 Years, 20 Years), each containing an amount and a percentage. Both endpoints accept a currency parameter.
Country Prices, Stocks, Crypto, and News
get_gold_price_by_country accepts a lowercase country name from a fixed list of 19 supported countries and returns the local-currency spot price with the same price_oz, change_amount, and change_percent fields as the main spot endpoints. get_gold_stocks_prices returns a list of gold mining companies with name, country, and url fields — no numeric stock data is included. get_crypto_prices delivers a ranked list of cryptocurrencies with market_cap, price, supply, volume_24h, and change_24h as strings. get_precious_metals_news returns article title and url pairs for the latest news from GoldPrice.org.
Currency and Country Coverage
The spot and history endpoints cover eight ISO currency codes. The country endpoint supports 19 named countries; entries like "united kingdom" and "uk" resolve to the same locale. The fixed country list and currency list are not configurable beyond what the endpoints expose — any currency not in the supported set will fall back to a default.
The GoldPrice API is a managed, monitored endpoint for goldprice.org — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when goldprice.org 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 goldprice.org 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?+
- Display a live gold price ticker in a chosen currency using
price_ozandchange_percentfromget_current_gold_price. - Build a gold price chart going back decades using the
historyarray fromget_gold_price_history. - Show jewelers or consumers karat-specific gram prices using the
karatsobject fromget_gold_price_per_gram. - Compare gold performance across investment horizons by consuming the six-period
Changearray fromget_gold_price_performance. - Localize gold quotes for a specific market using
get_gold_price_by_countrywith the country's local currency in the response. - Aggregate precious metals news headlines alongside price data using
titleandurlfromget_precious_metals_news. - Monitor cryptocurrency rankings alongside gold prices using
rank,price, andchange_24hfromget_crypto_prices.
| 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.
Does GoldPrice.org offer an official developer API?+
What does `get_gold_price_performance` return, and can I request a custom time range?+
get_gold_price_history, which covers daily prices back to 1972.Does the API return silver historical price data going back to 1972?+
get_gold_price_history covers gold (XAU) only; silver has a live spot price endpoint (get_current_silver_price) but no history endpoint. You can fork this API on Parse and revise it to add a silver history endpoint.What numeric data does `get_gold_stocks_prices` expose?+
name, country, and url for each gold mining company in the list. It does not include share prices, market capitalization, or trading volume. You can fork this API on Parse and revise it to add a per-company stock detail endpoint if that data is available on the source pages.