金融与外汇数据
通过无需密钥的调用获取汇率和加密货币价格。本技能旨在避免以下错误:从训练记忆中调用已失效的exchangerate.host、Fixer或Alpha Vantage(这些现在都需要密钥),或者将训练数据中的过时汇率直接用于实际计算。
优先级排序的API
- Frankfurter (api.frankfurter.dev) - 法定货币外汇的默认API。欧洲央行参考汇率,覆盖约30种主要货币,历史数据可追溯至1999年,支持时间序列,无需密钥,速率限制无需担心。
- CoinGecko免费层 (api.coingecko.com) - 加密货币价格、市值、24小时变化,支持数千种代币。无需密钥,但有限制:匿名IP大约每分钟5-15次调用。请将多个ID合并为一次调用;若收到429错误,需等待60秒。
流程
- 法定货币还是加密货币? 法定货币 → Frankfurter。加密货币 → CoinGecko。加密货币到法定货币的转换只需一次CoinGecko调用(
vs_currencies=eur),无需两次跳转。 - 注意汇率日期。 欧洲央行参考汇率大约在交易日16:00 CET更新;响应的
date字段告诉你实际获得的是哪一天的数据。周末/节假日请求会返回上一个交易日——请引用该日期,不要将其呈现为今天的数据。 - 使用CoinGecko的ID,而非代码。
ids参数需要bitcoin、ethereum、solana这样的值,而非BTC/ETH。对于不熟悉的代币,通过/api/v3/search?query={name}解析一次 → 取coins[0].id。 - 切勿凭记忆进行外汇计算。 如果任务需要将金额乘以汇率,汇率必须来自以上API调用之一,并附上日期。
仅在缺失以下信息时询问用户:货币对或代币(无默认值)、日期/范围(默认:最新)、金额(默认:1)。
URL模板 + 实际响应格式
最新汇率:
https://api.frankfurter.dev/v1/latest?base=USD&symbols=EUR,GBP,JPY
{"amount":1.0,"base":"USD","date":"<上一个交易日>","rates":{"EUR":0.87352,"GBP":0.74878,"JPY":161.15}}
使用&amount=250在服务器端转换金额——rates会返回预乘以金额后的值。
历史数据 / 时间序列:
https://api.frankfurter.dev/v1/2024-01-15?base=USD&symbols=EUR ← 单个日期
https://api.frankfurter.dev/v1/2024-01-02..2024-01-31?base=USD&symbols=EUR ← 范围
https://api.frankfurter.dev/v1/currencies ← 货币代码到名称的映射
范围响应格式:{"rates":{"2024-01-02":{"EUR":0.91274},"2024-01-03":{"EUR":0.91583}}} — 按日期索引,仅交易日(一整年约返回256个每日数据点;没有周末键,因此不要将空白视为缺失数据)。省略结束日期(/2024-01-02..)可查询到当前日期。
加密货币现货价格:
https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum&vs_currencies=usd&include_24hr_change=true
{"bitcoin":{"usd":63289,"usd_24h_change":1.19},"ethereum":{"usd":1790.89,"usd_24h_change":1.90}}
未知ID会从响应中被静默忽略——缺少键意味着ID错误,而非价格为null。
加密货币市场表格(排名、市值、供应量):
https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=20&page=1
返回数组:{"id","symbol","name","current_price","market_cap","market_cap_rank","price_change_percentage_24h","circulating_supply","ath"} —— 一次调用可替代二十次/simple/price调用;对于任何列表数据,优先使用此接口。
交付物
返回汇率或价格时,必须附带其date/时间戳和来源名称,以及使用的确切URL。任何转换计算都应显示算术过程:250 USD × 0.87352 (ECB, <汇率日期>) = 218.38 EUR。
不要使用——改用以下替代方案
- exchangerate.host —— 每个请求现在都需要
access_key;已验证无需密钥时无法工作。Frankfurter可替代它。 - Fixer、Alpha Vantage、Finnhub、Polygon、OpenExchangeRates —— 均需密钥;当Frankfurter/CoinGecko已满足需求时,不要让用户注册。
- 股票/权益报价 —— 没有无需密钥的接口能通过验证。请直接说明此限制,并列出付费选项,而非编造价格。
- GDP、通胀、失业率、贸易数据 —— 请使用政府开放数据。
- 金融建议 —— 本技能仅获取数字;买卖/配置判断超出范围。提供数据,而非建议。
质量标准
- 每个数字必须附带其日期和来源;不得有来自训练记忆的汇率或价格。
- 尊重Frankfurter约30种货币的上限——罕见货币对(例如NGN、VND)应声明不支持,而非近似估计。
- CoinGecko调用应合并处理;收到429错误时,应进行退避,而非持续重试。
本技能来源并经过实时验证,基于public-apis项目(MIT许可)。