基準通貨と相手通貨を解説

通貨ペアを正しい方向で読み、為替レートを反転し、為替APIレスポンスのbaseフィールドとcurrencyフィールドを解釈する方法を説明します。

ガイドNarwhal APIによる4 最低読み取り件数
整然としたトレイに置かれた2つの通貨トークンを調べる白いイッカク。

ペアを文章として読む

一般的な通貨ペアの表記では、最初の通貨が基準通貨、2番目が相手通貨です。レートは基準通貨1単位で受け取る相手通貨の額を示します。1.25のような数値だけでは不十分なので、2つの通貨コードとその順序を添えてください。

以下の数値はすべて例示であり、現在の市場価格ではありません。商品画面では、通貨ペアコードだけよりも「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

方向が変わるときはレートを反転する

1 EUR当たり1.25 USDの逆数は、1 USD当たり0.80 EURです。チャートをEUR/USDからUSD/EURに切り替える場合、ラベルと値の両方を変更する必要があります。逆向きのラベルで1.25を再利用すると、換算結果が変わってしまいます。

方向が変わると値動きの読み方も変わります。2つ目の観測例でEUR/USDが1.25から1.30へ上昇した場合、1ユーロでより多くのドルを買えることを意味します。逆方向のレートは、1 USD当たり0.80 EURから約0.76923 EURへ低下します。

単位を API フィールドに対応させる

Narwhalの現在レートでは、baseは価格を示す対象の通貨です。返される各レコードには、基準通貨1単位で受け取る通貨が示されます。レートは、個別のタイムスタンプとstale状態を伴う小数文字列で返されます。

現在レートのリクエスト
curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,JPY" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

保存と UI で方向を明示する

保存する観測値には数値以外も含めます。レートを表示または比較するときは、次の詳細を一緒に保持してください:

  • 基準通貨と相手通貨を別々のフィールドにする。
  • 表示用に丸める前の受信レート。
  • 観測タイムスタンプと鮮度のコンテキスト。
  • その数値が参考値、買値、売値、または別の名称付きのレート種別かどうか。

逆数を取ってもスプレッドや手数料はなくならない

上記の計算では、例示用の参考レートを1つ使用しています。通貨を買う顧客と売る顧客には、異なる価格が提示される場合があります。スプレッド、手数料、丸めを考慮したうえで、別の通貨に換算してから元の通貨に戻すと元の金額に戻るとは約束しないでください。

プロバイダーが買値と売値を提供する場合は、数値とともに売買の側も入れ替えます。逆方向の買値は1 / 元の売値、逆方向の売値は1 / 元の買値です。ここでのNarwhalの現在レートの例は参考レートを示すもので、約定可能な売買注文板ではありません。

出典・参考資料

公開日： 。最終確認日： 。