経済指標発表 API リファレンス

発表予定を一覧表示し、元の予定日時の精度を保ったまま、不変の公表バージョンを取得します。

リクエスト

どちらの操作でも Narwhal Bearer キーを使用します。製品概要→

発表を一覧表示

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-10-01&end_date=2026-10-31&limit=25" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

GET /v1/economics/calendar/{release_id} で発表を1件取得します。パラメータ version_id を追加すると、特定の不変バージョンを選択できます。

パラメータ

パラメータ	規則
`countries`	任意の ISO alpha-3 コード。複数の国を指定するにはクエリパラメータを繰り返します。最大50か国です。
`start_date / end_date`	開始日と終了日を含む任意の日付範囲。デフォルトは今日の30日前から335日後までで、範囲は最大366日です。
`view`	`view` は、発表ごとに簡易エントリを返す `compact`（デフォルト）、または `GET /v1/economics/calendar/{release_id}` が返すものと同じオブジェクトを返す `full` です。完全表示には、バージョン、改訂、スケジュールの詳細、値のタイムスタンプ、季節調整、改訂前の値という、すべてのフィールドが含まれます。
`limit / cursor`	1ページあたり1～100件、デフォルトは100件です。続きの取得には `next_cursor` を使い、フィルターは変更しないでください。
`release_id / version_id`	リリースの詳細では、UUID パス ID とオプションの UUID バージョン ID を使用します。

レスポンスの例

一覧レスポンスの例です。詳細取得操作では、同じフィールドを持つ発表オブジェクトを1件返します。

200 OK

{
  "status": "ok",
  "snapshot": "calendar-snapshot-20260914",
  "as_of": "2026-09-14T08:00:00Z",
  "releases": [
    {
      "release_id": "00000000-0000-4000-8000-000000000201",
      "series_id": "usa-consumer-prices",
      "country": "USA",
      "name": "Consumer prices",
      "topic": "consumer_prices",
      "title": "Consumer Price Index",
      "period": "2026-09",
      "status": "scheduled",
      "at": "2026-10-14T12:30:00Z",
      "timezone": "America/New_York"
    }
  ],
  "next_cursor": null
}

フィールド	規則
`title / name`	`title` は公開元自身のタイトルで、公開元の言語と表現のままです。`name` は、`Producer prices` や `Labour force survey` など、決められた一覧から選ばれる Narwhal の標準英語名で、日付は含みません。
`series_id`	`series_id` は Narwhal が系列に付与する恒久的な ID で、`tur-producer-prices` のようにすべての版で共通です。系列がまだ分類されていない場合は含まれません。
`topic`	`topic` は系列が何を測定しているかを示し、`consumer_prices`、`labour_force`、`gdp`、`merchandise_trade`、`policy_rate` のように国をまたいで共通です。系列がまだ分類されていない場合は含まれず、新しいトピックが追加されることがあります。
`stage`	`stage` は、その発表に含まれるのが対象期間の数値のどの版かを示します（`flash`、`advance`、`first`、`second`、`third`、`preliminary`、`final`）。版が1つしかない発表では含まれません。
`at / date / between / by`	日付が確定すると、タイミングを示すフィールドが1つ表示されます。`at` は正確な発表時刻、`date` は時刻が未定の発表日、`between` は `[from, to]` 形式の両端を含む候補日の範囲、`by` は発表され得る最終日で、約束された日ではなく期限を表します。すべてのタイムスタンプは UTC です。`timezone` は公開元の IANA タイムゾーンで、完全表示では `schedule.local_date` がそのタイムゾーンでの発表日です。
`period / values`	`period` は発表の対象期間です。`values` は数値の公表後に表示され、`measure`、`unit`、`transformation`、`actual`、`previous` を含み、金額の場合は `currency` と `scale` も含みます。

リストはデフォルトで簡易形式のエントリを返し、フィールドは値がある場合にのみ表示されます。すべてのフィールドを取得するには view=full を指定してください。一部の公開元が発表と並べて掲載している調査記事や、繰り返し掲載されるデータセットは含まれません。

スケジュールとステータスの意味

family の 1 つです gdp, prices, labour, trade, yield_curve, policy_rate, activity, survey, housing, money、または public_finance。 status 次のもの： scheduled, published、または cancelled。

スケジュール precision 次のもの： exact, date, estimated_range, deadline、または unknownです。ソースのタイムゾーンと、取得できた日時範囲の上下限を保持してください。期限は最も遅い日付を示すもので、公表日を約束するものではありません。 observed_at および officially_published_at はそれぞれ異なる事象を表し、null の場合もあります。

中止と日程変更は、それぞれ明示的なバージョンとして保持されます。不明な時刻を午前0時で補完しないでください。

Narwhalのカレンダーにある欧州中央銀行とカナダ銀行の発表日時は、それぞれの銀行のウェブサイトから取得しており、各サイトで無料で確認できます。すべてのレスポンスで、欧州中央銀行の各発表には notice フィールドが含まれ、出典が欧州中央銀行であることと、情報が https://www.ecb.europa.eu で無料で入手できることを明記しています。

リリースカレンダーの対象範囲

以下の国では、一部の公式発表予定を利用できます。対象範囲は公表機関と経済系列によって異なり、掲載されていてもすべての指標に発表予定があるとは限りません。国と日付範囲で一覧リクエストを絞り込み、そのスナップショットに含まれる発表を確認してください。

発表スケジュールがある国 · 35

結果が空の場合、そのスナップショットにはクエリに該当する発表が記載されていないことを意味します。公表機関に今後の発表予定がないことを保証するものではありません。祝日と銀行休業日は別のカレンダーデータセットです。

数値

経済指標発表カレンダー API の各リリースには、indicators 配列が含まれます。各指標には、発表元が公表した数値が格納されます。actual はそのリリースの対象期間の数値、previous はその1つ前の期間の数値です。Narwhal がこれらの数値を計算することはありません。以下のフィールドは、各数値の対象期間、単位、変換方法、年率換算の有無を示します。

フィールド	規則
`period / previous_period`	`period` は数値の対象期間を示し、月（`2026-08`）、四半期（`2026-Q3`）、指定日を最終日とする週（`2026-09-26`）、またはローリング3カ月（`2026-06/2026-08`、最初と最後の月）のいずれかの形式です。`previous_period` は同じ形式で1つ前の期間を示します。週次リリースでは、失業保険継続受給者数のように、リリース自体の対象週より1週前の数値が含まれる場合があります。
`unit`	`unit` は、`percent`、`index`（`2015=100` などの `index_base` を伴う）、`thousands`、`currency`、`ratio`（求人倍率など）、または `balance`（調査のネットバランスで、パーセントではなくポイントで表す）です。
`currency / scale`	`currency`（ISO 4217コード）と`scale`（`units`、`thousands`、`millions`、`hundred_millions`、または`billions`）は、`unit`が`currency`の場合にのみ表示されます。数値には、発行元が表記した表示単位が使用されます。
`transformation`	`transformation` は、`level`、`month_over_month`、`year_over_year`、`quarter_over_quarter`、`three_month_on_three_month`、または `change`（雇用者数の増減など、水準の差を千単位で表したもの）です。
`annualization`	`annualization` は常に含まれ、`annualized`（米国の GDP 成長率の年率換算値など）または `not_annualized` のいずれかです。
`actual / previous`	`actual` はそのリリースの対象期間の数値で、`previous` はその1つ前の期間の数値です。どちらも発表元が公表したもので、Narwhal が計算することはありません。リリースに記載がない場合、`previous` は `null` になることがあります。その場合、次のリリースには、前の `actual` が `previous` として含まれます。

今後、これらのフィールドに新しい値が追加される可能性があるため、クライアントは未知の値も受け入れられるようにしてください。