经济日历热门
GET/api/v1.0/quote/economic-calendar/hot获取指定日期的热门推荐经济数据列表(按重要性排序)。返回当天有公布的重大经济指标(如 CPI、GDP、非农就业、央行利率决议等),包含前值、预测值、公布值、星级重要度。
适用于:经济日历首页热门推荐、每日重大数据提醒、投资决策辅助。
请求参数
| 参数 | 类型 | 位置 | 必填 | 默认 | 说明 |
|---|---|---|---|---|---|
limit | int | query | 否 | 10 | 每页条数,范围 1~20 |
next_key | string | query | 否 | "" | 翻页游标,首页留空;回传上一页 pagination.next_key 续翻 |
date | string | query | 否 | (当天) | 查询日期,格式 yyyyMMdd,例 20260618 |
timezone | string | query | 否 | Asia/Shanghai | 时间对应时区,例 America/New_York |
请求示例
bash
curl -s "https://webapi.futunn.com/api/v1.0/quote/economic-calendar/hot?limit=5&date=20260618" | jq响应字段
data 为对象数组;无记录时返回 []。 返回 data[],每元素一条经济数据。
| 参数 | 类型 | 说明 |
|---|---|---|
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 |
限制范围
| 维度 | 支持 | 说明 |
|---|---|---|
| 数据范围 | 当天按热度排序的经济数据 | 仅含当天有发布计划的指标;非交易日或无重大数据日返回空列表 |
当查询日期无热门数据时(非交易日、无重大数据发布),返回 ret_code=0、data=[]、pagination.has_more=false。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | — | 成功(含无数据的空列表) | 按 data 长度判断是否有数据 |
| -3 | invalid_parameter | limit 不在 1~20 范围 | 校正参数后重试 |
| -4 | internal_error | 服务错误 | 重试;持续失败请联系技术支持 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": [
{}
],
"pagination": {
"has_more": false,
"next_key": "-1"
}
}