DocumentationCalendar API
Calendar API
Lunar date, solar terms, holidays, trading day status
Overview
GET /v1/life/calendar returns lunar date, solar terms, holiday status, and A-share trading day status for a given date.
When to Use
- Check if trading day (most common): Before pulling stock data, check
is_trading_day— if false, tell users "Today is a weekend/holiday, prices are from previous close" - Lunar date queries: "Today's lunar date?" or "Next solar term?"
- Holiday planning: "How many days off for May Day?" or "Adjusted workdays for National Day"
- Next trading day: Returns
next_trading_dayon non-trading days for forward planning - Defaults to today: simplest call is
GET /v1/life/calendar
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
date | string | No | Today | Date in YYYY-MM-DD format |
Request Example
curl -H "X-API-Key: sk_gapi_xxxxx" \
"https://api.groundapi.net/v1/life/calendar?date=2026-10-01"Response Fields
| Field | Description |
|---|---|
date | Solar date |
weekday | Day of week |
lunar | Lunar date |
is_holiday | Whether it's a holiday |
is_workday | Whether it's a workday |
is_adjusted_workday | Whether it's an adjusted workday (makeup day) |
holiday_name | Holiday name (e.g. "National Day") |
is_trading_day | Whether A-share market is open |
next_trading_day | Next trading day (when market is closed) |
solar_term | Nearest solar term info |
Pricing
$0.01/call. First 500 calls/month are free.
Updated 3 months ago