快速開始 定價 類型 回測與部署 權重管理 策略庫 分享 備份策略 加密貨幣 台股 商品期貨 總經事件 一鍵網頁版 IDE 用 IDE 開發 遠端桌面連線 工作區結構 更新 新增使用者

總經事件行事曆

Blave Agent 可存取全球總經事件行事曆（授權資料源），包含發布時間、市場預期值、前值與實際值。

涵蓋範圍

涵蓋主要經濟體的經濟數據發布與央行事件。一列一筆事件，帶有預定發布時間、市場預期值、前值，以及公布後的實際值。

這份行事曆是滾動約五週的窗口（過去一個月加上未來數週），不是歷史資料庫。查詢區間落在窗外會回空結果——那代表這段範圍沒有資料，不是這段期間沒有事件。

取用方式

Agent 透過 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，一列一筆事件。所有參數都可以省略，但不篩選會拿到所有國家、所有重要度的事件，建議先縮小範圍：

• start / end — 查詢區間，台北日期 'YYYY-MM-DD'，含頭含尾
• countries — ISO 兩碼國家清單，例如 ['US', 'CN', 'TW']；省略則不限國家
• max_priority — 只保留重要度在此級以上的事件；1 最重要、3 最不重要，所以只要大事件就填 1

欄位說明

• datetime — 事件時間，一律台北時間；沒有公布時間的事件以當日 00:00 計
• date / time — 台北日期與 'HH:MM'；未公布發布時間的事件，時間為空
• country / country_name — 國家 ISO 兩碼與國名
• subject / subject_title — 指標名稱，以及該次公布對應的期別
• predict — 市場預期值；沒有預期值時為空
• last — 前值，即同一指標前一次公布的數值
• real — 實際值；尚未公布時為空
• unit — 數值單位
• priority — 重要度 1–3，1 最重要