經濟日曆熱門

GET /api/v1.0/quote/economic-calendar/hot

獲取指定日期的熱門推薦經濟數據列表（按重要性排序）。返回當天有公佈的重大經濟指標（如 CPI、GDP、非農就業、央行利率決議等），包含前值、預測值、公佈值、星級重要度。

適用於：經濟日曆首頁熱門推薦、每日重大數據提醒、投資決策輔助。

請求參數

參數	類型	位置	必填	默認	說明
`limit`	int	query	否	10	每頁條數，範圍 `1~20`
`next_key`	string	query	否	""	翻頁游標，首頁留空；回傳上一頁 `pagination.next_key` 續翻
`date`	string	query	否	(當天)	查詢日期，格式 `yyyyMMdd`，例 `20260618`
`timezone`	string	query	否	Asia/Shanghai	時間對應時區，例 `America/New_York`

請求示例

bash

curl -s "https://webapi.moomoo.com/api/v1.0/quote/economic-calendar/hot?limit=5&date=20260618" | jq

響應字段

返回 data[]，每元素一條經濟數據。

字段	類型	說明
`event_text`	string	事件內容，例 `美國至6月17日美聯儲利率決定(上限)`
`previous`	string	前值，例 `3.75`
`predictive`	string	預測值（共識預期），例 `3.75`
`announce`	string	公佈值（實際值），尚未公佈時為空串
`star`	int	重要性星級，1~5（5 = 最重要，如央行利率決議）
`event_time`	int64	事件發佈時間，秒級時間戳
`country`	string	地區/國家，例 `美國`、`日本`
`currency`	string	幣種；可能為 null
`unit`	string	單位，例 `%`、`萬人`；可能為 null
`unique_id`	string	唯一鍵，例 `calendar_economic:103384299`；可能為 null
`detail_url`	string	詳情跳轉鏈接

限制範圍

維度	支持	說明
數據範圍	當天按熱度排序的經濟數據	僅含當天有發佈計劃的指標；非交易日或無重大數據日返回空列表

當查詢日期無熱門數據時（非交易日、無重大數據發佈），返回 ret_code=0、data=[]、pagination.has_more=false。

錯誤碼

ret_code	error.code	觸發條件	處理建議
0	—	成功（含無數據的空列表）	按 `data` 長度判斷是否有數據
-3	invalid_parameter	`limit` 不在 1~20 範圍	校正參數後重試
-4	internal_error	後端返回業務錯誤	重試；持續失敗請聯繫網關側

響應示例

json

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": [
    {
      "announce": "3.75%",
      "country": "美國",
      "currency": "美國",
      "detail_url": "https://news.moomoo.com/new-calendar/detail?show_bottom_bar=1&indicatorId=168",
      "event_text": "美國至6月17日美聯儲利率決定(上限)",
      "event_time": 1781719200,
      "predictive": "3.75%",
      "previous": "3.75%",
      "star": 5,
      "unique_id": "calendar_economic:103384299",
      "unit": "%"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_key": "-1"
  }
}

經濟日曆熱門 ​

請求參數 ​

請求示例 ​

響應字段 ​

限制範圍 ​

錯誤碼 ​