經濟數據

獲取財經日曆中的經濟數據:各國宏觀經濟指標的公佈時間、公佈值、預測值、前值、重要程度和影響說明,支援中英文。適合做宏觀數據日曆和公佈提醒。

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

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

更新頻率每 10 分鐘

響應數據

data 為經濟日曆公佈記錄的陣列,包含公佈值、預測值和前值。右側範例展示兩條記錄;實際日期覆蓋及條數以每次響應為準,日程可能修訂。

📘

數值欄位是數據源給出的原始字串

published_value、forecast_value、previous_value、revised_previous_value 都是字串,保留數據源的原始格式:可能是數字、負數、百分比(如 -0.1%)、百分比區間、空字串,或帶前導空格。單位可能寫在 calendar_name 裡。計算前請先去掉空格、處理 % 和空值,再轉為數字。

📘

時間範圍按公佈時間篩選

本接口按公佈時間 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是指標名稱,例如 5月批发销售(月率);名稱中可能帶有統計週期和單位,語言由 language 決定
data[].country_codestring是數據源關聯的國家或地區代碼,例如 JPN、CAN、USA;不是統一的 ISO 代碼
data[].country_namestring是國家或地區名稱,語言由 language 決定,例如 加拿大 或 Canada
data[].data_effectstring是數據對市場影響的文字說明,例如 影响较小、利多加元,英文為 Minor Impact 等
data[].forecast_valuestring是預測值,字串,保留數據源的原始寫法;沒有預測時為空字串
data[].revised_previous_valuestring是數據源的前值修正欄位,字串,保留數據源的原始寫法;多為空字串。不一定是修正後的前值,需要前值時請用 previous_value
data[].previous_valuestring是前值:上一期的數值,字串,保留數據源的原始寫法
data[].publish_timestampinteger(int64)是公佈或舉行時間,毫秒時間戳(UTC);是否為準確時刻見 has_exact_publish_time
data[].published_valuestring是公佈值(本期實際數值),字串,保留數據源的原始寫法
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 工具裡。

列出未來 7 天的重要數據
讓 AI 寫一個 Python 函式,列出未來一週重要程度為 3 的經濟數據。
對比公佈值與預測值
讓 AI 寫代碼,解析字串數值,計算公佈值與預測值的差。
看懂這個接口
讓 AI 用白話解釋返回欄位和時間參數。

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

應用場景

場景說明
宏觀數據日曆在看板中列出未來要公佈的經濟數據,按重要程度標記,提前做好準備。
數據公佈提醒在重要數據公佈前推送提醒,交易者可提前調整倉位和槓桿。
預期差分析比較公佈值與預測值、前值,判斷數據好於還是差於預期。
研究宏觀數據影響把 publish_timestamp 與交易對 K 線歷史按時間對齊,研究某類數據公佈前後加密貨幣價格的變化。

相關接口

接口區別
財經事件政要講話、國際會議等沒有數值的財經事件
央行動態各國央行官員講話、會議和報告發布
快訊數據公佈後的市場消息和解讀
比特幣 vs 美國 M2 貨幣供應增長比特幣價格與美國貨幣供應的長期對比

常見問題

不傳 language,為什麼返回的是英文?

本接口 language 的預設值是 en,不傳時返回英文;傳 zh 才返回中文,傳其他值也返回英文。注意「財經事件」「央行動態」兩個接口的 language 預設值是 zh,不傳時返回中文,與本接口不同。

為什麼查不到未來的經濟數據?

省略 end_time 時預設截止請求時刻。查詢未來日程時,請同時傳入 start_time 和明確的未來 end_time,單位均為毫秒,結束時間不包含在結果內。只能查詢接口當前可用的日程,日程可能修訂。

數值欄位怎麼轉成數字?

四個數值欄位都是保留原始格式的字串,可能是數字、負數、百分比、百分比區間、空字串或帶前導空格,單位可能寫在 calendar_name 裡。請先去掉空格、處理 % 和空值,再轉為數字;無法解析的保留原文(建議原文和數字分兩列存),做加減和排序時跳過這些值。

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

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

深入了解:財經日曆與經濟數據

公佈值、預測值、前值分別是什麼?

公佈值是本期實際公佈的數值;預測值是市場在公佈前的預期;前值是上一期的數值。公佈值與預測值的差,常被稱為「預期差」。

經濟數據為什麼會影響加密貨幣價格?

通脹、就業等宏觀數據會改變市場對利率政策的預期,進而影響美元流動性和風險資產的表現。重要數據公佈前後,加密貨幣價格的波動往往會放大。

如何只看重要的數據?

按 importance_level 篩選,3 為最重要的一檔。也可以按 country_code 只看關心的國家或地區,例如 USA。

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 en

返回內容的語言,預設 en(英文),可選 en、zh(中文)。傳 zh 以外的值都返回英文。注意:不傳時返回英文,需要中文請傳 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