すべてのAPI

経済指標カレンダーAPI

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

最初のリクエスト

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"

レスポンスの例説明用レスポンス · 実際のリクエストによるものではありません

{
  "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
}

カレンダー購読

Narwhal API で、チームが選んだ国と日付範囲の購読用 ICS フィードを作成できます。提供されている祝日、経済指標の発表日、またはその両方を含められます。Google カレンダー、Apple カレンダー、Outlook などのカレンダークライアントで利用できます。

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": "example-subscription",
  "url": "https://api.narwhalapi.com/v1/calendars/subscriptions/EXAMPLE_TOKEN.ics",
  "expires_at": "2026-12-31T23:59:59Z",
  "refresh_note": "calendar clients control refresh latency"
}

エンドポイント

GET日付範囲の発表を一覧表示。/v1/economics/calendar

APIリファレンス →

GET必要に応じてversion_idを指定し、発表データを取得。/v1/economics/calendar/{release_id}

APIリファレンス →

データの仕組み

発表予定に合わせて計画を立てる

国と日付範囲でカレンダーを絞り込み、返された発表IDを使って各発表を追跡します。

スケジュールを理解する

正確な時刻、日付、推定範囲、期限、不明なスケジュールを区別します。

発表を追跡する

発表データと、そのバージョン、対象期間、ステータス、公表タイムスタンプを取得します。

カバレッジ

カバレッジを表示 →

発表予定があっても、特定の時刻に公表される保証はありません。予定日時の粒度とタイムゾーンを保持し、中止された発表を明示的に処理してください。公表タイムスタンプと観測タイムスタンプは、それぞれ異なる出来事を表します。

よくある質問

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

いいえ。発表元が日付、期間、または期限のみを示す場合もあります。スケジュールオブジェクトは、その日時の粒度を保持します。

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

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

最初のリクエストを実行

無料のAPIキーを取得 →