# Kitco API

> Kitco provides precious metal spot prices as a workflow and API.

Kitco returns spot bid, ask, daily change, and daily range for gold, silver, platinum, and palladium. Get precious metal prices needs a metal selection, metal unit, and currency; select one metal or all four.

- Page: https://fous.com/tools/kitco
- Handle: `@kitco`
- Category: [Finance](https://fous.com/tools/category/finance)
- Source website: https://kitco.com
- Last verified: Sep 30, 2026

## Methods

### Get precious metal prices

Operation `get_precious_metal_prices`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get Kitco spot bid, ask, daily change and range for gold, silver, platinum or palladium. Non-USD prices use Kitco exchange rates; converted daily changes use the current rate rather than an FX-adjusted prior close.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `unit` | string | no | `"gram"` | Unit of metal for each price. Example: gram. |
| `metal` | string | no | `"platinum"` | Metal to quote, or all four. Example: gold. |
| `currency` | string | no | `"Euro"` | Currency name or three-letter code supported by Kitco. Example: Canadian dollar or CAD. |

**Input schema**

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

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `prices` | array |  | One spot-price record for each selected metal. |
| `prices[].ask` | number | `48.326568` | Spot ask per unit, in the requested currency. |
| `prices[].bid` | number | `48.043625` | Spot bid per unit, in the requested currency. |
| `prices[].unit` | string | `"gram"` | Unit of metal. |
| `prices[].metal` | string | `"platinum"` | Precious metal name. |
| `prices[].change` | number | `-0.339531` | Change in spot bid per unit in the requested currency. |
| `prices[].day_low` | number | `47.958743` | Day low per unit in the requested currency. |
| `prices[].currency` | string | `"EUR"` | Three-letter currency code. |
| `prices[].day_high` | number | `50.47693` | Day high per unit in the requested currency. |
| `prices[].page_url` | string | `"https://www.kitco.com/charts/platinum"` | Kitco page for this metal. |
| `prices[].quoted_at` | string | `"2026-09-28T23:15:57.920000+00:00"` | Time of Kitco metal quote with UTC offset. |
| `prices[].change_percent` | number | `-0.701754` | Percent change in the USD spot bid. |

**Example input**

```json
{
  "unit": "gram",
  "metal": "platinum",
  "currency": "Euro"
}
```

**Example output**

```json
{
  "prices": [
    {
      "ask": 48.326568,
      "bid": 48.043625,
      "unit": "gram",
      "metal": "platinum",
      "change": -0.339531,
      "day_low": 47.958743,
      "currency": "EUR",
      "day_high": 50.47693,
      "page_url": "https://www.kitco.com/charts/platinum",
      "quoted_at": "2026-09-28T23:15:57.920000+00:00",
      "change_percent": -0.701754
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@kitco",
  "visibility": "public",
  "operation": "get_precious_metal_prices",
  "version": 1,
  "input": {
    "unit": "gram",
    "metal": "platinum",
    "currency": "Euro"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@kitco\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_precious_metal_prices\",\n  \"version\": 1,\n  \"input\": {\n    \"unit\": \"gram\",\n    \"metal\": \"platinum\",\n    \"currency\": \"Euro\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@kitco",
  "visibility": "public",
  "operation": "get_precious_metal_prices",
  "version": 1,
  "input": {
    "unit": "gram",
    "metal": "platinum",
    "currency": "Euro"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/kitco`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_precious_metal_prices`: Get precious metal prices. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-kitco https://api.fous.com/mcp/tools/kitco --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Compare spot bids and asks across precious metals
- Track daily price changes in a selected currency
- Review daily highs and lows for metal prices
- Convert metal prices to a supported currency

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Kitco tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Kitco account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from kitco.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 30, 2026.

### What is the spot ask for gold?

Get precious metal prices returns the spot ask for gold in the requested unit and currency.

### How much has silver changed today?

Get precious metal prices returns the daily change and percent change for silver.

### What are the day's high and low for platinum?

Get precious metal prices returns the day high and day low for platinum.

## Related

- [Investing.com API](https://fous.com/tools/investing-com.md): Investing.com provides financial markets data and news, economic releases up to 31 days, and current commodity prices and government bond yields, which may be delayed or indicative.
- [Kraken API](https://fous.com/tools/kraken.md): Live cryptocurrency market prices and trading statistics from Kraken.
- [Coinbase API](https://fous.com/tools/coinbase.md): Coinbase provides public cryptocurrency prices and market overviews, including changing spot, buy, and sell quotes and 24-hour statistics; unavailable page facts may be missing.
- [Trading Economics API](https://fous.com/tools/trading-economics.md): Trading Economics provides economic indicators, market data and country statistics, including country overviews, latest reported country comparisons and current commodity prices reflecting reported trading days.
- [Yahoo Finance API](https://fous.com/tools/yahoo-finance.md): Yahoo Finance provides quotes, movers, company financials, analyst ratings, earnings, news, and up to 5,000 price rows with adjusted returns; prices may be delayed.
- [Google Finance API](https://fous.com/tools/google-finance.md): Google Finance returns possibly delayed prices and figures, indexes, up to four movers timed by oldest quote, currency conversions, and up to five financial periods.
- [CoinMarketCap API](https://fous.com/tools/coinmarketcap.md): CoinMarketCap returns prices, rankings and current Fear and Greed readings; gainers and losers include up to 30 top-100 coins above $50,000 in 24-hour volume.
- [CoinGecko API](https://fous.com/tools/coingecko.md): CoinGecko returns cryptocurrency prices and histories, sector rankings and details, and trending coins; non-USD historical values cover 365 days, histories 7–365 days, and today’s prices may change.
- [All Finance tools](https://fous.com/tools/category/finance)