用 JavaScript 同 Node.js 做貨幣換算

喺 JavaScript 攞匯率最快嘅路徑，係用 fetch GET /v1/latest/USD。回應係普通 JSON，包含 31 種貨幣嘅匯率同兩個新鮮度欄位：source 同 market_session。第一次呼叫唔使 API key。

第一次呼叫，唔使 key

喺 Node 18 或者任何現代瀏覽器，fetch 已經有。一個 await 就讀到 EUR 匯率：

const res = await fetch("https://api.exchangerate.dev/v1/latest/USD");
const data = await res.json();

console.log(data.rates.EUR);        // 0.87531
console.log(data.source);           // ecb_daily
console.log(data.market_session);   // open

匿名呼叫係按 IP 地址設上限嘅，所以過咗簡單測試就應該轉用免費 key。

加 key 同錯誤處理

將 key 以 bearer token 形式放入 Authorization 標頭。檢查 res.ok，狀態唔對就 throw，等錯誤早啲浮面：

const API = "https://api.exchangerate.dev/v1";
const KEY = "exr_live_...";   // free key at https://exchangerate.dev/signup

async function getLatest(base = "USD") {
  const res = await fetch(`${API}/latest/${base}`, {
    headers: { Authorization: `Bearer ${KEY}` },
  });

  if (!res.ok) {
    const err = await res.json().catch(() => ({}));
    throw new Error(`exchangerate.dev ${res.status}: ${err.message ?? res.statusText}`);
  }

  return res.json();
}

const data = await getLatest("USD");
console.log(data.rates.GBP, data.market_session);

X-API-Key: exr_live_... 標頭都接受，畀嗰啲設定唔到 Authorization 標頭嘅平台用（部分 serverless runtime、Zapier 呢類 no-code 工具）。

換算一個金額

想直接換算就呼叫 /v1/convert/{from}/{to}/{amount}。一個來回就攞到匯率同換算結果：

const res = await fetch(`${API}/convert/USD/EUR/100`, {
  headers: { Authorization: `Bearer ${KEY}` },
});
const data = await res.json();

console.log(data.rate);       // 0.87572
console.log(data.converted);  // 87.57

convert 端點同 latest 一樣返回 source 同 market_session，所以你可以話畀用戶知匯率屬於邊一類，以及銀行同業交易週而家開唔開市。

理解 source 同 market_session

每個回應都有兩個欄位，講明匯率有幾新、屬於邊類。source 標示數據類別：live 係大約每 60 秒更新一次、貫穿成個交易週嘅綜合現貨共識值；ecb_daily 係歐洲央行每個工作日大約 16:00 CET 發佈一次嘅參考定盤價；fred_daily 係聯儲局每日系列。market_session 係 open、weekend，或者代表已知非週末休市嘅 interbank_closed。

data_updated_at 欄位話你知底層匯率最後一次寫入嘅時間；timestamp 記錄嘅係回應生成嘅時間。兩個一齊睇，就可以決定點快取、點顯示。

免費計劃限額

免費 key 每月 10,000 次呼叫、每分鐘 12 次請求。註冊唔使信用卡。超過每分鐘上限 API 會回 429；後退再重試就得。每月配額喺你嘅計費週年日重設。

• 每月 10,000 次呼叫
• 每分鐘 12 次請求
• 唔使信用卡
• 涵蓋 /v1/latest、/v1/convert、/v1/range 同 /v1/{date}/{base}