History

Price history for a metal

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.

get/v1/history/{symbol}

Request

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

Path parameters

symbolstring required

Query parameters

rangestring
intervalstring
startstring
endstring
currencystring

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.

unitstring

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.

karatstring

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

OHLC series, oldest first.

successboolean required
symbolstring required
rangestring required
startDatestring required
endDatestring required
countnumber required
sourcestring required
exchangestring
_ridstring

Request id, for support.

Changes

No recorded changes to this operation across all 1 revision of this API.