查询财经日历
1. 接口描述
| 项目 | 说明 |
|---|---|
| 接口名称 | 查询财经日历 |
| 外部接口 | GET /api/v1/market/data/finance/financial-calendar/baidu |
| 请求方式 | GET |
| 适用场景 | 按日期范围查询华尔街见闻与百度财经日历数据(宏观数据、IPO、财报时间、交易提醒等) |
2. 请求参数
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| start_date | string | 是 | 开始日期 | 2026-09-17 | 格式 YYYY-MM-DD |
| end_date | string | 是 | 结束日期 | 2026-09-18 | 格式 YYYY-MM-DD;起止跨度不得超过 3 天 |
3. 响应说明
响应为信封结构 code / message / data,data 包含两大来源:
3.1 华尔街见闻(wallstreetcn)
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
| stat_date | string | 否 | 统计日期 |
| tab_type | string | 否 | 标签类型 |
| event_time | string | 否 | 事件时间 |
| region | string | 否 | 地区 |
| event | string | 否 | 事件名称 |
| importance | string | 否 | 重要程度 |
| actual_value | string | 是 | 公布值 |
| forecast_value | string | 是 | 预测值 |
| previous_value | string | 是 | 前值 |
3.2 百度财经日历(baidu)
包含四类数据:
- economic(经济数据):region、time、title、former_val、market_value、pub_val、indicate_val、star、negative、positive
- ipo(IPO 数据):code、name、exchange、market、price、volume、amount、pe_ratio 等
- report_time(财报时间):code、name、exchange、market、report_type、market_time 等
- trade_reminder(交易提醒):code、name、exchange、market、meeting_type、reason、divi_cash、divi_date 等
json{ "code": 0, "message": "success", "data": { "wallstreetcn": { "items": [] }, "baidu": { "economic": { "items": [] }, "ipo": { "items": [] }, "report_time": { "items": [] }, "trade_reminder": { "items": [] } } } }
4. 用法
通过主目录 run.py 调用(必填 --start-date、--end-date):
bashpython <RUN_PY> financial-calendar --start-date 2026-09-17 --end-date 2026-09-18
<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径。
5. 注意事项
- 日期格式为
YYYY-MM-DD。 - 起止日期跨度不得超过 3 天,超出返回
code=400「时间范围不能超过3天」。 - 各
items列表可能为空数组,表示该日期范围内无对应事件。 - 百度侧 IPO、财报时间、交易提醒等条目中,类型字段 JSON 名为
type。 - 多日范围查询可能因响应过大导致服务端截断(服务端 HTTP/2 限制)。建议每次仅查询单日(
start_date与end_date相同),如需多日数据请逐日调用后合并。


