# Get Economic Calendar

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

  • Description

    Get economic event calendar, returning economic data release events within a specified date range, including event title, release time, country, importance star rating, previous value, forecast value, and actual published value. Supports filtering by market and importance, and supports pagination.

  • Parameters

    Parameter Type Description
    begin_date str Start date, format "yyyy-MM-dd" (required)
    end_date str End date, format "yyyy-MM-dd"; if not provided, only queries begin_date
    market_list list[Market] Market filter (multi-select, supports HK/US/SH/SG/JP/AU/MY/CA), if not provided returns all markets
    importance EconomicImportance Event importance filter, default ALL
    count int Per page count, default 50, max 100
    next_page str Page marker, do not provide for first request, pass the next_page from previous response afterwards
  • Return

    Parameter Type Description
    ret RET_CODE API call result
    data pd.DataFrame When ret == RET_OK, returns data
    str When ret != RET_OK, returns error description
    • Data format:
      Field Type Description
      title str Event title (e.g. "Non-Farm Payrolls")
      timestamp float Release timestamp (seconds)
      country str Country name
      star str Importance star rating ("LOW"/"MEDIUM"/"HIGH")
      previous str Previous value ("--" if not available)
      consensus str Forecast value ("--" if not available)
      actual str Actual published value ("--" if not available)
  • 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

API Limits

  • Maximum 60 requests within 30 seconds
  • Only the first page of paginated requests counts toward rate limiting