API Specifications
Complete technical reference for the AllRatesToday Currency Data API — endpoints, authentication, parameters, response formats, SDKs, and error codes.
Version 1.0 — April 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
- SDKs & Libraries — JavaScript/TypeScript, Python, PHP, React installation and quick start
- Appendix A — Complete list of 160+ supported currencies
- Appendix B — Error codes reference table
- Appendix C — Package limit alert thresholds
- Appendix D — 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 |
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
npm install react-currency-localizer-realtime
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, and React.
The AllRatesToday API delivers real-time and historical mid-market exchange rates for over 160 world currencies, sourced from Reuters (Refinitiv) and interbank market feeds. 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 includes 300 requests per month with no credit card required, 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.