三、财务信息
3.18 节假日、经济日历、经济指标
GET
/api/holiday_listGET
/api/calendar_pageGET
/api/indicator_list各国节假日、经济数据公布日历、国家经济指标。
请求
请求头 Authorization：你的密钥（必填）。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| country | 必填 | 国家，如 america；全部取值见「国家与市场参数」 |
| page | 可选 | 只有 calendar_page 用：页码，默认 1，每页 100 条 |
说明
holiday_list节假日：holiday_date 是那一天 UTC 零点的 Unix 秒，name_en、name_zh 是名称。calendar_page经济日历，分页：event_time 公布时间（Unix 秒）、has_time 是否有具体时刻、importance 重要度（1 低 2 中 3 高）、actual 现值、previous 前值、revised 修正值、consensus 市场预期、forecast 预测；还没公布的为 null。外壳里page、total是当前页和总条数。indicator_list经济指标：latest 最新值、previous 前值、highest / lowest 历史最高最低、unit_en / unit_zh 单位、reference_period 数据所属期。
返回
统一外壳 {status, message, data, total, page, market, symbol, code, interval}，数据在 data 里。出错时 HTTP 状态码仍是 200，status 为 500，message 是原因。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | {"Cmd":"api","State":-1,"Msg":"没有订阅产品权限"} | 没带 country |
| 200 | status=500 page is invalid number! | calendar_page 的 page 不对 |
示例：holiday_list
GET
/holiday_list?country=america请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功，500 失败
"message": "SUCCESS", // 成功为 SUCCESS，失败时是原因
"data": [ // 数据
{
"country": "america", // 国家
"country_name": "美国", // 国家名称
"holiday_date": 1788739200, // 节假日那一天 UTC 零点的 Unix 秒
"name_en": "Labor Day", // 英文名称
"name_zh": "劳动节", // 中文名称
"updated_at": "2026-09-30 21:45:06" // 更新时间
},
{
"country": "america", // 国家
"country_name": "美国", // 国家名称
"holiday_date": 1791763200, // 节假日那一天 UTC 零点的 Unix 秒
"name_en": "Columbus Day", // 英文名称
"name_zh": "哥伦布日", // 中文名称
"updated_at": "2026-10-04 21:45:14" // 更新时间
}
],
"total": 0, // 总条数，分页的接口才有值
"page": 0, // 当前页，分页的接口才有值
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期，这类接口不用
}data 共 4 条，示例只列出前 2 条。
示例：calendar_page
GET
/calendar_page?country=america请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功，500 失败
"message": null, // 成功时为 null，失败时是原因
"data": [ // 每页 100 条
{
"country": "america", // 国家
"country_name": "美国", // 国家名称
"event_id": 421360, // 事件编号
"event_time": 1791206400, // 公布时间，Unix 秒
"has_time": 1, // 是否有具体时刻
"category": "calendar", // 类别
"name_en": "NY Fed Bill Purchases 4 to 12 months", // 英文名称
"name_zh": "纽约联邦储备银行票据购买（NY Fed）4至12个月", // 中文名称
"reference_period": null, // 数据所属期
"importance": 1, // 重要度：1 低 2 中 3 高
"actual": null, // 现值
"previous": null, // 前值
"revised": null, // 修正值
"consensus": "$1.946 billion", // 市场预期
"forecast": null, // 预测
"updated_at": "2026-10-05 10:10:06" // 更新时间
}
],
"total": 950, // 总条数
"page": 1, // 当前页
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期，这类接口不用
}data 共 100 条，示例只列出前 1 条。
示例：indicator_list
GET
/indicator_list?country=america请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功，500 失败
"message": "SUCCESS", // 成功为 SUCCESS，失败时是原因
"data": [ // 数据
{
"country": "america", // 国家
"country_name": "美国", // 国家名称
"slug": "average-equipment-rate", // 指标标识
"group_en": "Business", // 分组，英文
"group_zh": "商业", // 分组，中文
"name_en": "Average Equipment Rate", // 英文名称
"name_zh": "平均设备利用率", // 中文名称
"latest": "2.97", // 最新值
"previous": "2.63", // 前值
"highest": "3.25", // 历史最高
"lowest": "2.19", // 历史最低
"unit_en": "$/mile", // 单位，英文
"unit_zh": "$/mile", // 单位，中文
"reference_period": "2026-03", // 数据所属期
"updated_at": "2026-10-04 21:34:22" // 更新时间
},
{
"country": "america", // 国家
"country_name": "美国", // 国家名称
"slug": "bankruptcies", // 指标标识
"group_en": "Business", // 分组，英文
"group_zh": "商业", // 分组，中文
"name_en": "Bankruptcies", // 英文名称
"name_zh": "破产企业数量", // 中文名称
"latest": "26941", // 最新值
"previous": "25960", // 前值
"highest": "82446", // 历史最高
"lowest": "12748", // 历史最低
"unit_en": "Companies", // 单位，英文
"unit_zh": "公司", // 单位，中文
"reference_period": "2026-06", // 数据所属期
"updated_at": "2026-10-04 21:34:22" // 更新时间
}
],
"total": 0, // 总条数，分页的接口才有值
"page": 0, // 当前页，分页的接口才有值
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期，这类接口不用
}data 共 404 条，示例只列出前 2 条。