文件
外匯方法說明
匯率含義、時效、歷史資料、換算、來源和限制。
Narwhal 透過相互對應的 REST 與 MCP 介面規格，提供目前指示性匯率、保留十進位精度的換算，以及歷史觀測值。它明確保留匯率方向和時間含義，避免只呈現缺乏背景資訊的數字。
歷史資料包含真實觀測日期
歷史結果由舊到新排序，僅包含已儲存觀測值的日期。Narwhal 不會建立週末或假日資料列，也不會將每週發布的貨幣匯率沿用至其餘按日記錄的歷史資料中。
某個日期可能僅包含所請求貨幣中的一部分。當各貨幣的發布頻率或歷史涵蓋範圍不同時，這是預期的行為。介面回傳目前已接受的歷史序列，而非每個過往發布版本。
一單位基準貨幣可兌換報價匯率所示數量的貨幣
若基準貨幣為 USD 且回傳的 EUR 比率 0.92，表示 1 美元等於 0.92 歐元。匯率以十進位數值字串回傳，所選貨幣會以明確的紀錄回傳，而不是作為動態物件鍵。
更新與資料時效清楚可見
Narwhal 在交易日約每分鐘檢查一次上游新觀測。客戶請求讀取最新已接受觀測，不會等待上游呼叫。
每個匯率都有自己的 timestamp 和 stale 狀態。 market_session 報告 open, weekend，或 interbank_closed。在週末和市場休市期間，最新已接受的觀測值仍可供使用，並保留原始時間戳記和如實標示的交易時段資訊。
換算使用一個選定匯率
換算端點使用十進位運算，再採用銀行家捨入法，一次捨入至目標貨幣在 ISO 4217 中的最小單位。它會回傳輸入金額、選定匯率、換算金額、時間戳記、過時狀態和市場交易時段。
經授權與核准的資料供應商
Narwhal 使用經授權或以其他方式獲准的上游供應商，並在內部稽核紀錄中保留供應商身分、路由、授權紀錄和推導細節。這些作業來源追溯欄位刻意不納入公開的匯率回應。
即使經核准的上游路由變更，此政策仍可維持客戶介面規格的穩定，同時讓 Narwhal 保留稽核每筆已接受觀測值所需的證據。
當前限制
- 匯率與換算結果僅供參考，並非可成交的交易商報價、結算值或官方定盤價。
- 目前匯率、換算和歷史觀測值均已公開。波動率計算則未公開。
- 若所選匯率缺漏、格式錯誤或無法使用，請求就會失敗，不會估算匯率或逕自省略。
- Basic 和 Pro 方案包含 99.5% 可用性 SLA，詳見服務條款。Narwhal 資料不構成金融、投資、法律或稅務建議。