マクロイベントカレンダー

Blave Agent はライセンス取得済みの世界マクロイベントカレンダーにアクセスできます。発表時刻、市場予想、前回値、実績値を含みます。

ソース：Blave。課金についてはBlave Agent 料金と課金をご覧ください。

対象範囲

主要経済圏の経済指標の発表と中央銀行イベントを対象とします。1 イベント 1 行で、予定発表時刻、市場予想、前回値、および発表後の実績値を含みます。

このカレンダーは過去 1 か月と今後数週間を合わせた約 5 週間のローリングウィンドウであり、過去データのアーカイブではありません。ウィンドウ外の期間を指定すると空の結果が返ります。これはその期間が対象外であることを意味し、イベントがなかったという意味ではありません。

データへのアクセス

エージェントは lib/data.py の共通ヘルパーを通じてカレンダーを照会します：

from lib.data import fetch_economic_calendar

df = fetch_economic_calendar(
    headers,
    start='2026-07-01',
    end='2026-07-31',
    countries=['US', 'CN'],
    max_priority=1,
)

イベント時刻でソートされた DataFrame を返します（1 イベント 1 行）。パラメータはすべて省略可能ですが、フィルタなしでは全ての国・全ての重要度のイベントが返るため、まず絞り込んでください：

• start / end — 日付範囲。台北時間の日付を 'YYYY-MM-DD' で指定、両端を含む
• countries — ISO-2 国コードのリスト。例：['US', 'CN', 'TW']。省略するとすべての国
• max_priority — この重要度以上のイベントのみを残します。1 が最重要、3 が最も低いので、主要な発表だけが必要な場合は 1 を指定

フィールド

• datetime — イベント時刻（台北時間）。発表時刻が公表されていないイベントは当日 00:00 になります
• date / time — 台北日付と 'HH:MM'。発表時刻が公表されていないイベントでは時刻は空
• country / country_name — ISO-2 国コードと国名
• subject / subject_title — 指標名と、その発表が対象とする期間
• predict — 市場予想。予想が公表されていない場合は空
• last — 前回値。同じ指標の前回発表値
• real — 実績値。発表までは空
• unit — 数値の単位
• priority — 重要度 1–3（1 = 最重要）