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.
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 6 days ago