---
title: "API 文档"
description: "AllRatesToday 货币汇率 API 完整文档。端点、认证、代码示例和集成指南。"
canonical: https://allratestoday.com/zh/docs/
source: AllRatesToday (https://allratestoday.com/) — Markdown mirror of the page above; index of all pages at https://allratestoday.com/llms.txt
generated: 2026-11-16T09:59:58.998Z
---

# API 文档

将实时货币汇率集成到您的应用程序所需的一切。

## 概述

AllRatesToday API 通过简单的 REST 接口提供实时和历史货币汇率。所有响应均为 JSON 格式。基础 URL 为：

```
https://allratestoday.com
```

免费注册即可获取 API 密钥，访问**认证端点**。提供免费层级。

## 认证

请将您的 API 密钥作为 Bearer 令牌包含在请求中：

```
Authorization: Bearer YOUR_API_KEY
```

登录后，从您的[个人资料页面](https://allratestoday.com/profile#api-keys)获取 API 密钥。

## 速率限制

  **配额响应头仅在 `429` 响应中返回** 成功响应*不会*包含 `X-RateLimit-*` 或 `X-Monthly-*`，请勿依赖 `200` 响应来读取剩余配额。超限时返回 `X-Monthly-Limit`、`X-Monthly-Used` 和 `X-Monthly-Resets`。没有 `Retry-After` 响应头，请使用响应体中的 `resets_at`。

| 方案 | 月请求量 | 速率 | 认证 | 价格 |
| --- | --- | --- | --- | --- |
| Free | 免费（**终身**，不重置） | — | API 密钥 | 免费 |
| Small | 5,000 / 月 | — | API 密钥 | [查看定价](https://allratestoday.com/pricing) |
| Medium | 10,000 / 月 | — | API 密钥 | [查看定价](https://allratestoday.com/pricing) |
| Large | 100,000 / 月 | — | API 密钥 | [查看定价](https://allratestoday.com/pricing) |

免费方案的额度**终身有效**，不按月重置；付费方案在每月 1 日 00:00 UTC 重置。历史数据按数据量计费：`period=1y` 计为 12 次请求。使用 `target=EUR,GBP,JPY` 的一次调用仍只计 1 次请求。用量达到 90% 时会发送提醒邮件。完整说明见[英文文档](https://allratestoday.com/docs#rate-limits)。 [查看定价](https://allratestoday.com/pricing)

## 认证汇率

   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": "mid-market" }
```

## 历史汇率

   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": "mid-market",
  "period": "30d"
}
```

## 央行汇率

24 家央行（欧洲央行、美联储、英格兰银行、中国人民银行、斯里兰卡央行等）发布的官方汇率 — 税务、海关、审计与合规开票所需的固定、可引用汇率。详见[概览与各银行页面](https://allratestoday.com/zh/central-bank-rates-api/)、[英文完整文档](https://allratestoday.com/docs/#central-bank)和[交互式 API 参考](https://allratestoday.com/api-reference/)。

- `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 规范](https://allratestoday.com/openapi.json)。

## 代码示例

### 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"
```

### 准备好集成了吗？

获取您的免费 API 密钥，几秒钟内即可开始发送请求。

 [获取免费API密钥](https://allratestoday.com/login?redirect=/profile)
