开发者
一个免费、免 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>