ドキュメント
APIリファレンスサイト
すべてのドキュメントを閲覧

変更履歴

Narwhal API からの製品とドキュメントの更新。

公開ウェブサイト、ドキュメント、API の提供状況の変更を追跡します。

経済データページ

  • 各国とその指標のページを追加しました。履歴チャート、CSVダウンロード、埋め込みに対応しています。
  • 各指標の国別一覧、国別・月別の経済指標カレンダー、利回り曲線を追加しました。
  • 英語版の国別カバレッジページは、各国のデータページにリダイレクトされるようになりました。

イベントとWebhook

  • GET /v1/eventsと/v1/events/stream WebSocketを追加しました。リプレイカーソルに対応しています。
  • Webhook送信先を追加しました。署名付きの少なくとも1回の配信、配信履歴、再送に対応しています。
  • predictionsファミリーにprediction.event.closedとprediction.event.settledを追加しました。

FXが144通貨に対応

  • 為替レート、履歴、通貨換算に113通貨を追加しました。
  • 従来の31通貨へのリクエストに変更はありません。

金属とFXの価格履歴

  • 金、銀、プラチナ、パラジウム向けにGET /v1/commodities/spot/{commodity}/{currency}/barsとcommodities_get_price_historyを追加しました。
  • 1通貨の対USDレート向けにGET /v1/fx/rates/{base}/barsとfx_get_rate_barsを追加しました。
  • バーの間隔は1m、5m、15m、1h、4h、1dです。分単位のバーは直近30日分を提供し、時間単位と日単位のバーは無期限に保持します。利用できる履歴はプランの範囲内です。

決済済みの予測イベントに結果を追加

  • RESTとMCPの予測イベント、イベント一覧、トピックのレスポンスに結果フィールドを追加しました。イベントが決着するまでは省略されます。
  • 各取引プラットフォームは final、settled_at、amended_at、unavailable を返します。イベントページには各市場の結果と値も含まれます。
  • Free は翌日（日次の区切り、00:00 UTC）から結果を確認できます。Basic と Pro は Narwhal が取得し次第確認できます。
  • X-Narwhal-Results: unavailable ヘッダーは保存済みの結果を読み取れなかったことを示します。この場合も result は省略されます。後で再試行してください。
  • ストリームと Webhook は引き続きステータスのみを伝えます。

商品の月次指標価格と価格履歴

  • 既存の現物価格系列エンドポイントに月次指標価格を追加し、系列の検索、詳細、最新価格、観測値の取得に対応しました。RESTとMCPで同じ系列IDを使用します。
  • ソフトコモディティ、油脂・油糧種子、金属、穀物、エネルギー、肥料、林産物、畜産物・乳製品を対象とします。すべての価格はUSD建てで、公表時の単位と数量を保持します。
  • 利用可能な最新月は2026年9月です。一部の系列は開始が遅い、または終了しています。各系列には固有の対象期間が記載されます。
  • 商品価格履歴APIのページ、銅のレスポンス例、月次指標価格の全対象一覧を追加しました。

米国のガソリンとディーゼル燃料の小売価格

  • /v1/commodities/physical/seriesに、系列の検索、系列の詳細、最新価格、観測値を取得する4つのREST・MCP操作を追加しました。
  • レギュラーガソリンと道路用2号ディーゼル燃料の週次系列20件を追加しました。それぞれ全米平均と9地域を対象とし、米ガロン当たりのUSD建てで提供します。
  • 履歴には2026年7月20日から10月5日までの12週分が含まれます。月曜日の調査後に更新されます。レスポンスは、日付、小数文字列の価格、nullを許容する公表日、改訂情報、出典情報を保持します。

WTI、ブレント、銅の参照価格

  • GET /v1/commodities/spot/{commodity}/{currency}とcommodities_get_spot_priceに、1バレル当たりUSD建てのWTIとBRENT、1ポンド当たりUSD建てのXCUを追加しました。
  • これらは先物市場に基づく参照価格であり、現物貨物のスポット価格ではありません。レスポンスフィールドとstaleフラグに変更はありません。
  • WTIとBRENTの価格履歴は、金属と同じ間隔とルールでGET /v1/commodities/spot/{commodity}/USD/barsとcommodities_get_price_historyから取得できます。銅は最新価格のみ対応しています。

プラチナとパラジウムのスポット価格を追加

  • RESTとMCP経由でUSD建てのXPTとXPDのスポット価格を追加しました。
  • 金と銀に変更はありません。金は31通貨建て、銀はUSD建てです。

スポット価格のbidとaskフィールドを削除

  • スポット価格のレスポンスからbidとaskを削除しました。残るフィールドはsymbol、price、currency、unit、timestamp、staleです。

経済指標の発表データで扱える値の種類を拡充

  • すべての指標にannualizationを追加し、常にannualizedまたはnot_annualizedを設定するようにしました。
  • 既存のindex、percent、thousandsにcurrency、ratio、balanceの単位を追加し、金額にのみcurrency（ISO 4217コード）とscale（units、thousands、millions、hundred_millions、billions）を付与しました。
  • 既存のlevel、month_over_month、year_over_yearに、quarter_over_quarter、three_month_on_three_month、changeの変換方式を追加しました。
  • reference_periodと値の期間で、既存の月（YYYY-MM）と四半期（YYYY-Qn）に加え、週の終了日（YYYY-MM-DD）とローリング3か月期間（YYYY-MM/YYYY-MM）を使用できるようにしました。
  • これらのフィールドには今後列挙値が追加される可能性があり、クライアントは未知の値を解析エラーにせず受け入れるべきであることを明確にしました。

過去の FX 観測値を提供中

  • GET /v1/fx/rates/{base}/observations と fx_get_rate_history を追加しました。
  • 全履歴のバックフィル用に、両端を含む日付範囲、日付件数に上限を設けたページ、フィルター条件に紐づく不透明カーソルを追加しました。
  • 週末、祝日、欠損通貨の前方補完を行わず、実際の観測日を保持します。

経済データAPIでオランダのデータを提供開始

  • 公開されている9つの経済RESTオペレーションすべてと対応するMCPツールにNLDを追加しました。
  • Statistics Netherlands (CBS)による月次のCPI、労働、財貿易データと四半期のGDPデータを公開しました。
  • オランダのカバレッジ、ソース方法論、APIドキュメント、機械向けディスカバリーを追加しました。

過去の経済データとオランダのカバレッジ

  • RESTとMCPを通じた、ページ分割対応の過去観測オペレーション9件を追加しました。
  • CBSによるオランダの公式のインフレ、労働、GDP、財貿易データを追加しました。
  • 公開の経済データAPIを10か国、18オペレーションに拡張しました。

経済データの公開ベータ

  • 9つの国別経済データのオペレーションをRESTとMCPで公開しました。
  • AUS、CAN、DEU、FRA、GBR、JPN、MYS、SGP、USAの最新の公式データの提供を開始しました。
  • 経済データのクイックスタートと機械可読のディスカバリー情報を公開しました。