API 文档
将实时货币汇率集成到您的应用程序所需的一切。
概述
AllRatesToday API 通过简单的 REST 接口提供实时和历史货币汇率。所有响应均为 JSON 格式。基础 URL 为：
https://allratestoday.com免费注册即可获取 API 密钥，访问认证端点。提供免费层级。
认证
请将您的 API 密钥作为 Bearer 令牌包含在请求中：
Authorization: Bearer YOUR_API_KEY登录后，从您的个人资料页面获取 API 密钥。
速率限制
速率限制响应头
所有响应包含：
X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset、X-Monthly-Limit、X-Monthly-Used、X-Monthly-Resets。
| 方案 | 月请求量 | 速率 | 认证 | 价格 |
|---|---|---|---|---|
| 公共 | 每IP每小时10次 | 10/小时 | 无 | 免费 |
速率限制因计划而异。超出月限额后API返回 429。达到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"