すべてのAPI

経済指標カレンダーAPI

予定されている経済指標の発表とその公表状況を追跡します。不確実な予定を正確な時刻として扱うことなく、GDP、物価、労働、貿易、イールドカーブの発表カレンダーを作成できます。

稼働中94.13% uptime, last 30日674 ms 標準応答

最初のリクエスト

ある月のリリースを一覧する

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-10-01&end_date=2026-10-31" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
レスポンスの例
{
  "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
}

中央銀行の政策金利決定を調べる

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-12-09&end_date=2026-12-09" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
レスポンスの例
{
  "releases": [
    {
      "release_id": "52e78613-4f51-4cc8-b8dd-a4c3cc798c50",
      "revision": 1,
      "country": "USA",
      "series_id": "usa-monetary-policy-press-conference",
      "name": "Monetary policy press conference",
      "topic": "policy_communication",
      "family": "policy_rate",
      "status": "scheduled",
      "at": "2026-12-09T19:30:00Z",
      "timezone": "America/New_York",
      "values": []
    },
    {
      "release_id": "ed7bb0f9-6b9b-4e27-9b43-d891742ec3d4",
      "revision": 1,
      "country": "USA",
      "series_id": "usa-policy-rate-decision",
      "name": "Policy rate decision",
      "topic": "policy_rate",
      "family": "policy_rate",
      "status": "scheduled",
      "at": "2026-12-09T19:00:00Z",
      "timezone": "America/New_York",
      "values": []
    }
  ],
  "next_cursor": null
}

カレンダー購読

curl --request POST \
  --url "https://api.narwhalapi.com/v1/calendars/subscriptions" \
  --header "Authorization: Bearer $NARWHAL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"countries":["USA"],"start_date":"2026-09-01","end_date":"2026-12-31","include_releases":true,"include_holidays":true}'
レスポンスの例
{
  "subscription_id": "00000000-0000-4000-8000-000000000301",
  "url": "https://api.narwhalapi.com/v1/calendars/subscriptions/EXAMPLE_TOKEN.ics",
  "expires_at": "2027-10-22T09:00:00Z"
}

エンドポイント

GET発表を一覧表示/v1/economics/calendar

日付範囲の発表を一覧表示。

パラメータ

  • countries任意

    ISO alpha-3 コード。USA など。複数の国はパラメータを繰り返し、最大 50 か国です。

  • start_date任意

    期間の初日。既定では今日の 30 日前から始まります。

  • end_date任意

    期間の最終日。既定では今日の 335 日後で終わります。期間は最長 366 日です。

  • limit任意

    1ページあたりの発表件数で、1から100です。既定は100です。

  • cursor任意

    next_cursor と同じフィルターで続きを取得します。

リスト内の各リリース

  • release_id文字列

    詳細を読むリリース。

  • name文字列

    Narwhal の標準の英語名。Producer prices など。日付は含みません。

  • topic文字列

    系列が測るもの。どの国でも同じで、consumer_prices や gdp など。

  • period文字列

    リリースが対象とする期間。2026-09 や 2026-Q3 など。

  • status文字列

    リリースの状況。scheduled など。

  • at / date / between / by文字列

    発表機関が示した時期。正確な時刻、日、日の範囲、期限のいずれかです。日付が不明なときは None になります。

  • values配列

    公表された数値。公表されるまでは空の配列です。


リファレンス全文 →
GETリリースを 1 件取得する/v1/economics/calendar/{release_id}

必要に応じてversion_idを指定し、発表データを取得。

パラメータ

  • release_id必須

    リリースの UUID。

  • version_id任意

    以前のバージョンの UUID。省略すると現在のバージョンが返ります。

発表

  • version文字列

    変更されないバージョン。version_id として渡し直せます。

  • name文字列

    Narwhal の標準の英語名。Producer prices など。日付は含みません。

  • topic文字列

    系列が測るもの。どの国でも同じで、consumer_prices や gdp など。

  • period文字列

    リリースが対象とする期間。2026-09 や 2026-Q3 など。

  • status文字列

    リリースの状況。scheduled など。

  • at / date / between / by文字列

    発表機関が示した時期。正確な時刻、日、日の範囲、期限のいずれかです。日付が不明なときは None になります。

  • values配列

    公表された数値。公表されるまでは空の配列です。


リファレンス全文 →

ユースケース

次の CPI 発表日

米国の次の CPI がいつ出るかを、UTC とニューヨーク時間で調べます。

ガイドを読む →

経済カレンダー

選んだ国と日付のリリースカレンダーを作ります。

ガイドを読む →

発表前のアラート

カレンダーフィードや毎日のスクリプトから、発表前にリマインダーを受け取ります。

ガイドを読む →

自分のタイムゾーンでの発表時刻

UTC の発表時刻を、夏時間を考慮して現地時間に変換します。

ガイドを読む →

FOMC の会合と議事要旨

予定されている FOMC の金利決定と議事要旨を一覧します。

ガイドを読む →

カバレッジ

114か国。うち43か国は発行元そのものから発表スケジュールを読み、残りの71か国は外部カレンダーの日付で、参考値と表示されます。

114か国をすべて表示

ソース

公的な発行元55機関:統計局、省庁、中央銀行。発行元自身の日付と数値は、常に外部カレンダーより優先されます。

  • Instituto Nacional de Estadística y Censos (INDEC)アルゼンチン
  • Australian Bureau of Statistics (ABS)オーストラリア
  • Statistics Austriaオーストリア
  • Eurostat7か国
  • Statbelベルギー
  • National Bank of Belgiumベルギー
  • Banco Central do Brasilブラジル
  • National Statistical Institute (NSI)ブルガリア
  • Statistics Canadaカナダ
  • Central Bank of Chile (BCCh)チリ
  • National Statistics Institute of Chile (INE)チリ
  • Croatian Bureau of Statistics (CBS)クロアチア
55 件のソースをすべて表示
  • Czech Statistical Office (ČSÚ)チェコ
  • Statistics Denmarkデンマーク
  • Statistics Estoniaエストニア
  • European Commission (DG ECFIN)ユーロ圏
  • Statistics Finlandフィンランド
  • Finnish Customs (Tulli)フィンランド
  • National Institute of Statistics and Economic Studies (INSEE)フランス
  • French Customsフランス
  • Federal Statistical Office of Germany (Destatis)ドイツ
  • Hellenic Statistical Authority (ELSTAT)ギリシャ
  • Hungarian Central Statistical Office (KSH)ハンガリー
  • Statistics Icelandアイスランド
  • Ministry of Statistics and Programme Implementation (MoSPI)インド
  • Central Statistics Office (CSO)アイルランド
  • Italian National Institute of Statistics (Istat)イタリア
  • Statistics Bureau of Japan日本
  • Cabinet Office of Japan日本
  • Japan Customs日本
  • Central Statistical Bureau of Latvia (CSB)ラトビア
  • State Data Agency of Lithuaniaリトアニア
  • STATECルクセンブルク
  • Department of Statistics Malaysia (DOSM)マレーシア
  • INEGIメキシコ
  • Statistics Netherlands (CBS)オランダ
  • Stats NZニュージーランド
  • Statistics Norway (SSB)ノルウェー
  • Statistics Polandポーランド
  • Statistics Portugal (INE)ポルトガル
  • National Bank of Romania (BNR)ルーマニア
  • Federal State Statistics Service (Rosstat)ロシア
  • Bank of Russiaロシア
  • Singapore Department of Statistics (SingStat)シンガポール
  • Singapore government open-data publicationsシンガポール
  • Statistical Office of the Republic of Slovenia (SURS)スロベニア
  • National Statistics Institute of Spain (INE)スペイン
  • Spanish Tax Agency (AEAT)スペイン
  • Statistics Sweden (SCB)スウェーデン
  • Directorate-General of Budget, Accounting and Statistics (DGBAS)台湾
  • Turkish Statistical Institute (TurkStat)トルコ
  • Office for National Statistics (ONS)英国
  • Bureau of Labor Statistics (BLS)米国
  • Bureau of Economic Analysis (BEA)米国
  • US Census Bureau米国

関連 API

祝日 API

国別の公休日。全国と地域の区別付き。

APIを見る →

経済データAPI

物価、雇用、生産、貿易、金利の公式指標。

APIを見る →

料金

前払いクレジット、1,000回あたり2ドル、プランや段階なし。

料金を見る →

よくある質問

すべての発表に正確な時刻が設定されていますか?

いいえ。公表機関が日付、期間、期限のみを示す場合もあります。レスポンスは最上位の at、date、between、by のいずれかで、その精度を保持します。

以前のバージョンを取得できますか?

発表の詳細を取得するリクエストでversion_idパラメータを使用し、不変のバージョンを選択します。

無料の経済指標カレンダーAPIはありますか?

はい。Narwhalの全アカウントに毎月10ドルの無料クレジットがあり、カード不要で期限もありません。カレンダーのリクエストは1回の呼び出しで、1,000回あたり2ドルなので、無料クレジットで月5,000回まで使えます。

カレンダーにコンセンサス予想はありますか?

はい。外部のカレンダーに予想があるときに限ります。値には前回値と並んでコンセンサスが付き、発表後は実績値も付きます。コンセンサスは予想であり公表された数字ではなく、わからないときは含まれません。重要度の評価はありません。

発表時刻のタイムゾーンは何ですか?

正確な発表時刻(atフィールド)はUTCです。timezoneフィールドには発行元自身のIANAタイムゾーン(Asia/Jakartaなど)が入るので、現地時刻に直せます。日付だけの発表には時刻がありません。

カレンダーはどのくらいの履歴を返しますか?

1回のリクエストで最大366日の期間を扱えます。既定は今日の30日前から335日後までです。それより長い範囲は期間ごとに分けて取得してください。内容が変わった発表は以前の版を保持し、version_idで読めます。

カレンダーをICSフィードで取得できますか?

はい。カレンダーのサブスクリプションを作成すると、カレンダーアプリが購読できる非公開の.icsリンクが返ります。発表、祝日、またはその両方を、1〜50か国、最大366日の期間で含められます。作成は1回の呼び出しです。

AIエージェントはMCPでカレンダーを読めますか?

はい。Narwhal MCPサーバーにはeconomics_list_releasesとeconomics_get_releaseがあり、RESTエンドポイントと同じ2つの操作です。

レート制限はどうなっていますか?

無料クレジットのみのアカウントは1分あたり50リクエスト、有料クレジットを持つと1分あたり500リクエストです。1つのネットワークアドレスは1分あたり120に制限されます。429レスポンスにはRetry-Afterが付き、課金されません。

データを使う前に何を確認すべきですか

公表予定は、正確にその時刻に公表されることを保証するものではありません。公表時期の精度とタイムゾーンを保持し、中止となった公表予定を明示的に処理してください。公表予定時刻と Narwhal が確認した時刻は、それぞれ異なる出来事を示します。