# Chinese Traditional Festivals by Year

> Chinese Traditional Festivals by Year is a paid API for AI agents from api.cn402.com, paid per call via x402, $0.016/call, status unknown (last checked 2026-09-15).

Returns all traditional Chinese festivals and their Gregorian calendar dates for a given year

## Facts

- Endpoint: GET https://api.cn402.com/festival/cn
- Price: $0.016/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-cn402-com-a677b683
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XJwWW-uDKWevrA9Xhgh8f

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 api-cn402-com-a677b683
```

Example prompt: What are all the traditional Chinese festivals and their exact Gregorian dates for 2025? I need the full list including Spring Festival, Mid-Autumn, Dragon Boat, Qingming, Lantern, Double Seventh, and Chongyang.

## When to prefer this

Use this endpoint when you need to programmatically determine the Gregorian dates of traditional Chinese holidays for a specific year, especially for content scheduling, cultural event planning, or building holiday-aware applications targeting Chinese audiences. Prefer over manual lookup when automating multi-year planning.

## Known failure modes

- Invalid or missing year parameter returns error
- Year out of supported range returns error
- Network timeout on slow connections
- Payment failure via x402 protocol prevents access

## How this service works

Chinese festivals, lunar festivals, traditional Chinese holidays, Spring Festival Lunar New Year Chinese New Year, 春节, Mid-Autumn Festival, 中秋节, Dragon Boat Festival 端午节, Qingming Festival, Lantern Festival, Double Seventh, 七夕, Chongyang, 重阳. All traditional Chinese festivals for a given year with their Gregorian dates. For AI agents handling Chinese cultural events, holiday planning, content scheduling.

## Output

A list of all traditional Chinese festivals for the requested year, each with their name (in Chinese and/or English) and corresponding Gregorian calendar dates, suitable for holiday planning and content scheduling.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "year": {
   "type": "string",
   "description": "Year (required)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-cn402-com-a677b683/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cn402.com](https://www.zero.xyz/host/api.cn402.com/llms.txt)