# Kitco API: Get precious metal prices

> Gets Kitco spot bid, ask, daily change and range for gold, silver, platinum or palladium. Non-USD prices use Kitco's current exchange rate, so converted daily changes are not adjusted for exchange-rate moves since the prior close.

Unofficial. Not affiliated with or endorsed by Kitco.

- Page: https://fous.com/methods/kitco.com/get-precious-metal-prices
- Method: `kitco.com/get_precious_metal_prices`, version 1
- Website: kitco.com
- Returns: metal, bid, ask, change, change percent, day low/high, unit, currency, quote time, page URL
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `unit` | string | no | `"troy_ounce"` | Unit of metal for each price. Example: gram. One of "troy_ounce", "gram", "kilogram". Default "troy_ounce". |
| `metal` | string | no | `"all"` | Metal to quote, or all four. Example: gold. One of "all", "gold", "silver", "platinum", "palladium". Default "all". |
| `currency` | string | no | `"USD"` | Currency name or three-letter code supported by Kitco. Example: Canadian dollar or CAD. Default "USD". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "unit": "troy_ounce",
  "metal": "all",
  "currency": "USD"
}
```

Its output:

```json
{
  "prices": [
    {
      "ask": 4024,
      "bid": 4022,
      "unit": "troy_ounce",
      "metal": "gold",
      "change": -1.3,
      "day_low": 3986.1,
      "currency": "USD",
      "day_high": 4040.2,
      "page_url": "https://www.kitco.com/charts/gold",
      "quoted_at": "2026-10-23T05:52:00.127000+00:00",
      "change_percent": -0.032312
    },
    {
      "ask": 53.984,
      "bid": 53.734,
      "unit": "troy_ounce",
      "metal": "silver",
      "change": -0.736,
      "day_low": 53.351,
      "currency": "USD",
      "day_high": 55.754,
      "page_url": "https://www.kitco.com/charts/silver",
      "quoted_at": "2026-10-23T05:51:00.180000+00:00",
      "change_percent": -1.351202
    },
    {
      "ask": 1565,
      "bid": 1555,
      "unit": "troy_ounce",
      "metal": "platinum",
      "change": -4,
      "day_low": 1549,
      "currency": "USD",
      "day_high": 1581,
      "page_url": "https://www.kitco.com/charts/platinum",
      "quoted_at": "2026-10-23T05:53:00.200000+00:00",
      "change_percent": -0.256575
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"kitco.com/get_precious_metal_prices","input":{"unit":"troy_ounce","metal":"all","currency":"USD"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What is the current gold spot price per troy ounce in US dollars?
- Show me today's silver bid and ask in grams, priced in Canadian dollars
- I need the platinum day high and low per kilogram on kitco.com
- Can you give me palladium's daily change and percent change in euros?
- Get all four precious metals quoted per gram in USD with the quote time

## Input schema

```json
{
  "type": "object",
  "required": [],
  "properties": {
    "unit": {
      "enum": [
        "troy_ounce",
        "gram",
        "kilogram"
      ],
      "type": "string",
      "default": "troy_ounce",
      "description": "Unit of metal for each price. Example: gram."
    },
    "metal": {
      "enum": [
        "all",
        "gold",
        "silver",
        "platinum",
        "palladium"
      ],
      "type": "string",
      "default": "all",
      "description": "Metal to quote, or all four. Example: gold."
    },
    "currency": {
      "type": "string",
      "default": "USD",
      "description": "Currency name or three-letter code supported by Kitco. Example: Canadian dollar or CAD."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "prices"
  ],
  "properties": {
    "prices": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ask": {
            "type": "number"
          },
          "bid": {
            "type": "number"
          },
          "unit": {
            "type": "string"
          },
          "metal": {
            "type": "string"
          },
          "change": {
            "type": "number"
          },
          "day_low": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "day_high": {
            "type": "number"
          },
          "page_url": {
            "type": "string"
          },
          "quoted_at": {
            "type": "string"
          },
          "change_percent": {
            "type": "number"
          }
        }
      }
    }
  }
}
```

## See more

- [Investing.com API: Get commodity prices](https://fous.com/methods/investing.com/get-commodity-prices.md): Gets current quoted prices for energy, metals, and agricultural commodities from Investing.com's real-time futures page, optionally for one commodity. Some quotes may be delayed or indicative; units are null when the contract specification is missing.
- [Kraken API: Get coin price](https://fous.com/methods/kraken.com/get-coin-price.md): Gets a coin's current Kraken price, bid and ask, and 24-hour trading statistics in a chosen currency, with change since today's midnight UTC open.
- [Trading Economics API: Get commodity prices](https://fous.com/methods/tradingeconomics.com/get-commodity-prices.md): Gets current commodity prices and price movements from the Trading Economics commodities page, in the page's group order; filter by a commodity name, slug, symbol or group (e.g. copper, energy), or leave blank for all groups including Electricity.
- [Macrotrends API: Get long-term price history](https://fous.com/methods/macrotrends.net/get-long-term-price-history.md): Gets decades of yearly commodity or stock-index price history from Macrotrends: yearly average, open, high, low, close, annual change and inflation-adjusted value for gold, silver, crude oil, natural gas, copper, Dow Jones, S&P 500 and Nasdaq. The current year may be incomplete.
- [Google API: Get quote](https://fous.com/methods/google.com/get-quote.md): Gets the current quoted price and key figures for a stock, fund, index, or cryptocurrency on Google Finance, by name or ticker. Prices may be delayed, and figures Google does not show are null.
- [Twelve Data API: Get quote](https://fous.com/methods/twelvedata.com/get-quote.md): Gets the latest stock, ETF, forex or crypto quote for a symbol from Twelve Data. Some instruments do not report currency or volume; the demo key covers only a few symbols.
- [CoinMarketCap API: Get coin price](https://fous.com/methods/coinmarketcap.com/get-coin-price.md): Gets a cryptocurrency's price, changes, supply, market cap, volume and all-time high in a chosen currency. If a name or symbol is shared, returns the coin with the largest market cap.
- [CoinGecko API: Get coin price history](https://fous.com/methods/coingecko.com/get-coin-price-history.md): Gets a coin's daily prices and price change over the last 7, 30, 90 or 365 days, with UTC dates. Today's price may change.
