# AllRatesToday Exchange Rate & Central Bank Rates API

OpenAPI file: https://bump.sh/allratestoday/doc/allratestoday-api.json

## Description

This is version `2.2.0` of this API documentation. Last update on Nov 8, 2026.
Live mid-market exchange rates for 160+ currencies plus official rates from 123 central banks and 6 tax authorities (ECB, the Fed, Bank of Canada, CBSL, Banxico, HMRC, US Treasury and more).

## Data
- **Market rates** (`/api/rate`, `/api/v1/rates`, `/api/historical-rates`): live mid-market rates, refreshed roughly every 60 seconds.
- **Central-bank rates** (`/api/v1/central-bank/*`, `/api/open/central-bank/*`): the official tables exactly as published by each institution, one table per publication date. History reaches back to 2000 and earlier for major sources (ECB from 1999, Bank of Canada from 1950s-era series where published).
- **Daily Reference Rate** (`/api/open/reference-rate`, `/api/v1/reference-rate/*`): one immutable mid-market USD table per business day, fixed at 16:00 London (median of a five-minute sampling window). For index calculation, research and reporting; not a registered benchmark. Methodology: https://allratestoday.com/reference-rate/

## Authentication
Most endpoints require an API key sent as `Authorization: Bearer art_live_...`. Get a free key at https://allratestoday.com/register, or self-issue a 100-call trial key with no account via `POST /api/agent/keys` (built for AI agents). Logged-in dashboard users can also authenticate with their session cookie.

Keyless endpoints: `/api/v1/symbols` and `/api/open/central-bank/{bank}` (attribution required).

## Output formats
Endpoints that return tabular data accept `?format=json|csv|xml|xlsx` (CSV is UTF-8 with BOM; XLSX is a real Excel workbook; default json).

## Plans
Free plan: latest central-bank tables included. Historical central-bank dates and time series require a paid plan. See https://allratestoday.com/pricing.

## Servers

- Production: https://allratestoday.com (Production)


## Topics

### [Authentication](https://bump.sh/allratestoday/doc/allratestoday-api/authentication.md)


## Endpoints

### [Market Rates](https://bump.sh/allratestoday/doc/allratestoday-api/group/endpoint-market-rates.md)

- [Current exchange rate for one currency pair](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getrate.md)

- [Historical market rates for a currency pair](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-gethistoricalrates.md)

- [Live and historical market rates (Wise-compatible)](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getratesv1.md)

- [List supported currencies](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getsymbols.md)


### [Central Bank Rates](https://bump.sh/allratestoday/doc/allratestoday-api/group/endpoint-central-bank-rates.md)

- [List covered central banks and official sources](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-listcentralbanks.md)

- [Every bank's latest official rate for one pair](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-comparecentralbankrates.md)

- [Latest official rate table for a bank](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getcentralbanklatest.md)

- [Official rate table for a specific date](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getcentralbankbydate.md)

- [Official rate time series](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getcentralbankhistory.md)

- [Publication calendar for a bank](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getcentralbankavailability.md)

- [Catalogue of every official source — keyless](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-listopencentralbanks.md)

- [Latest official table — keyless, attribution required](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getopencentralbanklatest.md)


### [Compatibility](https://bump.sh/allratestoday/doc/allratestoday-api/group/endpoint-compatibility.md)

- [Latest ECB table in a legacy provider's JSON shape — keyless](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-compatlatest.md)

- [Dated table, date range or currency list in a legacy shape](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-compatdatedorrange.md)


### [Authentication](https://bump.sh/allratestoday/doc/allratestoday-api/group/endpoint-authentication.md)

- [How to self-issue a trial key — keyless](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-describetrialkeys.md)

- [Self-issue a 100-call trial API key — no account, no email](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-issuetrialkey.md)


### [Reference Rate](https://bump.sh/allratestoday/doc/allratestoday-api/group/endpoint-reference-rate.md)

- [Latest Daily Reference Rate (16:00 London) — keyless](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getopenreferencerate.md)

- [Latest Daily Reference Rate with window low/high and sample counts](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getreferenceratelatest.md)

- [Daily Reference Rate table for a date — paid plans](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getreferenceratebydate.md)

- [Daily Reference Rate series — paid plans, billed per month of range](https://bump.sh/allratestoday/doc/allratestoday-api/operation/operation-getreferenceratehistory.md)




[Powered by Bump.sh](https://bump.sh)
