金融與外匯數據技能 是做什麼的?
無需 API 金鑰即可獲取匯率和加密貨幣價格。此技能旨在防止以下錯誤:從訓練記憶中使用 exchangerate.host、Fixer 或 Alpha Vantage——這些服務現在都需要金鑰——或者將訓練數據中過時的匯率用於實際計算。
排名 API
- Frankfurter (api.frankfurter.dev) - 法定貨幣匯率的預設來源。歐洲央行參考匯率,約 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 調用;對於任何列表請求,優先使用此 API。
交付成果
匯率或價格及其 date/時間戳和來源名稱,以及使用的確切 URL。任何轉換都應顯示計算過程:250 USD × 0.87352 (ECB, <匯率日期>) = 218.38 EUR。
請勿使用 - 請改用 X
- exchangerate.host - 每個請求現在都需要
access_key;經驗證,無金鑰方式已失效。Frankfurter 可替代它。 - Fixer、Alpha Vantage、Finnhub、Polygon、OpenExchangeRates - 需要金鑰;當 Frankfurter/CoinGecko 已能滿足需求時,請勿要求用戶註冊。
- 股票/權益報價 - 無任何無金鑰的 API 能通過驗證。請明確說明這一點,並列出付費選項,而非憑空捏造價格。
- GDP、通貨膨脹、失業率、貿易數據 - 請使用政府開放數據(government-open-data)。
- 財務建議 - 此技能用於獲取數據;買入/賣出/配置判斷不在範圍內。僅呈現數據,不提供建議。
品質標準
- 每個數字都必須附帶其日期和來源;不得從訓練記憶中獲取匯率或價格。
- 尊重 Frankfurter 約 30 種貨幣的上限——不支援的貨幣對(例如 NGN、VND)應明確聲明不支援,而非進行近似估算。
- CoinGecko 調用應批量進行;遇到 429 錯誤時應等待,而非重試循環。
資料來源與即時性驗證基於 public-apis 專案(MIT 授權)。