ドキュメント
FX の方法論
レートの意味、鮮度、履歴、換算、ソース、制限事項。
Narwhalは、対応するRESTとMCPの仕様を通じて、現在の参考レート、10進数の精度を保つ換算、過去の観測値を公開します。文脈のない数値を示すのではなく、レートの方向と時間の意味を明示します。
履歴には実際の観測日が含まれます
過去の結果は古い順で、保存された観測値がある日付だけを含みます。Narwhal は週末や祝日の行を作成せず、本来は日次の履歴に週次通貨の値を前方補完しません。
ある日付には、リクエストした通貨の一部だけが含まれる場合があります。公表頻度や履歴のカバレッジが通貨によって異なる場合は、想定どおりの動作です。このインターフェースは、過去の公表時点の各版をすべて返すのではなく、現在受け入れられている履歴系列を返します。
提示レートは基準通貨1単位に相当する相手通貨の金額
基準通貨が USD で、返される EUR レート： 0.92の場合、1米ドルは0.92ユーロです。レートは小数文字列で、選択した通貨は動的なオブジェクトキーではなく、明示的なレコードとして返されます。
更新状況と鮮度を確認できる
Narwhalは取引日に、およそ毎分1回、新しい上流観測値を確認します。顧客リクエストは最新の受け入れ済み観測値を読み取り、上流への呼び出しを待ちません。
各レートが持つ情報は、固有の timestamp および stale 状態。 market_session 報告書 open, weekend、または interbank_closed。週末や市場休場日でも、最新の受け入れ済み観測値は、元のタイムスタンプと正確なセッション情報を伴って利用できる場合があります。
換算には選択した1つのレートを使用します
換算エンドポイントは10進演算を行い、偶数丸めによって換算先通貨のISO 4217最小単位に一度だけ丸めます。丸めるとゼロになる非ゼロの結果は、代わりに偶数丸めで有効数字を最大5桁まで保持し、ゼロを補いません。選択したレート、換算金額、タイムスタンプ、データが古いかどうかを示す状態、市場セッションを返します。
利用許諾・承認済みのデータプロバイダー
Narwhalは、利用許諾を受けた、またはその他の承認を得た上流プロバイダーを使用し、プロバイダーの識別情報、ルーティング、ライセンス記録、導出の詳細を内部監査証跡に保持します。こうした運用上の出所フィールドは、公開レートレスポンスには意図的に含めていません。
この方針により、承認済みの上流ルートが変わっても顧客向けの仕様を安定させつつ、Narwhalは受け入れた各観測値を監査するために必要な根拠を保持します。
現在の制限
- レートと換算は参考値であり、執行可能なディーラー提示値、決済金額、公式フィキシングではありません。
- 現在のレート、換算、履歴観測値は公開されています。ボラティリティ計算は公開されていません。
- 選択したレートが欠落している、形式が不正、または利用できない場合は、推定したり通知せずに省略したりせず、エラーとして処理します。
- Basic と Pro には稼働率99.5%のSLAが含まれます。詳しくは利用規約をご覧ください。Narwhal のデータは金融、投資、法律、税務上の助言ではありません。