API 參考

認證同限額

資料 endpoint 可以匿名試用：每個 IP 每分鐘 12 次、每小時 100 次。加 key 之後用帳戶每月額度。

Authorization: Bearer YOUR_KEY
X-RateLimit-Remaining: 9999
X-RateLimit-Reset: 1788220800

解釋資料新鮮度嘅欄位

`source` 係來源類別，`market_session` 係市場狀態，`data_updated_at` 係對回應有貢獻的最早觀測時間。三個都應該保存。

Endpoints

日內序列與涵蓋範圍

/v1/timeseries 支援 1m、5m、15m、1h、4h 和每日參考數據 1d，不支援 2h。不含 USD 的 SGD 交叉盤不支援 4h；USD/SGD 及反向則支援。市場數據由 2026-09-14 開始收集。1m 保留 30 日，更大間隔沒有預定到期刪除。保留期限不代表已累積相同長度的歷史。

歷史交叉盤要求真實收市觀測位於同一 UTC 區間內，時間差不超過 5 秒。effective_at 使用較早的觀測時間。不填補缺口；尚未結束的區間可能改變。1d 使用全目錄的每日參考數據。表中每個貨幣對只計一次，支援雙向。

curl "https://api.exchangerate.dev/v1/timeseries?base=EUR&symbols=JPY&interval=15m&from=2026-09-14T12:00:00Z&to=2026-09-14T13:00:00Z"

支援的時間窗口沒有觀測時，會返回 HTTP 200，包含 data: []、has_more: false 和 next_cursor: null。未知間隔返回 unsupported_interval；範圍外貨幣對返回 unsupported_pair_interval 和 rejected_pairs（HTTP 400）。混合請求會整體拒絕。

AUD, CAD, CHF, EUR, GBP, JPY, MXN, NOK, NZD, PLN, SEK, SGD, USD, ZAR

涵蓋範圍與限制詳情

日內匯率 API

即時 WebSocket

連接 wss://api.exchangerate.dev/v1/stream，並在 10 秒內傳送 auth。密鑰必須留在伺服器，不能放在 URL 或公開 JavaScript 中。不支援匿名連線。收到 authenticated 後傳送 subscribe。支援下列貨幣；交叉盤要求兩條最新觀測均未過期且相差不超過 5 秒。狀態可能為 unavailable 或 stale。每條獲准連線消耗一個月度配額單位。

表中為新帳戶的限制。現有帳戶保留 Free 1 × 5、Basic 3 × 25 或 Pro 10 × 100（連線數 × 每條連線的貨幣對數）。authenticated 訊息會顯示您的實際限制。

AUD, CAD, CHF, EUR, GBP, JPY, MXN, NOK, NZD, PLN, SEK, SGD, USD, ZAR

{"action":"auth","api_key":"YOUR_KEY"}

{"action":"subscribe","base":"EUR","symbols":["USD","JPY"]}

即時 WebSocket →

錯誤

REST: 錯誤統一用 `{ result: "error", code, message }`。429 會加 `Retry-After`；資料來源失敗時唔會偷偷轉用假數。

{
  "result": "error",
  "code": "missing_parameter",
  "message": "missing required parameter: symbols"
}

API 參考 →

curl -fsS --max-time 10 "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"

from urllib.request import Request, urlopen
import json

# Identify your application explicitly when calling the API.
request = Request("https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP", headers={"User-Agent": "exchangerate-docs/1.0"})
with urlopen(request, timeout=10) as response:
    data = json.load(response)

print(data["rates"]["EUR"])

const response = await fetch("https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP", {
  signal: AbortSignal.timeout(10_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data.rates.EUR);

{
  "result": "success",
  "base": "USD",
  "source": "live",
  "sources": {
    "EUR": "live",
    "GBP": "live"
  },
  "market_session": "open",
  "timestamp": "2026-06-15T12:00:00Z",
  "data_updated_at": "2026-06-15T12:00:00Z",
  "effective_at": {
    "EUR": "2026-06-15T12:00:00Z",
    "GBP": "2026-06-15T12:00:00Z"
  },
  "rates": {
    "EUR": 0.86207,
    "GBP": 0.74627
  },
  "derived_symbols": [],
  "notice": "Indicative rates, not for settlement."
}