基準貨幣與報價貨幣說明

把貨幣對讀成一句話

按照一般的貨幣對慣例，第一種貨幣是基準貨幣，第二種是報價貨幣。匯率表示每一單位基準貨幣可換得的報價貨幣數量。只有1.25這樣的數值並不完整，必須附上兩個貨幣代碼及其順序。

以下所有數字僅為範例，不是目前市場報價。對產品畫面而言，「1 EUR = 1.25 USD」通常比單獨的貨幣對代碼更容易理解。

從基準貨幣換算為報價貨幣時相乘

假設客戶想按範例 EUR/USD 匯率 1.25 將 EUR 80 表示為美元。單位說明應使用哪種運算：歐元相消後，剩下美元。

80 EUR × 1.25 USD/EUR = 100 USD
100 USD ÷ 1.25 USD/EUR = 80 EUR

方向改變時反轉匯率

每 EUR 為 1.25 USD 的匯率，取倒數後為每 USD 兌 0.80 EUR。如果圖表從 EUR/USD 切換為 USD/EUR，標籤與數值都必須改變。在反向標籤下沿用 1.25，會得到不同的換算結果。

方向也會改變對匯率變動的解讀。在第二個範例觀測中，EUR/USD 從 1.25 上升至 1.30，表示一歐元可買到更多美元。反向匯率則從 0.80 降至每 USD 約兌 0.76923 EUR。

將單位對應到 API 欄位

對 Narwhal 的目前匯率而言，base 是被定價的貨幣。每筆回傳紀錄都指出一單位基準貨幣可兌換的貨幣。匯率以十進位數值字串回傳，並各自附上時間戳記與過時狀態。

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

在儲存與介面中明確保留方向

有用的已儲存觀測值不只有數字。顯示或比較匯率時，請將以下細節一起保留：

• 基準貨幣和報價貨幣，分別存放在不同欄位中。
• 收到的原始匯率，尚未為顯示而捨入。
• 觀測時間戳記和時效背景。
• 該數字是指示性匯率、買入價、賣出價，還是其他已命名的匯率類型。

取倒數不會消除買賣價差或費用

上述運算使用範例參考匯率。買入貨幣與賣出貨幣的客戶可能取得不同報價。考慮買賣價差、費用與捨入後，不應承諾換出再換回能得到原始金額。

如果供應商提供買入價與賣出價，反轉匯率時，除了對數值取倒數，也須對調買賣方向：反向買入價為 1 / 原賣出價，反向賣出價為 1 / 原買入價。此處 Narwhal 的目前匯率範例描述的是指示性匯率，而非可成交的買賣報價簿。