# China Calendar API: Holidays, Adjusted Workdays, Lunar Dates, Solar Terms

> China Calendar API: Holidays, Adjusted Workdays, Lunar Dates, Solar Terms is a paid API for AI agents from cn-holiday-x402.linholiday.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Returns official Chinese public holidays and 调休 (adjusted makeup workdays) for a given year, including holiday names in Chinese and English, date ranges, and compensatory workdays.

## Facts

- Endpoint: GET https://cn-holiday-x402.linholiday.workers.dev/holidays?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/china-calendar-api-holidays-adjusted-workdays-lunar-dates-solar-terms-47ae737f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nPgGqpeVM9K4MLbyh-Djx

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability china-calendar-api-holidays-adjusted-workdays-lunar-dates-solar-terms-47ae737f
```

Example prompt: Can you pull up all the official Chinese public holidays and 调休 makeup workdays for 2025, including each holiday's English name, start date, end date, and how many days long it is?

## When to prefer this

Choose this endpoint when you need authoritative, structured data on China's official holiday schedule — including both public holidays and 调休 compensatory workdays — for a specific year. It is especially useful for HR systems, payroll tools, cross-border logistics, and scheduling agents that must respect the Chinese government's official calendar, including adjusted Saturday work obligations that standard calendar libraries miss.

## Known failure modes

- Missing or invalid 'year' query parameter returns a validation error
- Requesting a year far outside supported range may return empty or partial data
- Payment failure via x402 protocol results in 402 Payment Required response
- Network timeout if Cloudflare Worker is cold-starting

## How this service works

Each paid call costs 0.01 USDC on eip155:8453 via x402 (exact scheme). Free: /health, /, /openapi.json, /llms.txt, /.well-known/x402.

## Output

Returns a JSON object with the requested year, an array of holiday objects (each with Chinese name, English name, start date, end date, and number of days), and a list of adjusted workday dates (调休 dates when employees must work to compensate for extended holiday weekends).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "year"
     ],
     "properties": {
      "year": {
       "type": "string",
       "description": "YYYY"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 2026,
  "holidays": [
   {
    "end": "2026-01-03",
    "days": 3,
    "name": "元旦",
    "start": "2026-01-01",
    "nameEn": "New Year's Day"
   }
  ],
  "adjustedWorkdays": [
   "2026-01-04"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/china-calendar-api-holidays-adjusted-workdays-lunar-dates-solar-terms-47ae737f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cn-holiday-x402.linholiday.workers.dev](https://www.zero.xyz/host/cn-holiday-x402.linholiday.workers.dev/llms.txt)