Overview
The API polls live precious metal markets and delivers spot rates across troy ounces, grams, and kilograms. By default, responses return quotes in USD with 24-hour price change amounts and directional trends. Upgrading to a paid plan lets you convert prices into 172 world currencies, view 24-hour high and low ranges, or pull 24 hours of hourly price snapshots.
Live Test Platinum Price Grounding Data Source →
The tool
Once your client is connected to the VerveContext server, this appears in its tool list as PlatinumPriceGroundingData. 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": "PlatinumPriceGroundingData",
"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 |
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": 51.62,
"kilogram": 51617.99,
"ounce": 1605.5,
"lastUpdated": "2026-02-07T12:00:00.000Z",
"change24h": 12.3,
"change24hPct": 0.77,
"changeDirection": "up",
"high24h": 1618,
"low24h": 1592.4,
"formatted": {
"ounce": "$1,605.50",
"gram": "$51.62",
"kilogram": "$51,617.99",
"ounceWords": "one thousand, six hundred six dollars",
"kilogramWords": "fifty-one thousand, six hundred eighteen 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 | 51.62 | Platinum price per gram in specified currency |
kilogram | number | 51617.99 | Platinum price per kilogram in specified currency |
ounce | number | 1605.5 | Platinum price per troy ounce in specified currency |
lastUpdated | string | 2026-02-07T12:00:00.000Z | ISO 8601 timestamp of last price update |
change24h | number | 12.3 | Price change vs 24 hours ago in currency units |
change24hPctPremium | number | 0.77 | Percentage price change vs 24 hours ago |
changeDirection | string | up | Direction of 24h change: up, down, or unchanged |
high24hPremium | number | 1618 | Highest price in the past 24 hours |
low24hPremium | number | 1592.4 | Lowest price in the past 24 hours |
formatted | object | {…} | Prices formatted for display with the currency symbol and in words |
formatted.ouncePremium | string | $1,605.50 | Formatted ounce price with currency symbol |
formatted.gramPremium | string | $51.62 | Formatted gram price with currency symbol |
formatted.kilogramPremium | string | $51,617.99 | Formatted kilogram price with currency symbol |
formatted.ounceWordsPremium | string | one thousand, six hundred six dollars | Ounce price spelled out in words with currency |
formatted.kilogramWordsPremium | string | fifty-one thousand, six hundred eighteen 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 Inventory Valuation
- When revaluing finished jewelry stock, retail catalog systems calculate replacement costs based on spot platinum prices per gram.
- Bullion Checkout Rates
- Bullion dealers lock in customer checkout totals by converting ounce rates into local purchase prices right before payment capture.
- Scrap Metal Intake
- Price scrap catalytic converters accurately by referencing live per-kilogram platinum values and day-over-day change directions during intake.
- Commodities Portfolio Tracking
- To monitor precious metal allocations, wealth management dashboards track spot rates and 24-hour price shifts to calculate daily asset swings.
Other ways to use Platinum Price Grounding Data
Set up Platinum 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: