すべてのAPI

経済指標カレンダーAPI

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

稼働中90.59% uptime, last 30日433 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 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 の金利決定と議事要旨を一覧します。

ガイドを読む →

関連 API

祝日 API

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

APIを見る →

経済データAPI

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

APIを見る →

料金

無料で始められます。毎月10ドル分の無料クレジット、その後は1,000回あたり2ドルです。

料金を見る →

よくある質問

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

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

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

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

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

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