すべてのドキュメントを閲覧

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

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

リクエスト

経済リリースカレンダーを参照 →

どちらの操作でも Narwhal Bearer キーを使用します。Each successful request costs one call on the Calendars API code, $2 per 1,000 calls. 製品概要→

発表を一覧表示
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日です。
limit / cursor1ページあたり1~100件、デフォルトは100件です。続きの取得には next_cursor を使い、フィルターは変更しないでください。
release_id / version_idリリースの詳細では、UUID パス ID とオプションの UUID バージョン ID を使用します。

不明な release_id は 404 not_found を返します。形式が不正、改ざん済み、またはフィルターと一致しないカーソルは 400 invalid_cursor を返します。30分を過ぎたカーソルや利用できないスナップショットは 409 cursor_expired を返します。期限切れのカーソルを外してやり直してください。

レスポンスの例

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

200 OK
{
  "releases": [
    {
      "release_id": "00000000-0000-4000-8000-000000000201",
      "revision": 0,
      "country": "USA",
      "series_id": "usa-consumer-prices",
      "name": "Consumer prices",
      "topic": "consumer_prices",
      "family": "prices",
      "period": "2026-09",
      "status": "scheduled",
      "at": "2026-10-14T12:30:00Z",
      "timezone": "America/New_York",
      "values": []
    }
  ],
  "next_cursor": null
}
フィールド規則
namename は、Producer prices や Labour force survey など、限定されたリストから選ぶ Narwhal の標準英語名です。日付は含みません。
series_idseries_idは、tur-producer-pricesのような、すべての版で共通するNarwhalの恒久的な系列IDです。UUIDではなくスラッグのため、/v1/economics/series/*のルートでは受け付けません。系列がまだ分類されていない場合は含まれません。
topictopic は系列が何を測定しているかを示し、consumer_prices、labour_force、gdp、merchandise_trade、policy_rate のように国をまたいで共通です。系列がまだ分類されていない場合は含まれず、新しいトピックが追加されることがあります。
stagestage は、その発表に含まれるのが対象期間の数値のどの版かを示します(flash、advance、first、second、third、preliminary、final)。版が1つしかない発表では含まれません。
at / date / between / by日付が不明な場合や、推定範囲に下限しかない場合は、時期を表すフィールドを返しません。at は正確な発表時刻、date は時刻未定の発表日、between は両端を含む候補日の範囲 [from, to]、by は最も遅い候補日です。by は期限であり、その日の発表を約束するものではありません。タイムスタンプはすべてUTCで、timezone は発表元のIANAタイムゾーンです。
period / valuesperiod は公表データの対象期間で、公表機関が示す粒度に従います。2026-09(月)、2026-Q3(四半期)、2018-04/2018-06(移動期間)、2026-09-12(日または週)、2025(年)などです。公表機関が対象期間を示していない場合は省略されます。values は常に含まれ、数値が公表されるまでは空です。下の「値」を参照してください。
date_basisdate_basis is indicative when the date comes from a third-party calendar and not from the publisher. An indicative date can still move. It is absent when the publisher or the central bank set the date. The publisher's date always wins over the third-party calendar.
meetingmeeting is set on a central bank's policy meeting and holds the meeting's days from the bank's own calendar. kind is scheduled (the date is on the bank's calendar for the year), unscheduled or extraordinary. starts_on is the first day of a multi-day meeting, when the bank gives it, and ends_on is the last day, the day the decision is announced.
revision / version / observed_atrevision は公表データの詳細が変更されるたびに増加します。一度も改訂されていなければ 0 です。GET /v1/economics/calendar/{release_id} は、不変のバージョンを示す version と、Narwhal が公表機関のカレンダーでその公表データを最後に確認した時刻を示す observed_at も返します。version は version_id として指定できます。

フィールドは値がある場合にのみ含まれます。一部の公表機関が公表予定と併せて掲載する研究記事や重複したデータセットは含まれません。

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

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

公表時期は最上位の at、date、between、by のいずれかで示されます。timezone と得られた範囲の境界を保持してください。by は期限であり、その日の公表を約束するものではありません。observed_at は、Narwhal が公表機関のカレンダーでその公表データを最後に確認した時刻です。

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

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

Consensus, indicative dates and central bank meetings

Besides the publishers' own schedules, the calendar carries a third-party calendar. It adds a consensus forecast to figures, dates for releases the publishers do not list, and the days of central bank policy meetings. The publisher's date and figure always win over the third-party calendar.

This request returns the Bank Indonesia policy rate decision with a meeting object and a consensus on each rate, and a bank lending release whose date is indicative. Nothing is published yet, so actual is absent.

Policy rate meeting and indicative date
curl --request GET \\
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=IDN&start_date=2026-11-18&end_date=2026-11-18" \\
  --header "Authorization: Bearer $NARWHAL_API_KEY"
200 OK
{
  "releases": [
    {
      "release_id": "7c9f64b5-bc4c-4875-9757-a5a3be9796dd",
      "revision": 1,
      "country": "IDN",
      "series_id": "idn-policy-rate-decision",
      "name": "Policy rate decision",
      "topic": "policy_rate",
      "family": "policy_rate",
      "status": "scheduled",
      "date": "2026-11-18",
      "timezone": "Asia/Jakarta",
      "values": [
        {
          "measure": "deposit_facility_rate",
          "period": "2026-11",
          "unit": "percent",
          "previous": "5",
          "consensus": "5"
        },
        {
          "measure": "lending_facility_rate",
          "period": "2026-11",
          "unit": "percent",
          "previous": "6.5",
          "consensus": "6.75"
        },
        {
          "measure": "policy_rate",
          "period": "2026-11",
          "unit": "percent",
          "previous": "5.75",
          "consensus": "6"
        }
      ],
      "meeting": {
        "kind": "scheduled",
        "ends_on": "2026-11-18"
      }
    },
    {
      "release_id": "ff160cc0-f950-4bde-8f98-73dbb6ff6423",
      "revision": 1,
      "country": "IDN",
      "series_id": "idn-bank-lending",
      "name": "Bank lending",
      "topic": "money_credit",
      "family": "money",
      "period": "2026-10",
      "status": "scheduled",
      "date_basis": "indicative",
      "at": "2026-11-18T07:30:00Z",
      "timezone": "Asia/Jakarta",
      "values": [
        {
          "measure": "bank_credit_yoy",
          "unit": "percent",
          "transformation": "year_over_year",
          "previous": "13.26"
        }
      ]
    }
  ],
  "next_cursor": null
}

After a decision, a figure from the third-party calendar shows as provisional until the publisher's own release confirms it. This answer is the Bank Negara Malaysia decision of 5 November 2026.

Provisional figure
curl --request GET \\
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=MYS&start_date=2026-11-05&end_date=2026-11-05" \\
  --header "Authorization: Bearer $NARWHAL_API_KEY"
200 OK
{
  "releases": [
    {
      "release_id": "007f2565-07af-43df-b778-0abef890689a",
      "revision": 1,
      "country": "MYS",
      "series_id": "mys-policy-rate-decision",
      "name": "Policy rate decision",
      "topic": "policy_rate",
      "family": "policy_rate",
      "status": "published",
      "date_basis": "indicative",
      "at": "2026-11-05T07:00:00Z",
      "timezone": "Asia/Kuala_Lumpur",
      "values": [
        {
          "measure": "policy_rate",
          "period": "2026-11",
          "unit": "percent",
          "actual": "2.75",
          "previous": "2.75",
          "consensus": "2.75",
          "provisional": true
        }
      ]
    }
  ],
  "next_cursor": null
}

Treat date_basis: indicative and provisional as signs that a date or a figure can still change.

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

The calendar covers 114 countries as of 13 November 2026. Official release schedules from statistical offices and central banks come first. A third-party calendar adds countries and releases that the publishers do not list in a form Narwhal can read. A date that comes only from the third-party calendar carries date_basis indicative。Coverage varies by publisher and economic series; inclusion does not mean every indicator has a schedule. Filter the list request by country and date window to see the releases available in that snapshot.

Countries in the calendar · 114

AGO ALB ARE ARG ARM AUS AUT AZE BEL BGD BGR BHR BIH BLR BRA BWA CAN CHE CHL CHN COL CPV CRI CYP CZE DEU DNK DOM ECU EGY EMU ESP EST FIN FRA GBR GEO GHA GRC GTM HKG HRV HUN IDN IND IRL ISL ISR ITA JAM JOR JPN KAZ KEN KGZ KOR LBN LKA LSO LTU LUX LVA MAC MAR MDA MEX MKD MLT MNE MNG MOZ MUS MWI MYS NAM NGA NLD NOR NZL OMN PAK PER PHL PNG POL PRT PRY PSE ROU RUS RWA SAU SGP SLV SRB SUR SVK SVN SWE SWZ SYC THA TUN TUR TWN UGA UKR URY USA UZB VNM ZAF ZMB ZWE

Countries with a release calendar page · 114

An empty result means no releases are listed for that query in the snapshot. It does not guarantee that the publisher has no upcoming releases. Central bank meeting dates are served in this calendar as meeting。Public holidays, including bank holidays, and exchange closures are separate calendar datasets: see the public holidays reference および次のもの: exchange closures reference (英語)。

数値

Each release in the economic release calendar API includes a values array, empty until figures are published. Each value is a figure printed by the publisher: actual for the release's own period and previous for the period before. An actual that comes from a third-party calendar is marked provisional. Narwhal never computes these figures.

公表済み数値の例
{
  "values": [
    {
      "measure": "producer_price_change_mom",
      "unit": "percent",
      "transformation": "month_over_month",
      "actual": "0",
      "previous": "0.1",
      "previous_revised_from": "0.2"
    }
  ]
}
フィールド規則
measuremeasure は発表内の数値の種類を識別します。例:producer_price_change_mom。
conceptconcept は、数値が何を測っているかを示します(例: gdp、cpi)。そのため、同じ数値はどの国でも同じ concept になります。transformation と annualization とあわせて読むと、同じ条件の数値同士を比較できます。
noticenotice には、ECB の規定など、公表機関がアクセスのたびに提示を求める利用条件が含まれます。公表データと併せて表示してください。該当する条件がない場合は省略されます。
periodperiod は、値の対象期間が公表データの period と異なる場合にのみ含まれます。例えば、失業保険継続受給者数は、公表データの対象週の前週を対象とします。
unitunit は percent(値が 1.2 なら 1.2%)、index(2015=100 などの index_base を伴う)、thousands、currency、ratio(求人倍率など)、または balance(調査の回答差。単位はポイントで、パーセントではありません)です。
currency / scalecurrency(ISO 4217コード)とscale(units、thousands、millions、hundred_millions、またはbillions)は、unitがcurrencyの場合にのみ表示されます。数値には、発行元が表記した表示単位が使用されます。
transformationtransformation は month_over_month、year_over_year、quarter_over_quarter、three_month_on_three_month、または change(雇用者数の増減など、水準の差を千単位で表したもの)です。水準値の場合は省略されます。
annualized / not_seasonally_adjustedannualized is true when the figure is at an annual rate, as with U.S. GDP growth. not_seasonally_adjusted is true when the figure is not seasonally adjusted. If annualized is absent, the figure is not annualized. If not_seasonally_adjusted is absent, the figure is seasonally adjusted, or, on a figure from a third-party calendar, the source does not say.
actual / previousactual は今回の対象期間の数値、previous はその前の期間の数値です。いずれも公表機関が掲載した数値で、Narwhal が計算したものではありません。公表資料に記載のない数値は省略されます。その後、次回の公表データでは、前回の actual が previous として含まれます。
consensusconsensus is the expected figure for the period, from a third-party calendar. It is a forecast and not a published figure. It is absent when no forecast is known, and it can appear on a value whose actual the publisher printed.
provisionalprovisional is true when actual has not been confirmed by the publisher's own release. The figure comes from a third-party calendar and can change when the publisher publishes. It is absent otherwise.
previous_revised_fromprevious_revised_from は、今回の公表で previous が改訂された場合の、当初公表された数値です。
value_statusvalue_status は actual がない場合にのみ含まれます。pending_capture は予定時刻を過ぎてから数値を取得するまで、unavailable はその数値がないまま公表済みまたは中止となった場合を示します。

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

このページは役に立ちましたか?