今日汇率查询EXCHANGE RATE
数据日期 2026-11-17
OPEN JSON API

开放汇率接口文档

全部为只读 GET 接口 · 返回 UTF-8 JSON · 无需密钥 · 同源可直接调用

基础信息

Base: /exrate/api.php
接口地址/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参数说明
snapshotbase牌价快照:全部币种相对基准的汇率、日涨跌、币种字典与元信息
currencies—币种字典数组
convertfrom to amount单笔金额换算
historyfrom to days最近 N 天每日时间序列(7–365)
history_rangefrom to start end指定日期区间的时间序列与区间统计
pairfrom to days货币对详情:当前/反向汇率、日涨跌、区间统计、走势点
rankingbase period涨跌榜,period = day / week / month / quarter
matrixcodes(逗号分隔,可省略)交叉汇率矩阵,默认常用币种,可用 codes 参数传任意币种
batchfrom amount tos一笔金额批量换算
searchq币种与货币对搜索
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 下载

使用约定

  • 接口有文件缓存,行情每日本就只更新一次,请勿高频轮询。
  • 币种代码、日期、金额均做白名单校验;非法参数返回 400 / 404。
  • 跨域调用需在 config.php 配置 security.api_allow_origin。
  • 数据仅供参考,不得作为交易、结算或法律凭证。
  • 接口为本站内部使用,未开放给第三方商用,请合理控制调用量。
查看当前运行状态