经济日历热门

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"
  }
}

经济日历热门 ​

请求参数 ​

请求示例 ​

响应字段 ​

限制范围 ​

错误码 ​