Economic Calendar Hot
GET/api/v1.0/quote/economic-calendar/hotGet 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
bash
curl -s "https://webapi.futunn.com/api/v1.0/quote/economic-calendar/hot?limit=5&date=20260618" | jqResponse Fields
data is an array of objects; an empty result is []. Returns data[], each element is an economic data event.
| Name | Type | Description |
|---|---|---|
data | object[] | |
data[].event_text | string | |
data[].previous | string | |
data[].predictive | string | |
data[].announce | string | |
data[].star | int | |
data[].event_time | int | |
data[].country | int | |
data[].currency | string | |
data[].unit | string | |
data[].unique_id | int | |
data[].detail_url | string | |
pagination | object | |
pagination.has_more | bool | |
pagination.next_key | string |
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 | Service error | Retry; contact support if persistent |
Response Example
json
{
"ret_code": 0,
"ret_msg": "success",
"data": [
{}
],
"pagination": {
"has_more": false,
"next_key": "-1"
}
}