経済カレンダーを作成する

APIを使う方法

発表日には経済カレンダーを使います。各発表には、時刻、国、名称のほか、対象期間、トピック、ステータス、タイムゾーンのフィールドがあります。印刷した予定表より詳しい情報がプロダクトやダッシュボードに必要なら、これらのフィールドを発表と一緒に保持してください。

1. APIキーを設定 無料キーを取得し、環境変数 NARWHAL_API_KEY に保存します。スクリプトはこの変数を読み取り、キーを Authorization: Bearer YOUR_KEY として https://api.narwhalapi.com に送ります。NarwhalはREST用もMCP用も同じキーを使います。
2. 国と日付を選ぶ countries パラメーターを繰り返し指定し、start_date と end_date を渡します。この例では2026年11月9日から13日の USA、GBR、JPN を使います。別のスケジュールにしたいときは、国のリストと日付の引数を変更してください。リクエストの宛先は /v1/economics/calendar のままにします。
3. 発表を取得して並べ替える キーを環境変数に入れた状態でPythonスクリプトを実行します。スクリプトは全ページの発表を集め、at を持つレコードを選び、時刻、国、名称をまとめて並べ替えます。出力されるスケジュールはUTCの時刻で、最後に指定した日付範囲の発表件数が表示されます。
   Python：3か国の1週間分の発表

   import os
   import requests
   
   HEADERS = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   
   
   def calendar(countries, start, end):
       cursor = None
       while True:
           params = {
               "countries": countries,
               "start_date": start,
               "end_date": end,
               "limit": 100,
           }
           if cursor:
               params["cursor"] = cursor
           r = requests.get(
               "https://api.narwhalapi.com/v1/economics/calendar",
               params=params,
               headers=HEADERS,
               timeout=10,
           )
           r.raise_for_status()
           body = r.json()
           yield from body["releases"]
           cursor = body.get("next_cursor")
           if not cursor:
               return
   
   
   rows = sorted(
       (x["at"], x["country"], x["name"])
       for x in calendar(["USA", "GBR", "JPN"], "2026-11-09", "2026-11-13")
       if "at" in x
   )
   for at, country, name in rows:
       print(at, country, name)
   print(len(rows), "releases")

4. 表示するフィールドを選ぶ より詳しいカレンダーには、at（UTC）、country、name、period、topic、status、timezone を表示します。スクリプトが出力するのは時刻、国、名称だけです。発表の版を区別する必要があるときは stage も残しておきます。values 配列は数値が公表されるまで空なので、数値が出る前でも予定された発表を表示できます。

Webサイト、カレンダーアプリ、シートを使う

Narwhalのウェブサイトで発表を見るには、経済カレンダーを開きます。国ごとに経済カレンダーのページがあるため、リクエストを書かずに国の予定を見たいときの近道です。

カレンダーフィードを使うと、同じ発表がカレンダーアプリに表示されます。その方法は経済指標発表前にアラートを受け取るを参照してください。シートを使う場合は、スクリプトの出力（UTCの時刻、国、発表名）を保存できます。シートはAPIの出力から始める方法で、コードなしで予定を見たいときはWebサイトとフィードが使えます。

状況に応じた方法の選び方

英国でGDPが2回表示されるのはなぜですか？

発表の2つの版が同じ時刻になることがあり、stage で区別できます。たとえば速報値と月次の数値が同じ予定時刻になることがあります。このフィールドは、フラッシュ、アドバンス、初回、確定の各版も区別するため、発表名と時刻だけでは版が同じに見えてしまうことがあります。

名称と一緒に stage か release_id を表示して、項目を区別します。2026年11月12日07:00 UTCに、英国のスケジュールにはGDPが2件含まれています。その予定を表示するときは両方の項目を残し、各名称の横に版または識別子が見えるようにしてください。

1回のリクエストで何件の発表が返りますか？

1ページには最大100件の発表が返ります。limit でページの大きさを決め、cursor を渡して結果の続きを取得します。1ページは、リクエストしたスケジュールの一部です。同じ国と日付で集めるべき発表が残っているかどうかは、next_cursor で判断してください。

next_cursor が null または空になるまで続けます。APIが 409 cursor_expired を返したら、カーソルなしでリクエストをやり直します。そのリクエストでも国と日付の選択は維持して、求めたスケジュールを最初から取得してください。

カレンダーに含められる国はどれですか？

countries を省略すると、対応しているすべての国が返ります。国コードは最大50個まで指定できます。ユーロ圏には EMU を使います。

Pythonの例では国のリストを渡し、それがリクエストでは繰り返しの countries パラメーターになります。全国のカレンダーが欲しいときは、リクエストからこのパラメーターを外します。日付範囲はそのまま残し、UTCの時刻で発表を並べ替える前にすべてのページを集めてください。

計算例：2026年11月9日から13日

2026年11月9日から13日については、まず米国の項目を数えます。卸売売上高、消費者物価、賃金・所得、失業保険申請件数、石油在庫、財政収支、生産者物価で、米国は7件です。日本は家計支出と国際収支の2件が同じ日付範囲に入っています。

次に英国のGDPの項目を別に数えます。建設生産、財・サービス貿易、鉱工業生産、サービス生産と合わせて、2026年11月9日から13日の英国は6件です。国ごとの件数を足すと、スケジュール全体の合計になります。

UTCの時刻を日付順に読みます。2026年11月9日は、米国の卸売売上高が15:00、日本の家計支出が23:30、日本の国際収支が23:50です。2026年11月10日は、米国の消費者物価と賃金・所得が13:30で同時刻です。2026年11月12日は、米国の失業保険申請件数が13:30、石油在庫が17:00、財政収支が19:00です。米国の生産者物価は2026年11月13日の13:30です。

2026年11月9日から13日で最も混み合う時間帯は、11月12日の07:00 UTCで、英国の6件すべてが集中しています。並べ替えたスケジュールでは、このグループにGDPの2つの版のほか、建設生産、財・サービス貿易、鉱工業生産、サービス生産が含まれます。