獲取財經日曆中的經濟數據:各國宏觀經濟指標的公佈時間、公佈值、預測值、前值、重要程度和影響說明,支援中英文。適合做宏觀數據日曆和公佈提醒。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等級可以調用本接口:創業 標準 專業 企業
響應數據
data 為經濟日曆公佈記錄的陣列,包含公佈值、預測值和前值。右側範例展示兩條記錄;實際日期覆蓋及條數以每次響應為準,日程可能修訂。
數值欄位是數據源給出的原始字串
published_value、forecast_value、previous_value、revised_previous_value都是字串,保留數據源的原始格式:可能是數字、負數、百分比(如-0.1%)、百分比區間、空字串,或帶前導空格。單位可能寫在calendar_name裡。計算前請先去掉空格、處理%和空值,再轉為數字。
時間範圍按公佈時間篩選本接口按公佈時間
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 | 是 | 指標名稱,例如 5月批发销售(月率);名稱中可能帶有統計週期和單位,語言由 language 決定 |
data[].country_code | string | 是 | 數據源關聯的國家或地區代碼,例如 JPN、CAN、USA;不是統一的 ISO 代碼 |
data[].country_name | string | 是 | 國家或地區名稱,語言由 language 決定,例如 加拿大 或 Canada |
data[].data_effect | string | 是 | 數據對市場影響的文字說明,例如 影响较小、利多加元,英文為 Minor Impact 等 |
data[].forecast_value | string | 是 | 預測值,字串,保留數據源的原始寫法;沒有預測時為空字串 |
data[].revised_previous_value | string | 是 | 數據源的前值修正欄位,字串,保留數據源的原始寫法;多為空字串。不一定是修正後的前值,需要前值時請用 previous_value |
data[].previous_value | string | 是 | 前值:上一期的數值,字串,保留數據源的原始寫法 |
data[].publish_timestamp | integer(int64) | 是 | 公佈或舉行時間,毫秒時間戳(UTC);是否為準確時刻見 has_exact_publish_time |
data[].published_value | string | 是 | 公佈值(本期實際數值),字串,保留數據源的原始寫法 |
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。
應用場景
| 場景 | 說明 |
|---|---|
| 宏觀數據日曆 | 在看板中列出未來要公佈的經濟數據,按重要程度標記,提前做好準備。 |
| 數據公佈提醒 | 在重要數據公佈前推送提醒,交易者可提前調整倉位和槓桿。 |
| 預期差分析 | 比較公佈值與預測值、前值,判斷數據好於還是差於預期。 |
| 研究宏觀數據影響 | 把 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。
