Docs/Skills/Live Gold Price Skill

Live Gold Price Skill

Get Current Gold Price

OperationalCredits 2 per callp50 224msFinance

Overview

A gold price API with a free plan, for apps and stores that show the live gold spot price. The Free plan returns the USD spot price per ounce, gram and kilogram with the 24-hour change. 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.

Live Test Live Gold Price Skill Skill →

The tool

Once your client is connected to the VerveKit server, this appears in its tool list as LiveGoldPriceSkill. 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.

Tool call
{
  "name": "LiveGoldPriceSkill",
  "arguments": {}
}

Connecting

One server URL covers every skill 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": {
    "vervekit": {
      "url": "https://api.vervekit.com/v1/mcp"
    }
  }
}

Per-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.

ArgumentTypeDescription
currencyOptionalPremiumstringThe currency to get the price in
default USD
hourlyOptionalPremiumbooleanInclude hourly price data for the past 24 hours
dailyOptionalPremiumbooleanInclude the daily closing price per ounce for the last 30 days

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.

Result
{
  "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.

FieldTypeExampleDescription
currencystringUSDISO 4217 currency code for price values
gramnumber129.25Gold price per gram in specified currency
kilogramnumber129251.92Gold price per kilogram in specified currency
ouncenumber4020.19Gold price per troy ounce in specified currency
lastUpdatedstring2026-10-27T12:00:00.000ZISO 8601 timestamp of last price update
change24hnumber11.88Price change vs 24 hours ago in currency units
change24hPctPremiumnumber0.3Percentage price change vs 24 hours ago
changeDirectionstringupDirection of 24h change: up, down, or unchanged
high24hPremiumnumber4020.19Highest price in the past 24 hours
low24hPremiumnumber4008.31Lowest price in the past 24 hours
change7dPremiumnumber-102.49Change in the ounce price over the last 7 days, in the requested currency; null until a close from then is stored
change7dPctPremiumnumber-2.49Percent change in the ounce price over the last 7 days; null until a close from then is stored
change30dPremiumnumber-265.95Change in the ounce price over the last 30 days, in the requested currency; null until a close from then is stored
change30dPctPremiumnumber-6.2Percent change in the ounce price over the last 30 days; null until a close from then is stored
high30dPremiumnumber4198.91Highest daily close per ounce over the last 30 days, in the requested currency; null until two days are stored
low30dPremiumnumber3993.62Lowest daily close per ounce over the last 30 days, in the requested currency; null until two days are stored
average30dPremiumnumber4132.9Mean daily close per ounce over the last 30 days, in the requested currency; null until two days are stored
volatility30dPremiumnumber0.7777Standard deviation of the daily percent changes over the last 30 days (not annualized); null until two days are stored
dailyPremiumarray[30]Gold's daily closes per ounce for the last 30 days, oldest first (when daily=true). Today's row is the latest price
daily.0.datePremiumstring2026-09-28UTC date of the close (YYYY-MM-DD)
daily.0.pricePremiumnumber4198.34Closing price per ounce, converted at that day's exchange rate
marketStatusstringopenopen 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
karatGramPremiumobject{…}Gold value per gram by karat in the requested currency, at the purity fraction (karat / 24) of the spot gram price
karatGram.24kPremiumnumber129.25Price per gram of 24-karat gold (pure, equal to gram)
karatGram.22kPremiumnumber118.48Price per gram of 22-karat gold (91.7%)
karatGram.21kPremiumnumber113.09Price per gram of 21-karat gold (87.5%)
karatGram.18kPremiumnumber96.94Price per gram of 18-karat gold (75%)
karatGram.14kPremiumnumber75.4Price per gram of 14-karat gold (58.3%)
karatGram.10kPremiumnumber53.85Price per gram of 10-karat gold (41.7%)
formattedobject{…}
formatted.ouncePremiumstring$4,020.19Formatted ounce price with currency symbol
formatted.gramPremiumstring$129.25Formatted gram price with currency symbol
formatted.kilogramPremiumstring$129,251.92Formatted kilogram price with currency symbol
formatted.ounceWordsPremiumstringfour thousand, twenty dollarsOunce price spelled out in words with currency
formatted.kilogramWordsPremiumstringone hundred twenty-nine thousand, two hundred fifty-two dollarsKilogram price spelled out in words with currency

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.

StatusWhat it means
400 / 422The arguments did not validate. The message names the offending one.
401The OAuth session is invalid or expired — reconnect the server.
403Blocked by a key restriction or an IP allow-list. Never a bad identity.
404This skill is not part of VerveKit. Check the catalog.
429Out 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.

Supported Currencies

170+ world currencies supported including fiat currencies, cryptocurrencies, and precious metals.

CodeCurrencyRegion
AEDUAE DirhamUnited Arab Emirates
AFNAfghan AfghaniAfghanistan
ALLAlbanian LekAlbania
AMDArmenian DramArmenia
ANGNetherlands Antillean GuilderCuraçao
AOAAngolan KwanzaAngola
ARSArgentine PesoArgentina
AUDAustralian DollarAustralia
AWGAruban FlorinAruba
AZNAzerbaijani ManatAzerbaijan
BAMBosnia-Herzegovina Convertible MarkBosnia and Herzegovina
BBDBarbadian DollarBarbados

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 Live Gold Price Skill

Set up Live Gold Price Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.

Call it as a REST APIOne HTTPS endpoint and an x-api-key header, with SDKs for Node, Python and .NET.APIVerve →Reference →
Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheets →Reference →
Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.VerveContext →Reference →

More in Finance:

Live Palladium Price SkillGet Current Palladium PriceLive Platinum Price SkillGet Current Platinum PriceLive Silver Price SkillGet Current Silver PriceLoan Payment Calculator SkillCalculate loan paymentsMarket Hours SkillGet stock market open timesMinimum Wage SkillFederal and State Minimum Wage Rates
Was this page helpful?