Overview
A gold rate API for apps and stores that show the live gold price. Requests retrieve real-time spot gold valuations denominated in USD across ounce, gram, and kilogram weights, accompanied by 24-hour change values and price direction. Paid tiers can query prices across 172 currency codes, retrieve 24-hour high and low ranges, and include hourly price snapshots spanning the preceding day. The last 30 daily closes are stored too: paid plans get the 7- and 30-day change and the 30-day high, low, average and volatility, and daily=true returns the closes themselves.
Endpoint
One host, one path per API. The block below shows this call in four languages; every one of them is the same HTTP request. Making requests covers the timeouts, retries and parameter rules that apply to all of them. The SDKs wrap the same call in a typed client.
curl "https://api.apiverve.com/v1/goldprice?currency=USD&hourly=true&daily=true" \
-H "x-api-key: your_api_key_here"const res = await fetch('https://api.apiverve.com/v1/goldprice?currency=USD&hourly=true&daily=true', {
headers: { 'x-api-key': 'your_api_key_here' },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data } = await res.json();
console.log(data);import requests
res = requests.get(
"https://api.apiverve.com/v1/goldprice?currency=USD&hourly=true&daily=true",
headers={"x-api-key": "your_api_key_here"},
timeout=15,
)
res.raise_for_status()
print(res.json()["data"])package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/goldprice?currency=USD&hourly=true&daily=true", nil)
req.Header.Set("x-api-key", "your_api_key_here")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}Replace your_api_key_here with the key from your dashboard. When the inputs arrive as a list rather than one at a time, batch requests run up to 200 of them through this same API in a single call.
Authentication
Send your key in the x-api-key header. That is the only auth step — there is no token exchange and no per-endpoint scope to configure. Authentication covers creating, rotating and revoking keys.
A 401 means the key is missing, invalid or expired. A 403 means the key is valid but not permitted here — blocked by a key restriction or an IP allow-list. Running out of credits is a 429.
Parameters
Sent in the query string. Premium parameters are accepted on every plan but only take effect on plans that include them.
| Parameter | Type | Description |
|---|---|---|
currencyOptionalPremium | string | The currency to get the price in default USD |
hourlyOptionalPremium | boolean | Include hourly price data for the past 24 hours |
dailyOptionalPremium | boolean | Include the daily closing price per ounce for the last 30 days |
Response
Every API returns the same three top-level keys, so one response handler covers your whole integration: status, error and data. Only data changes shape. Response format covers the envelope, the other output formats and how premium fields are withheld.
{
"status": "ok",
"error": null,
"data": {
"currency": "USD",
"gram": 129.25,
"kilogram": 129251.92,
"ounce": 4020.19,
"lastUpdated": "2026-10-27T12:00:00.000Z",
"change24h": 11.88,
"change24hPct": 0.3,
"changeDirection": "up",
"high24h": 4020.19,
"low24h": 4008.31,
"change7d": -102.49,
"change7dPct": -2.49,
"change30d": -265.95,
"change30dPct": -6.2,
"high30d": 4198.91,
"low30d": 3993.62,
"average30d": 4132.9,
"volatility30d": 0.7777,
"daily": [
{
"date": "2026-09-28",
"price": 4198.34
},
{
"date": "2026-09-29",
"price": 4129.1
},
{
"date": "2026-09-30",
"price": 4181.49
},
{
"date": "2026-10-01",
"price": 4182.57
},
{
"date": "2026-10-02",
"price": 4185.41
},
{
"date": "2026-10-03",
"price": 4137.55
},
{
"date": "2026-10-04",
"price": 4137.54
},
{
"date": "2026-10-05",
"price": 4131.88
},
{
"date": "2026-10-06",
"price": 4122.7
},
{
"date": "2026-10-07",
"price": 4132.77
},
{
"date": "2026-10-08",
"price": 4125.82
},
{
"date": "2026-10-09",
"price": 4198.91
},
{
"date": "2026-10-10",
"price": 4195.82
},
{
"date": "2026-10-11",
"price": 4195.81
},
{
"date": "2026-10-12",
"price": 4186.27
},
{
"date": "2026-10-13",
"price": 4188.41
},
{
"date": "2026-10-14",
"price": 4158.44
},
{
"date": "2026-10-15",
"price": 4144.7
},
{
"date": "2026-10-16",
"price": 4182.94
},
{
"date": "2026-10-17",
"price": 4164.68
},
{
"date": "2026-10-18",
"price": 4164.67
},
{
"date": "2026-10-19",
"price": 4180.55
},
{
"date": "2026-10-20",
"price": 4122.68
},
{
"date": "2026-10-21",
"price": 4120.33
},
{
"date": "2026-10-22",
"price": 4091.63
},
{
"date": "2026-10-23",
"price": 4010.3
},
{
"date": "2026-10-24",
"price": 3993.62
},
{
"date": "2026-10-25",
"price": 3993.62
},
{
"date": "2026-10-26",
"price": 4008.31
},
{
"date": "2026-10-27",
"price": 4020.19
}
],
"marketStatus": "open",
"karatGram": {
"24k": 129.25,
"22k": 118.48,
"21k": 113.09,
"18k": 96.94,
"14k": 75.4,
"10k": 53.85
},
"formatted": {
"ounce": "$4,020.19",
"gram": "$129.25",
"kilogram": "$129,251.92",
"ounceWords": "four thousand, twenty dollars",
"kilogramWords": "one hundred twenty-nine thousand, two hundred fifty-two dollars"
}
}
}
Response fields
Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.
| Field | Type | Example | Description |
|---|---|---|---|
currency | string | "USD" | ISO 4217 currency code for price values |
gram | number | 129.25 | Gold price per gram in specified currency |
kilogram | number | 129251.92 | Gold price per kilogram in specified currency |
ounce | number | 4020.19 | Gold price per troy ounce in specified currency |
lastUpdated | string | "2026-10-27T12:00:00.000Z" | ISO 8601 timestamp of last price update |
change24h | number | 11.88 | Price change vs 24 hours ago in currency units |
change24hPctPremium | number | 0.3 | Percentage price change vs 24 hours ago |
changeDirection | string | "up" | Direction of 24h change: up, down, or unchanged |
high24hPremium | number | 4020.19 | Highest price in the past 24 hours |
low24hPremium | number | 4008.31 | Lowest price in the past 24 hours |
change7dPremium | number | -102.49 | Change in the ounce price over the last 7 days, in the requested currency; null until a close from then is stored |
change7dPctPremium | number | -2.49 | Percent change in the ounce price over the last 7 days; null until a close from then is stored |
change30dPremium | number | -265.95 | Change in the ounce price over the last 30 days, in the requested currency; null until a close from then is stored |
change30dPctPremium | number | -6.2 | Percent change in the ounce price over the last 30 days; null until a close from then is stored |
high30dPremium | number | 4198.91 | Highest daily close per ounce over the last 30 days, in the requested currency; null until two days are stored |
low30dPremium | number | 3993.62 | Lowest daily close per ounce over the last 30 days, in the requested currency; null until two days are stored |
average30dPremium | number | 4132.9 | Mean daily close per ounce over the last 30 days, in the requested currency; null until two days are stored |
volatility30dPremium | number | 0.7777 | Standard deviation of the daily percent changes over the last 30 days (not annualized); null until two days are stored |
dailyPremium | array[30] | Gold's daily closes per ounce for the last 30 days, oldest first (when daily=true). Today's row is the latest price | |
datePremium | string | "2026-09-28" | UTC date of the close (YYYY-MM-DD) |
pricePremium | number | 4198.34 | Closing price per ounce, converted at that day's exchange rate |
marketStatus | string | "open" | open or closed by regular spot trading hours (Sunday 18:00 to Friday 17:00 New York time, daily 17:00-18:00 break); exchange holidays are not reflected |
karatGramPremium | object | {...} | Gold value per gram by karat in the requested currency, at the purity fraction (karat / 24) of the spot gram price |
24kPremium | number | 129.25 | Price per gram of 24-karat gold (pure, equal to gram) |
22kPremium | number | 118.48 | Price per gram of 22-karat gold (91.7%) |
21kPremium | number | 113.09 | Price per gram of 21-karat gold (87.5%) |
18kPremium | number | 96.94 | Price per gram of 18-karat gold (75%) |
14kPremium | number | 75.4 | Price per gram of 14-karat gold (58.3%) |
10kPremium | number | 53.85 | Price per gram of 10-karat gold (41.7%) |
formatted | object | {...} | |
ouncePremium | string | "$4,020.19" | Formatted ounce price with currency symbol |
gramPremium | string | "$129.25" | Formatted gram price with currency symbol |
kilogramPremium | string | "$129,251.92" | Formatted kilogram price with currency symbol |
ounceWordsPremium | string | "four thousand, twenty dollars" | Ounce price spelled out in words with currency |
kilogramWordsPremium | string | "one hundred twenty-nine thousand, two hundred fifty-two dollars" | Kilogram price spelled out in words with currency |
Errors
Read the HTTP status first, then error for the specific reason. The body names the parameter that has to change. Error handling covers the full status list and which of them are worth retrying.
| Status | Meaning | What to do |
|---|---|---|
400 | Input was rejected | Read error; it names the parameter. |
401 | Key missing or invalid | Check the header name and the key value. |
403 | Key valid, but not permitted | A key restriction or IP allow-list; see key scoping. |
429 | Rate limited, or out of credits | Read error to tell them apart; see rate limits. |
Use cases
- Jewelry Store Pricing
- E-commerce jewelers adjust retail bullion and custom jewelry checkout prices dynamically based on live gold rates per gram.
- Portfolio Asset Valuation
- Wealth tracking dashboards recalculate physical precious metal portfolio balances by multiplying recorded gold ounces against incoming spot rates.
- Pawn Shop Appraisals
- When customers bring in scrap scrap gold, collateral loan software pulls the latest kilogram and gram benchmarks to calculate fair lending values.
- Trading Alert Triggers
- Market watch bots monitor 24-hour change direction and absolute price shifts to push notifications when bullion moves significantly.
Other ways to use Gold Price
Set up Gold Price on APIVerve, or reach the same source a different way. Your APIVerve account and credits work on all of them — one key, one balance.
Related
More in Finance: