全部为只读 GET 接口 · 返回 UTF-8 JSON · 无需密钥 · 同源可直接调用
| 接口地址 | /exrate/api.php?act=... |
|---|---|
| 请求方式 | GET(只读,所有写操作在 cron.php / admin.php 且需要凭证) |
| 返回格式 | application/json; charset=utf-8,成功 {"ok":true,...},失败 {"ok":false,"error":"..."} |
| 数据源 | Frankfurter v2(各央行参考汇率,每日更新) |
| 币种代码 | ISO 4217 三字母大写代码,例如 CNY、USD、EUR |
| act | 参数 | 说明 |
|---|---|---|
snapshot | base | 牌价快照:全部币种相对基准的汇率、日涨跌、币种字典与元信息 |
currencies | — | 币种字典数组 |
convert | from to amount | 单笔金额换算 |
history | from to days | 最近 N 天每日时间序列(7–365) |
history_range | from to start end | 指定日期区间的时间序列与区间统计 |
pair | from to days | 货币对详情:当前/反向汇率、日涨跌、区间统计、走势点 |
ranking | base period | 涨跌榜,period = day / week / month / quarter |
matrix | codes(逗号分隔,可省略) | 交叉汇率矩阵,默认常用币种,可用 codes 参数传任意币种 |
batch | from amount tos | 一笔金额批量换算 |
search | q | 币种与货币对搜索 |
stats | — | 站点统计:币种数、记录数、日期范围 |
status | — | 运行状态自检:PHP / MySQL / 同步日志 |
GET /exrate/api.php?act=convert&from=USD&to=CNY&amount=100
{
"ok": true,
"date": "2026-11-17",
"from": "USD", "to": "CNY", "amount": 100,
"rate": 6.6642, "result": 666.42
}
GET /exrate/api.php?act=ranking&base=CNY&period=week
GET /exrate/api.php?act=matrix&codes=CNY,USD,EUR,JPY
GET /exrate/api.php?act=pair&from=EUR&to=CNY&days=90
GET /exrate/export.php?from=USD&to=CNY&days=90 // CSV 下载
config.php 配置 security.api_allow_origin。