外匯數據方法說明
匯率含義、新鮮度、歷史記錄、換算、來源和限制。
Narwhal 通過匹配的 REST 和 MCP 合約發布當前指示性匯率、安全的小數換算和歷史觀測值。它明確表示匯率方向和時間語義，而不是脫離上下文展示一個數字。
歷史數據包含真實觀測日期
歷史結果按從舊到新排序，僅包含有儲存觀測的日期。Narwhal不會創建週末或假日行，也不會把每周貨幣值向前填充到原本按日記錄的歷史中。
某個日期可能只包含所請求貨幣的子集。當它們的發布頻率或歷史覆蓋範圍不同時，這是預期行為。該介面返回當前已接受的歷史序列，而不是每個更早的發布版本。
一個基本單位等於報價匯率
以此作為基礎貨幣： USD 和 一個 返回的 EUR 比率 0.92，表示 1 美元等於 0.92 歐元。匯率以十進位數值字串返回，所選幣種以明確的記錄返回，而不是作為動態對象鍵。
更新和新鮮度保持可見
Narwhal 在交易日約每分鐘檢查一次上游新觀測。客戶請求讀取最新已接受觀測，不會等待上游呼叫。
每個匯率都有自己的 timestamp 和 stale 狀態。 market_session 報告 open, weekend，或 interbank_closed。在週末和市場休市期間，最近一次已接受的觀測值仍可保留，並附帶原始時間戳記和如實標注的交易時段資訊。
換算使用一個選定匯率
換算端點使用十進位算術，然後採用銀行家捨入法，一次性捨入到目標貨幣 ISO 4217 的最小單位。它返回輸入金額、選定匯率、換算金額、時間戳記、陳舊狀態和市場交易時段。
已授權並獲批的數據提供商
Narwhal 使用獲得許可或以其他方式獲批准的上游提供商，並在內部審計軌跡中保留提供商身份、路由、許可記錄和推導詳情。這些運營溯源欄位特意不包含在公開匯率回應中。
如果獲批的上游路由發生變化，該政策仍能保持客戶合約穩定，同時 Narwhal 保留審計每個已接受觀測值所需的證據。
當前限制
- 匯率和轉換結果僅供參考，不是可執行的交易商報價、結算值或官方定盤價。
- 當前匯率、轉換和歷史觀測值均為公開數據。波動率計算結果不公開。
- 缺失、格式錯誤或不可用的選定匯率會直接失敗，不會估算，也不會靜默省略。
- 公開測試版不提供服務級別保證，也不是金融、投資、法律或稅務建議。