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.
Live Test Gold Price Grounding Data Source →
The tool
Once your client is connected to the VerveContext server, this appears in its tool list as GoldPriceGroundingData. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.
{
"name": "GoldPriceGroundingData",
"arguments": {}
}Connecting
One server URL covers every source in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.
{
"mcpServers": {
"vervecontext": {
"url": "https://api.vervecontext.com/v1/mcp"
}
}
}https://api.vervecontext.com/v1/mcpPer-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.
Arguments
These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.
| Argument | Type | Description |
|---|---|---|
currencyOptionalPremium | string | The currency to get the price in default USD |
hourlyOptionalPremium | boolean | Include hourly price data for the past 24 hours |
hourly[].hourOptional | number | UTC hour-of-day slot (0-23) the price was captured in |
hourly[].priceOptional | number | Price at that hour, in the requested currency |
hourly[].timestampOptional | string | ISO 8601 time the hourly price was captured |
What the model gets back
The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.
{
"status": "ok",
"error": null,
"data": {
"currency": "USD",
"gram": 138.63,
"kilogram": 138633.92,
"ounce": 4312,
"lastUpdated": "2026-02-07T12:00:00.000Z",
"change24h": 28.5,
"change24hPct": 0.67,
"changeDirection": "up",
"high24h": 4325,
"low24h": 4278.5,
"formatted": {
"ounce": "$4,312.00",
"gram": "$138.63",
"kilogram": "$138,633.92",
"ounceWords": "four thousand, three hundred twelve dollars",
"kilogramWords": "one hundred thirty-eight thousand, six hundred thirty-four 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 | 138.63 | Gold price per gram in specified currency |
kilogram | number | 138633.92 | Gold price per kilogram in specified currency |
ounce | number | 4312 | Gold price per troy ounce in specified currency |
lastUpdated | string | 2026-02-07T12:00:00.000Z | ISO 8601 timestamp of last price update |
change24h | number | 28.5 | Price change vs 24 hours ago in currency units |
change24hPctPremium | number | 0.67 | Percentage price change vs 24 hours ago |
changeDirection | string | up | Direction of 24h change: up, down, or unchanged |
high24hPremium | number | 4325 | Highest price in the past 24 hours |
low24hPremium | number | 4278.5 | Lowest price in the past 24 hours |
formatted | object | {…} | |
formatted.ouncePremium | string | $4,312.00 | Formatted ounce price with currency symbol |
formatted.gramPremium | string | $138.63 | Formatted gram price with currency symbol |
formatted.kilogramPremium | string | $138,633.92 | Formatted kilogram price with currency symbol |
formatted.ounceWordsPremium | string | four thousand, three hundred twelve dollars | Ounce price spelled out in words with currency |
formatted.kilogramWordsPremium | string | one hundred thirty-eight thousand, six hundred thirty-four dollars | Kilogram price spelled out in words with currency |
Why ground on it
A model can produce something that looks like this answer from its training data, and be confidently out of date or simply wrong. This source returns the current value in a shape you can check, which is the difference between an answer you can cite and one you have to hedge.
Point an evaluation at gram: it is the field most worth pinning a claim to, and it is either present and current or absent — never plausibly invented.
Failure modes
Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.
| Status | What it means |
|---|---|
400 / 422 | The arguments did not validate. The message names the offending one. |
401 | The OAuth session is invalid or expired — reconnect the server. |
403 | Blocked by a key restriction or an IP allow-list. Never a bad identity. |
404 | This source is not part of VerveContext. Check the catalog. |
429 | Out of credits, or a brief rate limit. The message tells them apart. |
A call costs 2 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.
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 Grounding Data
Set up Gold Price Grounding Data on VerveContext, or reach the same source a different way. Your VerveContext account and credits work on all of them — one key, one balance.
Related
More in Finance: