---
title: "Price history for a metal"
method: GET
path: "/v1/history/{symbol}"
tags: ["History"]
---

# Price history for a metal

`GET /v1/history/{symbol}`

## Request

- Base URL: `https://api.metalcharts.org`
- URL: `https://api.metalcharts.org/v1/history/{symbol}`
- Auth: none declared

Historical price series for a metal. Symbols are the metal codes, not names: XAU (gold), XAG (silver), XPT (platinum), XPD (palladium), HG (copper), plus ALI, NI, ZN, PB, SN, JBP, LC and UXA. `GOLD` is not valid here; it belongs to /v1/markets. Use the range parameter (for example 1M, 6M, 1Y or ALL; MAX is accepted as a synonym for ALL) or a start date to set the window; start overrides range, and end (used only with start) defaults to now. interval picks the candle size. Supported intervals are 15m, 30m, 45m, 1h, 2h, 4h, 8h, 1d, 1w and 1M; intraday intervals read the interval candle tables and 1w/1M are aggregated from daily candles. Prices are in US dollars per the market's own unit unless currency, unit or karat say otherwise; each point is converted at the ECB reference rate in force on its date (FX history starts 1999-01-04, and earlier points are left out of a converted series). The response states the currency and unit it is in.

## Path parameters

- `symbol` string, required

## Query parameters

- `range` string
- `interval` string
- `start` string
- `end` string
- `currency` string: ISO 4217 code to quote in. Default USD. One of: USD, EUR, GBP, JPY, CHF, AUD, CAD, CNY, INR, SGD, HKD, NZD, SEK, NOK, DKK, MXN, BRL, ZAR, TRY, PLN, CZK, HUF, RON, ISK, ILS, KRW, IDR, MYR, PHP, THB, AED, SAR.
- `unit` string: Mass unit to quote per: toz, g, kg, lb, mt, tola (toz is the troy ounce; oz is accepted as an alias). Default: the market's own unit.
- `karat` string: Gold only: price 24, 23, 22, 21, 20, 18, 16, 15, 14, 12, 10, 9, 8-karat gold at nominal purity karat/24 (24K is the spot price).

## Response `200`

OHLC series, oldest first.

- object
  - `success` boolean, required
  - `data` object[], required
    - `timestamp` string, date-time, required
    - `price` number, required: Same as close. Kept for older consumers.
    - `open` number, required
    - `high` number, required
    - `low` number, required
    - `close` number, required
    - `volume` number, required: 0 where the source publishes no volume.
  - `symbol` string, required
  - `range` string, required
  - `startDate` string, required
  - `endDate` string, required
  - `count` number, required
  - `source` string, required
  - `exchange` string
  - `_rid` string: Request id, for support.

## Other responses

- `400`: Invalid range, interval or symbol.
- `403`: Requested history exceeds the plan's limit.

---

[API](https://skmtc.dev/metalcharts/apis/metalcharts-api.md) · [All operations](https://skmtc.dev/metalcharts/apis/metalcharts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metalcharts/apis/metalcharts-api/revisions/53d6a0af0479?raw)