Economic Calendar Hot

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

Get a list of hot/recommended economic data for a specific date (sorted by importance). Returns major economic indicators scheduled for that day (e.g. CPI, GDP, non-farm payrolls, central bank rate decisions), including previous value, forecast, actual value, and importance star rating.

Use cases: economic calendar homepage recommendations, daily key data alerts, investment decision support.

Parameters

Name	Type	In	Required	Default	Description
limit	int	query	no	10	Items per page, range 1~20
next_key	string	query	no	""	Pagination cursor; leave empty for first page, pass previous pagination.next_key to continue
date	string	query	no	(today)	Query date, format yyyyMMdd, e.g. 20260618
timezone	string	query	no	Asia/Shanghai	Timezone for the date, e.g. America/New_York

Request Example

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

Response Fields

Returns data[], each element is an economic data event.

Field	Type	Description
event_text	string	Event description, e.g. US Fed Interest Rate Decision (Upper Bound) Jun 17
previous	string	Previous value, e.g. 3.75
predictive	string	Forecast value (consensus), e.g. 3.75
announce	string	Actual value; empty string if not yet released
star	int	Importance star rating, 1~5 (5 = most important, e.g. central bank rate decision)
event_time	int64	Event release time, seconds timestamp
country	string	Region/country, e.g. US, Japan
currency	string	Currency; may be null
unit	string	Unit, e.g. %, K; may be null
unique_id	string	Unique key, e.g. calendar_economic:103384299; may be null
detail_url	string	Detail redirect link

Supported Range

Dimension	Supported	Notes
Data range	Hot economic data for the day sorted by importance	Only includes indicators with release schedules for that day; non-trading days or days without major data return an empty list

When the queried date has no hot data (non-trading day, no major data release), returns ret_code=0, data=[], pagination.has_more=false.

Error Codes

ret_code	error.code	Trigger Condition	Recommended Action
0	—	Success (includes empty list when no data)	Check data length to determine if data exists
-3	invalid_parameter	limit out of 1~20 range	Fix parameter and retry
-4	internal_error	Backend returned business error	Retry; contact gateway team if persistent

Response Example

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": [
    {
      "announce": "3.75%",
      "country": "US",
      "currency": "US",
      "detail_url": "https://news.moomoo.com/new-calendar/detail?show_bottom_bar=1&indicatorId=168",
      "event_text": "US Fed Interest Rate Decision (Upper Bound) Jun 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"
  }
}