所有 API

匯率 API

透過 REST 或 MCP 取得目前匯率。同一個 API 金鑰可用於金額換算及查詢已儲存的歷史匯率。

首次請求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,JPY" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

回應範例示意回應 · 非實際請求結果

{
  "base": "USD",
  "market_session": "open",
  "rates": [
    {
      "currency": "EUR",
      "rate": "0.9200",
      "timestamp": "2026-08-22T06:29:41Z",
      "stale": false
    },
    {
      "currency": "JPY",
      "rate": "147.23",
      "timestamp": "2026-08-22T06:29:39Z",
      "stale": false
    }
  ]
}

換算

使用目前指示性匯率在支援的貨幣之間換算金額。每個結果都包含匯率、時間戳和市場時段資訊。

curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/convert?from=USD&to=JPY&amount=100.00" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

回應範例示意回應 · 非實際請求結果

{
  "from": "USD",
  "to": "JPY",
  "amount": "100.00",
  "rate": "147.23",
  "converted": "14723",
  "market_session": "open",
  "timestamp": "2026-08-22T06:29:39Z",
  "stale": false
}

匯率歷史

依貨幣和日期範圍取得歷史匯率。分頁取得已儲存的觀測值，並保留實際缺口。

curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/rates/USD/observations?currencies=EUR,NZD&start_date=2026-08-20&end_date=2026-08-28&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

回應範例示意回應 · 非實際請求結果

{
  "base": "USD",
  "start_date": "2026-08-20",
  "end_date": "2026-08-28",
  "observations": [
    {
      "date": "2026-08-20",
      "rates": [
        {
          "currency": "EUR",
          "rate": "0.85609"
        },
        {
          "currency": "NZD",
          "rate": "1.681"
        }
      ]
    }
  ],
  "next_cursor": null,
  "has_more": false
}