goldprice.org 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.
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'
Retrieve the current live gold spot price in a specified currency. Returns price per troy ounce, change amount, change percent, and timestamp.
| Param | Type | Description |
|---|---|---|
| currency | string | ISO currency code for the price quote (e.g. USD, EUR, GBP, INR, CAD, AUD, JPY, CHF). |
{
"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": 4554.3,
"timestamp": "May 15th 2026, 08:52:45 am NY",
"change_amount": -123.06,
"change_percent": -2.631
},
"status": "success"
}
}About the goldprice.org 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.
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.
- 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 | 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.
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.