# 获取经济事件日历

get_economic_calendar(begin_date, end_date=None, market_list=None, importance=None, count=None, next_page=None)

  • 介绍

    获取经济事件日历,返回指定日期范围内的经济数据发布事件,包含事件标题、发布时间、国家、重要性星级、前值、预测值和实际公布值。支持按市场和重要性筛选,支持分页查询。

  • 参数

    参数 类型 说明
    begin_date str 开始日期,格式 "yyyy-MM-dd"(必填)
    end_date str 结束日期,格式 "yyyy-MM-dd";不传则仅查 begin_date 当天
    market_list list[Market] 市场筛选(多选,支持 HK/US/SH/SG/JP/AU/MY/CA),不传返回所有市场
    importance EconomicImportance 事件重要性筛选,默认 ALL(全部)
    count int 每页数量,默认 50,最大 100
    next_page str 翻页标记,首次不传,后续传上次返回的 next_page
  • 返回

    参数 类型 说明
    ret RET_CODE 接口调用结果
    data pd.DataFrame 当 ret == RET_OK,返回数据
    str 当 ret != RET_OK,返回错误描述
    • 数据格式如下:
      字段 类型 说明
      title str 事件标题(如"非农就业人数")
      timestamp float 发布时间戳(秒)
      country str 国家名称
      star str 重要性星级("LOW"/"MEDIUM"/"HIGH")
      previous str 前值(未返回时为 "--")
      consensus str 预测值(未返回时为 "--")
      actual str 实际公布值(未返回时为 "--")
  • Example

from futu import *

quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

ret, data, next_page, has_more = quote_ctx.get_economic_calendar(begin_date='2026-06-23', end_date='2026-06-24', count=2)
if ret == RET_OK:
    print(data)
else:
    print('error:', data)

quote_ctx.close()
1
2
3
4
5
6
7
8
9
10
11
  • Output
title     timestamp country    star previous consensus actual
0   日本6月综合PMI初值  1.782175e+09      日本  MEDIUM                          
1  日本6月制造业PMI初值  1.782175e+09      日本  MEDIUM
1
2
3

接口限制

  • 30 秒内最多 60 次请求
  • 分页请求仅首页计入限频统计