データの鮮度

Narwhal は受け入れた公式リリースを保存し、API リクエスト中にソースを呼び出さずに提供します。

「最新」とは、Narwhal が検証して公開した、完全な公式リリースのうち最も新しいものを意味します。顧客の各リクエストが公式ソースをリアルタイムで呼び出すという意味ではありません。

レスポンスの取得元

成功した各RESTまたはMCPリクエストは、Narwhalに保存された現在の公開内容を読み取ります。ソースのウェブサイト、ファイル、APIは取り込みシステムが別途確認します。

これにより、顧客へのレスポンス時間は公式ソースの速度や一時的な障害から独立します。

リリースが更新される方法

スケジュールされたワーカーが公式ソースを確認し、新しいリリースを探します。
Narwhal はソース資料を取得し、その識別情報、期間、フィールド、完全性を検証します。
正規化された観測値と補足根拠をまとめて保存します。
Narwhal はリリース全体が検証に合格した後に限り、その版を利用者に提供します。

不完全または無効な候補が公開レスポンスに混在することはありません。

鮮度フィールドの意味

フィールドまたはシグナル	意味
`period`	公式観測値が表す月、四半期、または年。
`released_on`	公式の公表日。Narwhal の取得時刻や公開時刻ではありません。
`as_of`	履歴レスポンスでは、ページ内の最新の観測値をソースが最後に更新した時刻。UTCの整数秒で表します。
`observed_at`	単一のカレンダー発表では、Narwhalが公表機関のカレンダーでその発表を最後に確認した時刻。
`timestamp`, `market_session`	FXとスポット価格では、その価格が属するUTC時刻。FXでは市場の状態も示します。
最新データのリクエスト	省略 `period` を省略すると、Narwhal が現在保存している、受け入れ済みの完全なリリースのうち最新のものをリクエストします。
期間を厳密に指定したリクエスト	渡す場合 `period` を指定すると、現在の公式リリースで引き続き利用可能な場合に、その特定の公表期間のデータをリクエストします。
`stale`	商品スポット価格、FX、予測イベントのレスポンスには`stale`が含まれます。スポット価格とFXでは、`stale: true`は、市場が開いている間に値が古くなっていることを示します。ソースが古いと判定しているか、市場が開いている時間だけを数えて値が10分を超えて更新されていない場合に該当します。市場が閉まっていることだけでスポット価格やFXの値が古いと判定されることはありません。開始前または取引中の予測イベントは、取引所での確認が3分間行われないと古いと判定されます。予測のリファレンスを参照してください。値は最後に確認されたもので、`timestamp`はその値の設定時刻を示します（予測イベントでは`as_of`）。

レスポンスには、上記のフィールド以外にNarwhalの取り込み時刻は含まれません。公表済みのはずのデータが遅れている場合は、公式の発表カレンダーを確認し、リクエストIDを添えてサポートにお問い合わせください。

ソース確認に失敗した場合

Narwhalは最後に受け入れた公開内容を利用可能なまま保持します。削除したり、欠落値をゼロに置き換えたり、部分的な更新を公開したりしません。

失敗したソースチェックはスケジュールに従って再試行されます。Narwhalが受け入れ済みの公開内容を安全に提供できない場合、リクエストは文書化された 503 エラーで失敗し、不確かなデータは返しません。

パブリックベータでの想定

ベータ期間中は、公式ソースでの公表から Narwhal での公開までの所要時間が一定であることを保証しません。
顧客APIのレイテンシは保存データの読み取り時間を測定するもので、公式リリースの新規取り込みに必要な時間ではありません。
公式機関が特定の期間の数値を改定することがあります。そのため、後から受け入れた公表データが、以前に保存した値を置き換える場合があります。
Narwhal API のコアエンドポイントと MCP ツールが返す主要経済指標の数値は暫定的な初回推計値の場合があり、レスポンスには暫定値であることが明示されず、ソースが確定値を公表するとその値に置き換えられます。

続けて、経済データAPIリファレンスまたは確認：エラーと再試行。