Skip to content

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 ​

NameTypeInRequiredDefaultDescription
limitintqueryno10Items per page, range 1~20
next_keystringqueryno""Pagination cursor; leave empty for first page, pass previous pagination.next_key to continue
datestringqueryno(today)Query date, format yyyyMMdd, e.g. 20260618
timezonestringquerynoAsia/ShanghaiTimezone for the date, e.g. America/New_York

Request Example ​

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

Response Fields ​

data is an array of objects; an empty result is []. Returns data[], each element is an economic data event.

NameTypeDescription
dataobject[]
data[].event_textstring
data[].previousstring
data[].predictivestring
data[].announcestring
data[].starint
data[].event_timeint
data[].countryint
data[].currencystring
data[].unitstring
data[].unique_idint
data[].detail_urlstring
paginationobject
pagination.has_morebool
pagination.next_keystring

Supported Range ​

DimensionSupportedNotes
Data rangeHot economic data for the day sorted by importanceOnly 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_codeerror.codeTrigger ConditionRecommended Action
0—Success (includes empty list when no data)Check data length to determine if data exists
-3invalid_parameterlimit out of 1~20 rangeFix parameter and retry
-4internal_errorService errorRetry; contact support if persistent

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": [
    {}
  ],
  "pagination": {
    "has_more": false,
    "next_key": "-1"
  }
}