---
title: "Official rate time series"
method: GET
path: "/api/v1/central-bank/{bank}/history"
tags: ["Central Bank Rates"]
---

# Official rate time series

`GET /api/v1/central-bank/{bank}/history`

## Request

- Base URL: `https://allratestoday.com`
- URL: `https://allratestoday.com/api/v1/central-bank/{bank}/history`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `art_session`

Daily series over a date range (defaults to the last year; capped at 5000 rows — narrow the range if `truncated` is true). Use `symbol` for every published pair involving one currency, or `source`+`target` for a single resolved pair per date (cross-computed via the home currency when needed, flagged `derived`). Archives reach back to 2000 and earlier for major sources. Paid plans only.

## Path parameters

- `bank` string, required

## Query parameters

- `symbol` string
- `source` string
- `target` string
- `from` string, date
- `to` string, date
- `format` 'json' | 'csv' | 'xml' | 'xlsx'

## Response `200`

Ascending daily series

- object
  - `bank` string
  - `name` string
  - `symbol` string
  - `source` string: Present in pair mode
  - `target` string: Present in pair mode
  - `from` string, date
  - `to` string, date
  - `count` integer
  - `truncated` boolean: True when the 5000-row cap was hit
  - `rates` object[]
    - `rate_date` string, date
    - `date` string, date: Used instead of rate_date in pair mode
    - `base` string
    - `quote` string
    - `type` string
    - `value` number, double
    - `rate` number, double: Pair mode
    - `derived` boolean: Pair mode: true when not directly published
    - `method` 'published' | 'inverse' | 'cross': Pair mode
  - `disclaimer` string

## Other responses

- `400`: Invalid or missing parameters
- `401`: Authentication required — provide an API key via `Authorization: Bearer art_live_...` (free keys at https://allratestoday.com/register)
- `403`: Historical central-bank data requires a paid plan; /latest is available on all plans
- `404`: Unknown bank or pair not covered in range
- `429`: Monthly request limit exceeded (X-Monthly-Limit / X-Monthly-Used / X-Monthly-Resets headers included)

---

[API](https://skmtc.dev/allratestoday/apis/allratestoday-exchange-rate-central-bank-rates-api.md) · [All operations](https://skmtc.dev/allratestoday/apis/allratestoday-exchange-rate-central-bank-rates-api/llms.txt) · [OpenAPI document](https://skmtc.dev/allratestoday/apis/allratestoday-exchange-rate-central-bank-rates-api/revisions/c2e58e9b4da4?raw)