经济日历搜索
GET/api/v1.0/quote/economic-calendar/search按关键词搜索经济日历数据,支持四种类型:经济数据(CPI/GDP/非农等宏观指标)、休市、经济事件(央行讲话/会议等)、权息(分红/拆股等)。返回匹配关键词的事件列表,支持分页和时间排序。
请求参数
| 参数 | 类型 | 位置 | 必填 | 默认 | 说明 |
|---|---|---|---|---|---|
keyword | string | query | 是 | — | 搜索关键词,如 CPI、美联储、GDP |
search_type | int | query | 是 | — | 搜索类型,取值见下方枚举表 |
limit | int | query | 否 | 20 | 每页条数,范围 1~30 |
next_key | string | query | 否 | "" | 翻页游标,首页留空;回传上一页 pagination.next_key 续翻 |
time_order_type | int | query | 否 | 0 | 排序类型:0=正序(ASC),1=倒序(DESC);仅 search_type=2/3 生效 |
search_type 枚举
| 取值 | 含义 | 典型关键词 |
|---|---|---|
| 1 | ECONOMIC_DATA — 宏观经济数据 | CPI、GDP、非农、利率、就业 |
| 2 | MARKET_CLOSE — 休市 | 圣诞、国庆、新年 |
| 3 | ECONOMIC_EVENT — 经济事件 | 美联储、央行、鲍威尔、议息 |
| 4 | RIGHT_INTEREST — 权息 | 腾讯、苹果、分红 |
请求示例
bash
curl -s "https://webapi.futunn.com/api/v1.0/quote/economic-calendar/search?search_type=3&limit=5&keyword=美联储" | 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 |
限制范围
| 维度 | 支持 | 说明 |
|---|---|---|
| search_type=1 经济数据 | 全球宏观经济指标(CPI/GDP/PMI/利率/就业等) | keyword 必传且非空 |
| search_type=2 休市 | 各市场休市日历 | 支持 time_order_type 排序 |
| search_type=3 经济事件 | 央行讲话、议息会议、政策发布等 | 支持 time_order_type 排序 |
| search_type=4 权息 | 分红/拆股/配股/送股等 | — |
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | — | 成功(含关键词无匹配的空列表) | 按 data 长度判断是否有数据 |
| -3 | invalid_parameter | 缺少 keyword 或 search_type / search_type 不在 1~4 / limit 越界 | 校正参数后重试 |
| -4 | internal_error | 服务错误 | 重试;持续失败请联系技术支持 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": [
{}
],
"pagination": {
"has_more": true,
"next_key": "5"
}
}