獲取財經日曆中的財經事件:政要講話、國際會議、論壇等重要事件的時間、關聯的國家或地區和重要程度。適合做事件日程表和交易風險提示。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等級可以調用本接口:創業 標準 專業 企業
響應數據
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_time | start_time ≤ publish_timestamp < end_time 的數據,包含開始時間,不包含結束時間 |
只傳 start_time | 從開始時間到現在的數據 |
只傳 end_time | 結束時間之前已收錄的全部數據 |
| 都不傳 | 到現在為止已收錄的全部數據 |
200 · application/json · 響應範例見右側面板。
| 欄位 | 類型 | 必返 | 說明 |
|---|---|---|---|
code | string | 是 | 業務狀態碼,"0" 表示成功 |
msg | string | 否 | 結果說明;成功時不返回 |
data | array of object | 是 | 財經事件列表,每個元素是一項事件 |
data[].calendar_name | string | 是 | 事件名稱(描述),例如 美国财长贝森特发表讲话 |
data[].country_code | string | 否 | 事件關聯的國家或地區代碼,例如 USA、CHN;不是統一的 ISO 代碼,也不一定是舉辦地。部分事件不返回本欄位 |
data[].country_name | string | 是 | 國家或地區名稱;可能為空字串 |
data[].publish_timestamp | integer(int64) | 是 | 公佈或舉行時間,毫秒時間戳(UTC);是否為準確時刻見 has_exact_publish_time |
data[].importance_level | integer | 是 | 重要程度,取值 1、2、3,數字越大越重要 |
data[].has_exact_publish_time | integer | 是 | 是否有具體公佈時間:1 表示有具體時間;2 表示沒有具體時間,此時 publish_timestamp 只能作為日期參考(財經事件、央行動態中這類事件的時間通常為 UTC 16:05,即北京時間 00:05) |
API 等級
只有下表中標為可以的 API 等級能調用本接口。各等級價格見 API 等級。
| API 等級 | 能否調用 |
|---|---|
| 業餘 | ❌ 不可以 |
| 創業 | ✅ 可以 |
| 標準 | ✅ 可以 |
| 專業 | ✅ 可以 |
| 企業 | ✅ 可以 |
用 AI 調用本接口
選一個任務,點「在 ChatGPT 中開啟」或「在 Claude 中開啟」,AI 會先讀取本頁說明,再直接給出結果;也可以點「複製」,把完整提示詞貼上到你常用的 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 的事件只能確定大概在哪一天。顯示時建議標為「全天」,做提醒時以當天開始為準。
