开发者

一个免费、免 Key 的汇率 API,以及一个可嵌入到任何网站的换算小组件。给你的 App、仪表盘、博客都能用上实时汇率。

公开 API

REST + JSON,对所有源放开 CORS。结果在 Redis 缓存约 60 秒,响应飞快。

基础地址
https://ratata.money/api/v1
限速
60 req / min · IP
鉴权
无需 Key
GET/currencies?lang=zh-Hans
返回全部支持的币种(代码、本地化名称、国旗、小数位)。
示例
curl https://ratata.money/api/v1/currencies?lang=zh-Hans
响应
[
  { "code": "USD", "name": "US Dollar", "flag": "🇺🇸", "decimals": 2 },
  { "code": "EUR", "name": "Euro", "flag": "🇪🇺", "decimals": 2 }
]
GET/rates/latest?base=USD&symbols=CNY,JPY,EUR
返回某个基准币种对任意目标币种的最新汇率。
示例
curl "https://ratata.money/api/v1/rates/latest?base=USD&symbols=CNY,JPY,EUR"
响应
{
  "base": "USD",
  "timestamp": 1714464000,
  "rates": { "CNY": 7.2456, "JPY": 156.43, "EUR": 0.9321 },
  "source": "frankfurter"
}
GET/rates/convert?from=USD&to=CNY&amount=100
服务端按金额完成换算,避免端上浮点误差。
示例
curl "https://ratata.money/api/v1/rates/convert?from=USD&to=CNY&amount=100"
响应
{ "from": "USD", "to": "CNY", "amount": 100, "result": 724.56, "rate": 7.2456 }
GET/rates/history?base=USD&symbol=CNY&range=30d
返回日线历史,可选 7d / 30d / 90d / 1y。
示例
curl "https://ratata.money/api/v1/rates/history?base=USD&symbol=CNY&range=30d"
响应
{
  "base": "USD",
  "symbol": "CNY",
  "range": "30d",
  "points": [
    { "date": "2026-04-01", "rate": 7.2310 },
    { "date": "2026-04-02", "rate": 7.2401 }
  ]
}

错误格式

所有错误均以 JSON 返回,包含稳定的 code 和可读的 message。

{ "error": { "code": "UNSUPPORTED_CURRENCY", "message": "..." } }

嵌入式小组件

一个 iframe 把换算器放到任何网站。选好币种对、语言、主题和尺寸,直接复制下方代码。

预览
嵌入代码
<iframe src="https://ratata.money/embed?from=USD&to=CNY&amount=100&lang=zh"
  width="420" height="320"
  style="border:0;max-width:100%;border-radius:16px;overflow:hidden"
  loading="lazy"
  title="Ratata currency converter"
  referrerpolicy="no-referrer"
  allow="clipboard-write"></iframe>
目前完全免费且不计配额,请合理使用。如有滥用我们可能加每日上限;商用大流量需求请联系我们。
下载App Store
开发者 · Ratata · Ratata