---
title: "GET /api/historical/timeseries"
method: GET
path: "/api/historical/timeseries"
tags: ["Historical Currency"]
---

# GET /api/historical/timeseries

`GET /api/historical/timeseries`

## Request

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

Get time series data for a date range with optional amount conversion (max 5 years)

## Query parameters

- `api_key` string, required
- `start_date` string, required
- `end_date` string, required
- `amount` number
- `base` string
- `format` 'json' | 'xml' | 'csv' | 'tsv'
- `callback` string
- `currencies` 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
- `429`: Rate limit exceeded (50 requests per hour)
- `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)