財經事件

獲取財經日曆中的財經事件:政要講話、國際會議、論壇等重要事件的時間、關聯的國家或地區和重要程度。適合做事件日程表和交易風險提示。

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

以下 API 等級可以調用本接口:創業 標準 專業 企業

更新頻率每 10 分鐘

響應數據

data 為陣列,每個元素是一項財經事件,例如政要講話、國際會議和論壇。與「經濟數據」不同,本接口不返回公佈值、預測值等數值欄位。右側範例為不傳 language(中文)時 2026-10-19 04:00 至 2026-10-20 04:00 UTC 的實際返回,共 4 條,範例保留 2 條。

📘

英文查詢的空結果

2026-10-26(UTC)查詢時,同一時間範圍傳 zh 返回日程,傳 zh 以外的值(例如 en、zh-tw)都返回 code="0"、data=[]。需要現有日程內容時,請省略 language 或傳 zh,返回的內容為中文。英文查詢的空陣列不能據此解釋為該時間範圍內沒有日程。本說明記錄該日期的返回行為。

📘

時間範圍按公佈時間篩選

本接口按公佈時間 publish_timestamp 篩選,不同傳參的結果見下表,建議兩個參數都傳。能查到的時間範圍以已收錄的日程為準。本接口沒有 interval、limit 參數,時間戳與分頁中按 interval × limit 推算時間範圍的規則不適用於本接口。

傳入的時間參數返回的數據
同時傳 start_time 和 end_timestart_time ≤ publish_timestamp < end_time 的數據,包含開始時間,不包含結束時間
只傳 start_time從開始時間到現在的數據
只傳 end_time結束時間之前已收錄的全部數據
都不傳到現在為止已收錄的全部數據

200 · application/json · 響應範例見右側面板。

欄位類型必返說明
codestring是業務狀態碼,"0" 表示成功
msgstring否結果說明;成功時不返回
dataarray of object是財經事件列表,每個元素是一項事件
data[].calendar_namestring是事件名稱(描述),例如 美国财长贝森特发表讲话
data[].country_codestring否事件關聯的國家或地區代碼,例如 USA、CHN;不是統一的 ISO 代碼,也不一定是舉辦地。部分事件不返回本欄位
data[].country_namestring是國家或地區名稱;可能為空字串
data[].publish_timestampinteger(int64)是公佈或舉行時間,毫秒時間戳(UTC);是否為準確時刻見 has_exact_publish_time
data[].importance_levelinteger是重要程度,取值 1、2、3,數字越大越重要
data[].has_exact_publish_timeinteger是是否有具體公佈時間:1 表示有具體時間;2 表示沒有具體時間,此時 publish_timestamp 只能作為日期參考(財經事件、央行動態中這類事件的時間通常為 UTC 16:05,即北京時間 00:05)

API 等級

只有下表中標為可以的 API 等級能調用本接口。各等級價格見 API 等級。

API 等級能否調用
業餘❌ 不可以
創業✅ 可以
標準✅ 可以
專業✅ 可以
企業✅ 可以

用 AI 調用本接口

選一個任務,點「在 ChatGPT 中開啟」或「在 Claude 中開啟」,AI 會先讀取本頁說明,再直接給出結果;也可以點「複製」,把完整提示詞貼上到你常用的 AI 工具裡。

生成本週事件日程
讓 AI 寫一個 Python 函式,把未來 7 天的財經事件按日期整理成日程表。
導出為日曆檔案
讓 AI 寫代碼,把財經事件導出為可導入手機日曆的 .ics 檔案。
看懂這個接口
讓 AI 用白話解釋返回欄位和時間參數。

本接口透過 REST API 提供數據,可使用上方提示詞讓 AI 編寫調用代碼。MCP 可調用的工具見 CoinGlass MCP。

應用場景

場景說明
事件日程表在看板或 App 中列出未來幾天的政要講話、國際會議等事件,按重要程度標記。
交易風險提示在重要講話、會議前提醒交易者,必要時降低槓桿或暫停自動策略。
同步到個人日曆把事件導出為日曆檔案,導入手機或電腦日曆。
事件影響研究把事件時間與價格數據對齊,復盤重要事件前後的市場表現。

相關接口

接口區別
經濟數據帶公佈值、預測值、前值的宏觀經濟指標
央行動態各國央行官員講話、會議和報告發布
新聞事件相關的新聞報道
代幣解鎖列表加密貨幣項目的代幣解鎖計劃

常見問題

has_exact_publish_time 為 2 時,publish_timestamp 是什麼時間?

2 表示沒有具體公佈時間,publish_timestamp 只能說明大概在哪一天。財經事件、央行動態中這類事件的時間通常為 UTC 16:05(北京時間 00:05),顯示時建議寫成「全天」,不要當作準確時刻。1 表示有具體時間。

為什麼查不到未來的事件?

不傳 end_time 時按當前時間處理。要查看未來的日程,請同時傳 start_time(例如當前時間)和未來的 end_time,例如當前時間加 7 天的毫秒時間戳。能查到多遠的未來日程,以已收錄的日程為準。

為什麼有的事件沒有 country_code?

部分事件不返回 country_code,country_name 為空字串,例如「美國總統特朗普發表講話」。讀取前請先判斷欄位是否存在;按國家或地區篩選時,可同時檢查 calendar_name。

importance_level 哪一檔最重要?

取值 1、2、3,數字越大越重要。只關注重大事件時,可以只保留 3。

深入了解:財經事件

財經事件包括哪些內容?

主要是沒有具體數值的財經日程,例如國家領導人和財政官員的講話、國際會議、金融論壇等。帶數值的指標公佈請使用「經濟數據」接口。

財經事件為什麼會影響加密貨幣?

重要講話和會議可能透露財政、貨幣或監管政策的方向,市場會據此調整預期,加密貨幣等風險資產的價格也可能隨之波動。

沒有具體時間的事件怎麼處理?

has_exact_publish_time 為 2 的事件只能確定大概在哪一天。顯示時建議標為「全天」,做提醒時以當天開始為準。

Query Params
integer

開始時間,毫秒時間戳(UTC),選填,例如 1792382400000(2026-10-19 04:00 UTC)。同時傳 start_time 和 end_time 時,返回 start_time ≤ publish_timestamp < end_time 的數據:包含開始時間,不包含結束時間。不傳時不按開始時間篩選。

integer

結束時間,毫秒時間戳(UTC),選填,例如 1792468800000(2026-10-20 04:00 UTC)。不傳時按當前時間處理;要查詢未來的日程,請同時傳入 start_time 和未來的 end_time。同時傳 start_time 和 end_time 時,返回 start_time ≤ publish_timestamp < end_time 的數據:包含開始時間,不包含結束時間。

string
Defaults to zh

返回內容的語言,選填,預設 zh(中文)。注意與「經濟數據」不同:本接口不傳 language 時返回中文。2026-10-26(UTC)查詢時,傳 zh 以外的值(例如 en)返回 code="0"、data=[];需要現有日程內容時,請省略本參數或傳 zh,返回的內容為中文。

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json