文档日历查询 API
日历查询 API
农历、节气、节假日、交易日查询
概述
GET /v1/life/calendar 返回指定日期的农历、节气、节假日、是否交易日等信息。
什么时候用我
- 判断是否交易日（最常用场景）：在调用股票数据前先检查
is_trading_day，如果是非交易日可以提示用户"今天是周末/节假日，数据为上一交易日收盘价" - 农历查询：用户问"今天农历多少"、"明天是什么节气"
- 节假日规划：用户问"五一放几天假"、"国庆调休安排"
- 下一交易日：非交易日时返回
next_trading_day，方便提前预知开市时间 - 不传
date默认查今天：最简调用GET /v1/life/calendar
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
date | string | 否 | 今天 | 日期（YYYY-MM-DD） |
请求示例
curl -H "X-API-Key: sk_gapi_xxxxx" \
"https://api.groundapi.net/v1/life/calendar?date=2026-10-01"响应字段
| 字段 | 说明 |
|---|---|
date | 公历日期 |
weekday | 星期 |
lunar | 农历日期 |
is_holiday | 是否放假 |
is_workday | 是否工作日 |
is_adjusted_workday | 是否调休上班 |
holiday_name | 节假日名称（如"国庆节"） |
is_trading_day | 是否 A 股交易日 |
next_trading_day | 下一个交易日（非交易日时返回） |
solar_term | 最近的节气信息 |
计费
$0.01/次。每月前 500 次免费。
1 个月前更新