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.3 — August 2026Document Contents
- Overview — Schema, Base URL, Authentication, API Versioning, Data Format, Timestamps
- Package Limits — Plans, monthly request quotas, rate limit headers, usage alerts
- Rate Limiting — Per-minute and monthly limits, 429 error handling
- CORS Support — Cross-origin access for browser-based applications
- Error Handling — HTTP status codes, error response format
- API Endpoints — Latest Rates, Single Pair, Historical Rates, Historical Period, Available Currencies
- Central Bank Rates API — Official rates from 102 central banks: latest tables, historical dates, time series, publication calendars, CSV export
- SDKs & Libraries — JavaScript/TypeScript, Python, PHP, React, Rust, MCP server, and 31 per-bank npm SDKs
- Appendix A — Complete list of 160+ supported currencies
- Appendix B — Covered central banks reference (codes, home currencies, npm packages)
- Appendix C — Error codes reference table
- Appendix D — Package limit alert thresholds
- 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.
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 102 central banks via the 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.