API 文档
将实时货币汇率集成到您的应用程序所需的一切。
概述
AllRatesToday API 通过简单的 REST 接口提供实时和历史货币汇率。所有响应均为 JSON 格式。基础 URL 为：
https://allratestoday.com免费注册即可获取 API 密钥，访问认证端点。提供免费层级。
认证
请将您的 API 密钥作为 Bearer 令牌包含在请求中：
Authorization: Bearer YOUR_API_KEY登录后，从您的个人资料页面获取 API 密钥。
速率限制
配额响应头仅在
429 响应中返回
成功响应不会包含 X-RateLimit-* 或 X-Monthly-*，请勿依赖 200 响应来读取剩余配额。超限时返回 X-Monthly-Limit、X-Monthly-Used 和 X-Monthly-Resets。没有 Retry-After 响应头，请使用响应体中的 resets_at。
| 方案 | 月请求量 | 速率 | 认证 | 价格 |
|---|---|---|---|---|
| Free | 总共 300 次（终身，不重置） | — | API 密钥 | 免费 |
| Small | 5,000 / 月 | — | API 密钥 | 查看定价 |
| Medium | 10,000 / 月 | — | API 密钥 | 查看定价 |
| Large | 100,000 / 月 | — | API 密钥 | 查看定价 |
免费方案为终身总计 300 次请求，而非每月 300 次；付费方案在每月 1 日 00:00 UTC 重置。历史数据按数据量计费：period=1y 计为 12 次请求。使用 target=EUR,GBP,JPY 的一次调用仍只计 1 次请求。用量达到 90% 时会发送提醒邮件。完整说明见英文文档。
查看定价
认证汇率
GET /api/v1/rates
具有更高速率限制的认证端点。需要 Bearer 令牌。
| 参数 | 类型 | 描述 |
|---|---|---|
| source可选 | string | 源货币代码（例如 USD） |
| target可选 | string | 目标货币代码（例如 EUR） |
| time可选 | ISO 8601 | 特定时间点的汇率 |
| from可选 | YYYY-MM-DD | 历史范围的开始日期 |
| to可选 | YYYY-MM-DD | 历史范围的结束日期 |
| group可选 | string | 分组方式：day、hour、minute |
示例：
curl "https://allratestoday.com/api/v1/rates?source=USD&target=EUR" \
-H "Authorization: Bearer YOUR_API_KEY"响应：
[
{
"rate": 0.9215,
"source": "USD",
"target": "EUR",
"time": "2026-04-03T12:00:00Z"
}
]简单汇率
GET /api/rate
用于获取单个货币对汇率的轻量级端点。
| 参数 | 类型 | 描述 |
|---|---|---|
| source必需 | string | 源货币代码 |
| target必需 | string | 目标货币代码 |
curl "https://allratestoday.com/api/rate?source=GBP&target=USD"{ "rate": 1.2634, "source": "interbank" }历史汇率
GET /api/historical-rates
获取历史汇率数据，用于图表和分析。
| 参数 | 类型 | 描述 |
|---|---|---|
| source必需 | string | 源货币代码 |
| target必需 | string | 目标货币代码 |
| period可选 | string | 1d、7d、30d 或 1y（默认：7d） |
curl "https://allratestoday.com/api/historical-rates?source=USD&target=EUR&period=30d" \
-H "Authorization: Bearer YOUR_API_KEY"{
"source": "USD",
"target": "EUR",
"data": [
{ "date": "2026-03-04", "rate": 0.9198, "timestamp": 1741046400000 },
{ "date": "2026-03-05", "rate": 0.9210, "timestamp": 1741132800000 }
],
"source_api": "interbank",
"period": "30d"
}央行汇率
24 家央行（欧洲央行、美联储、英格兰银行、中国人民银行、斯里兰卡央行等）发布的官方汇率 — 税务、海关、审计与合规开票所需的固定、可引用汇率。详见概览与各银行页面、英文完整文档和交互式 API 参考。
GET /api/v1/central-banks— 覆盖的央行列表（所有套餐）GET /api/v1/central-bank/{bank}/latest— 最新汇率表或货币对?source=&target=（所有套餐）GET /api/v1/central-bank/{bank}/{YYYY-MM-DD}— 任意日期（如发票日期）的汇率表（付费套餐）GET /api/v1/central-bank/{bank}/history— 每日时间序列，最多 5,000 行（付费套餐）GET /api/v1/central-bank/{bank}/availability— 银行的发布日历（所有套餐）
/latest、/history 和 /availability 支持 ?format=csv。每个响应带有银行自己的发布日期（rate_date）；由汇率表推算而非银行公布的货币对标记为 "derived": true。周末和节假日返回最近的发布日期。
错误代码
| 状态码 | 含义 |
|---|---|
400 | 请求错误 — 缺少或无效的参数 |
401 | 未授权 — 缺少或无效的 API 密钥 |
429 | 超过速率限制 — 请检查 Retry-After 响应头 |
500 | 服务器内部错误 |
503 | 服务暂时不可用 |
数据时效性
AllRatesToday 提供实时汇率。与其他每60分钟更新一次的服务不同，我们的汇率在每次请求时从机构级银行间市场数据实时获取，确保您始终获得最新的中间市场汇率。
实时更新
汇率从机构级银行间市场数据实时获取——没有延迟或批量更新。
支持的货币
支持 160+ 种货币，包括：
主要货币
USD, EUR, GBP, JPY, CHF, CAD, AUD, NZD
热门货币
INR, CNY, BRL, MXN, RUB, TRY, ZAR, SGD, HKD, KRW, THB, PHP, PKR, BDT, LKR, NGN, GHS, KES, AED, SAR, EGP 等
完整列表请参阅 OpenAPI 规范。
代码示例
JavaScript / Node.js
const response = await fetch(
'https://allratestoday.com/api/v1/rates?source=USD&target=EUR',
{ headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const data = await response.json();
console.log(`1 USD = ${data.rate} EUR`);Python
import requests
response = requests.get(
'https://allratestoday.com/api/v1/rates',
params={'source': 'USD', 'target': 'EUR'},
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()
print(f"1 USD = {data['rate']} EUR")PHP
$opts = {'http' => {'header' => 'Authorization: Bearer YOUR_API_KEY'}};
$context = stream_context_create($opts);
$response = file_get_contents(
'https://allratestoday.com/api/v1/rates?source=USD&target=EUR',
false, $context
);
$data = json_decode($response, true);
echo "1 USD = " . $data['rate'] . " EUR";cURL
curl "https://allratestoday.com/api/v1/rates?source=USD&target=EUR" \
-H "Authorization: Bearer YOUR_API_KEY"