---
title: "Currency Data API Specifications"
description: "AllRatesToday Currency Data API technical specifications — complete REST API reference with endpoints, authentication, parameters, response formats, SDKs, error codes, and rate limiting documentation."
canonical: https://allratestoday.com/api-specifications/
source: AllRatesToday (https://allratestoday.com/) — Markdown mirror of the page above; index of all pages at https://allratestoday.com/llms.txt
generated: 2026-10-11T06:44:07.180Z
---

# API Specifications

Complete technical reference for the AllRatesToday Currency Data API — endpoints, authentication, parameters, response formats, central bank rates, SDKs, and error codes.

 Version 2.8 — September 2026    [Download PDF](https://allratestoday.com/docs/AllRatesToday-API-Specifications.pdf) [Interactive Docs](https://allratestoday.com/developers) [View on GitHub](https://github.com/AllRates-Today)

## Document Contents

1. [Overview](https://allratestoday.com/docs/AllRatesToday-API-Specifications.pdf) — Schema, Base URL, Authentication, API Versioning, Data Format, Timestamps
2. Package Limits — Plans, monthly request quotas, rate limit headers, usage alerts
3. Rate Limiting — Per-minute and monthly limits, 429 error handling
4. CORS Support — Cross-origin access for browser-based applications
5. Error Handling — HTTP status codes, error response format
6. API Endpoints — Latest Rates, Single Pair, Historical Rates, Historical Period, Available Currencies
7. Central Bank Exchange Rate API — Official rates from 121 central banks: latest tables, historical dates, time series, publication calendars, CSV export
8. SDKs & Libraries — JavaScript/TypeScript, Python, PHP, React, Rust, MCP server, and 31 per-bank npm SDKs
9. Appendix A — Complete list of 160+ supported currencies
10. Appendix B — Covered central banks reference (codes, home currencies, npm packages)
11. Appendix C — Error codes reference table
12. Appendix D — Package limit alert thresholds
13. Appendix E — API changelog

## API Endpoints Summary

| Method | Endpoint | Auth | Description |
| --- | --- | --- | --- |
| GET | `/api/v1/rates` | Required | Get latest exchange rates for one or more target currencies |
| GET | `/api/rate` | No | Simple single-pair rate lookup |
| GET | `/api/historical-rates` | Required | Historical rate data with preset periods (1d, 7d, 30d, 1y) |
| GET | `/api/v1/rates?from=&to=` | Required | Historical rates with custom date range |
| GET | `/api/v1/symbols` | No | List all 160+ supported currency codes, names, and symbols |
| GET | `/api/v1/central-banks` | Required | List all 83 covered central banks with metadata and endpoint URLs |
| GET | `/api/v1/central-bank/{bank}/latest` | Required | Latest official rate table as published by the central bank (all plans) |
| GET | `/api/v1/central-bank/{bank}/{date}` | Required | Official central bank rates for a specific date (paid plans) |
| GET | `/api/v1/central-bank/{bank}/history` | Required | Daily time series of official rates over a date range (paid plans) |
| GET | `/api/v1/central-bank/{bank}/availability` | Required | Publication calendar — the dates the bank actually published rates (all plans) |

### Authentication

Bearer token in the Authorization header. Get your free API key at [allratestoday.com/register](https://allratestoday.com/register).

 Format: `Authorization: Bearer art_live_...`

### Base URL

All authenticated API requests use:

 `https://allratestoday.com/api/v1/`

 Deployed on Cloudflare's edge network — 300+ PoPs, sub-50ms response times.

### Response Format

All responses are JSON with ISO 8601 timestamps. CORS-enabled for browser apps. Gzip compressed.

 Rate limit headers included with every response.

### Official SDKs

`npm install @allratestoday/sdk`
 `pip install allratestoday`
 `composer require allratestoday/sdk`
 `cargo add allratestoday`
 `npx -y @allratestoday/mcp-server`
 Plus 31 per-bank npm SDKs (e.g. `ecb-exchange-rate`)

## About This API Specification Document

This **AllRatesToday Currency Data API Specification** document provides the complete technical reference for integrating with the AllRatesToday exchange rate API. It covers all available **REST API endpoints**, request parameters, response formats, authentication methods, error codes, rate limiting, and official SDK documentation for **JavaScript/TypeScript, Python, PHP, React, and Rust**, plus an **MCP server** for AI assistants and 31 dedicated per-bank npm SDKs.

The AllRatesToday API delivers **real-time and historical mid-market exchange rates** for over 160 world currencies, sourced from **institutional interbank market data** — plus **official reference rates from 121 central banks** via the [Central Bank Exchange Rate API](https://allratestoday.com/central-bank-rates-api/), including the US Federal Reserve, European Central Bank, Bank of England, People's Bank of China, and Bank of Japan, with 2.9M+ historical data points and CSV export. Whether you're building a fintech application, e-commerce platform, SaaS product with multi-currency pricing, or a forex analytics dashboard, this specification document contains everything you need to integrate accurate currency data into your application.

The API is deployed on **Cloudflare's global edge network** across 300+ locations, delivering sub-50ms response times worldwide. The **free tier** requires no credit card, making it accessible for developers at any stage — from prototyping to production.

## Ready to Integrate?

Get your free API key and start building with real-time exchange rates in under 5 minutes.

  [Get Free API Key](https://allratestoday.com/register) [Interactive Docs](https://allratestoday.com/developers)