為替APIガイド

為替レート履歴、鮮度、実装に関する実践的なガイダンス。

整然としたトレイに置かれた2つの通貨トークンを調べる白いイッカク。

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

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

ガイド4 最低読み取り件数
異なる2つの通貨トークンを置いた小さな両替所にいる白いイッカク。

通貨換算の仕組み

為替レートで金額を換算し、逆方向の換算にも対応します。参考レートによる換算額と、手数料控除後の支払額の違いも説明します。

ガイド4 最低読み取り件数
そろばんと通貨トークンのトレイのそばにいる白いイッカク。

為替レートの精度と丸め

小数の為替レートの精度を保ち、金額の計算結果を最後に一度だけ丸め、再現可能なPythonの例で偶数丸めを理解します。

ガイド4 最低読み取り件数
小さな橋でつながれた3つの通貨トークンを眺める白いイッカク。

クロスレートを解説

共通の基準通貨を持つ2つのレートから通貨のクロスレートを計算し、方向を確認し、タイムスタンプの不一致や早すぎる丸めを避ける方法を説明します。

ガイド4 最低読み取り件数
観測票を保管トレイに置き、机上の時計を確認する白いイッカク。

為替レートのタイムスタンプと鮮度

観測時刻とリクエスト時刻を区別し、staleフィールドと市場セッションのフィールドを確認して、為替アプリケーションの鮮度チェックを設計します。

ガイド4 最低読み取り件数
過去の為替レート観測値のタイムラインを調べる Narwhal マスコット

過去の為替レートの仕組み

Narwhalが実際の観測日、通貨ごとに欠損のあるデータ、件数に上限のあるFX履歴ページを返す方法。

ガイド3 最低読み取り件数
休場市場の柵のそばで時計を確認するNarwhalマスコット

為替レート API が週末を扱う方法

市場の休場時に、市場セッション、タイムスタンプ、データが古いかどうかを示す状態からFXレートを読み解く方法。

ガイド3 最低読み取り件数