经济事件日历

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

按日期区间、市场与重要性星级查询经济事件日历。 支持 tab_type 切换经济数据（ECONOMIC_DATA，默认）、财经事件（ECONOMIC_EVENT）、休市（HOLIDAY）、精选（SELECTION）。 返回包含：事件类型、标题、发布时间戳与日期串、国家/地区、重要性星级（1~5）、前值（previous）、预测值（consensus）、实际公布值（actual）及详情链接； 顶层 pagination 含 total、completed、page_flag（回传 seq_mark 游标翻页）。 当天热门推荐请用 quote.economic_calendar_hot；按关键词搜索请用 quote.economic_calendar_search。

请求参数

参数	类型	位置	必填	说明
begin_date	string	查询	是	开始日期 YYYY-MM-DD（东八区日历日），例: 2026-10-01
end_date	string	查询	否	结束日期 YYYY-MM-DD（东八区日历日）；不传则仅查询 begin_date 当天
tab_type	string	查询	否	日历栏目类型：ECONOMIC_DATA=经济数据（默认）/ ECONOMIC_EVENT=财经事件 / HOLIDAY=休市 / SELECTION=精选
market	string	查询	否	按市场筛选，默认 ALL（不限市场）
star	int	查询	否	按重要性星级筛选：0=全部（默认），1~5=指定星级（常用 1=低 / 2=中 / 3=高）
only_focus	bool	查询	否	是否仅返回焦点数据，默认 false
page_size	int	查询	否	每页条数，默认 50，最大 100
page_flag	string	查询	否	翻页游标，首页留空；下一页回传上一页响应 pagination.page_flag；completed 为 true 时停止

请求示例

curl -X GET 'https://webapi.futunn.com/api/v1.0/quote/economic-calendar/list?begin_date=1&end_date=1&tab_type=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

响应参数

参数	类型	说明
data.items	object[]
data.items[].item_type	integer	条目类型：ECONOMIC_DATA / ECONOMIC_EVENT / HOLIDAY
data.items[].article_id	string	事件唯一标识
data.items[].title	string	事件标题
data.items[].timestamp	integer	事件发布时间（Unix 秒级时间戳）
data.items[].country	string	国家/地区名称
data.items[].star	integer	重要性星级（1~5）
data.items[].previous	string	前值
data.items[].consensus	string	预测值（一致预期）
data.items[].actual	string	实际公布值
data.items[].detail_url	string	详情链接
data.items[].is_focus	integer	是否为焦点事件
pagination.total	string	符合条件的总条数
pagination.completed	string	是否已到末页。只有 true 时停止翻页
pagination.page_flag	string	下一页游标

错误码

ret_code	error.code	说明
0	—	成功
-3	invalid_parameter	参数缺失或不在允许范围内
-7	invalid_symbol	标的不存在
-8	unsupported	市场或品类不支持
-9	permission_denied	没有对应权限
-10	no_data	没有可返回的数据
-11	rate_limited	调用过于频繁

响应示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "item_type": 0,
        "article_id": "example",
        "title": "example",
        "timestamp": 0,
        "country": "example",
        "star": 0
      }
    ]
  },
  "pagination": {
    "total": 1,
    "completed": true,
    "page_flag": ""
  }
}