---
title: "GET /api/commodities/historical/timeseries"
method: GET
path: "/api/commodities/historical/timeseries"
tags: ["Commodity"]
---

# GET /api/commodities/historical/timeseries

`GET /api/commodities/historical/timeseries`

## Request

- Base URL: `https://api.unirateapi.com`
- URL: `https://api.unirateapi.com/api/commodities/historical/timeseries`
- Auth: none declared
- TypeScript: <https://skmtc.dev/unirateapi/apis/unirate-api/docs/api/commodities/historical/timeseries/get.ts> (a function with typed inputs; its response is checked against the schema)

Get commodity time series data for a date range with optional amount conversion (max 5 years, Pro subscription required). Precious metals history back to 1968 (gold/silver) and 1990 (platinum/palladium); energy, base-metal and agricultural history accrues daily from 2026-08. 19 commodities: gold, silver, platinum, palladium (troy oz); WTI and Brent crude (barrel), US Henry Hub natural gas (MMBtu); copper, aluminium, zinc, nickel, lead, tin (tonne); wheat, corn (tonne), coffee, sugar, cocoa, cotton (kg). Precious metals are blended live from LBMA and market feeds; energy, base metals and agriculturals are World Bank reference prices (CC BY 4.0, attribution: The World Bank).

## Query parameters

- `api_key` string, required
- `start_date` string, required
- `end_date` string, required
- `amount` number
- `symbols` string
- `format` 'json' | 'xml' | 'csv' | 'tsv'
- `callback` string

## Response `200`

Time series data retrieved successfully.

## Other responses

- `400`: Missing parameters, invalid date format, or date range exceeds 5 years
- `401`: Missing or invalid API key
- `403`: Pro subscription required
- `500`: Unable to retrieve time series data

---

[API](https://skmtc.dev/unirateapi/apis/unirate-api.md) - [All operations](https://skmtc.dev/unirateapi/apis/unirate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unirateapi/apis/unirate-api/revisions/e5fd92902326?raw)