# CN Data Chinese Holiday Calendar

> CN Data Chinese Holiday Calendar is a paid API for AI agents from cn-data-x402.cn-data-x402-worker.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-16).

Returns China's official public holiday schedule and today's holiday/workday status, including makeup workday dates and overtime pay rates.

## Facts

- Endpoint: GET https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/holiday?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cn-data-chinese-holiday-calendar-537938a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f2nYVzS2WK-pFYzkh0pga

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 cn-data-chinese-holiday-calendar-537938a6
```

Example prompt: Is today a public holiday in China, and if so what's the overtime pay rate I should apply? Also list all the official days off and any makeup workdays for this year.

## When to prefer this

Choose this endpoint when you need authoritative, machine-readable Chinese public holiday data without managing API keys or subscriptions. It is especially useful for payroll systems, scheduling tools, or HR platforms operating in China that need to determine overtime rates and rest-day status. Prefer it over scraping Chinese government websites, which publish only HTML, since this endpoint returns clean JSON. The per-call micropayment model via x402/USDC on Base makes it cost-effective for low-frequency lookups.

## Known failure modes

- HTTP 402 returned before payment is made — agent must pay listed USDC amount on Base and retry
- Invalid or missing year parameter may return data defaulting to current year
- Dates outside the published government schedule may return incomplete data
- Network timeout on the Cloudflare Worker edge node
- Stale data if the official Chinese government holiday announcement has not yet been ingested

## How this service works

Chinese market and China-focused public data over the x402 protocol. No API key and no signup: call any endpoint, receive HTTP 402 with payment terms, pay the listed amount in USDC on Base and retry. Every response is JSON. Some Chinese-language sources are published only as web pages — these endpoints return them as clean, machine-readable JSON.

## Output

A JSON object with two top-level keys: 'year' (containing the full year's holiday schedule with an array of days-off and makeup workdays, each with date and Chinese holiday name) and 'today' (containing the current date's classification including dayType, isHoliday, isRestDay, isMakeupWorkday, and the applicable overtime pay rate multiplier).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "year": {
    "year": "2026",
    "daysOff": [
     {
      "date": "2026-10-01",
      "name": "国庆节"
     }
    ],
    "makeupWorkdays": [
     {
      "date": "2026-10-10",
      "name": "国庆节后补班"
     }
    ]
   },
   "today": {
    "date": "2026-10-02",
    "name": "国庆节",
    "dayType": "holiday",
    "isHoliday": true,
    "isRestDay": true,
    "isMakeupWorkday": false,
    "overtimePayRate": 3
   }
  },
  "endpoint": "/cn/holiday"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cn-data-chinese-holiday-calendar-537938a6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cn-data-x402.cn-data-x402-worker.workers.dev](https://www.zero.xyz/host/cn-data-x402.cn-data-x402-worker.workers.dev/llms.txt)