# Chinese Festival Today Lookup

> Chinese Festival Today Lookup is a paid API for AI agents from api.cn402.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Returns the traditional Chinese festival(s) observed on a given date (or today), if any exist for that date.

## Facts

- Endpoint: GET https://api.cn402.com/festival/today
- Price: $0.008/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-632e9720
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FN7igJmcuEmmlxeD7jPMD

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-632e9720
```

Example prompt: Is today a traditional Chinese festival? I want to know if there's any Chinese holiday or cultural celebration happening today, like Spring Festival, Mid-Autumn Festival, Dragon Boat Festival, or Qingming.

## When to prefer this

Use this endpoint when you need to know whether a specific date coincides with a traditional Chinese festival or holiday — ideal for content scheduling, cultural event awareness, greeting card timing, or holiday-aware automation for Chinese audiences.

## Known failure modes

- Invalid or malformed date input returns an error
- Date outside supported year range may return empty or error
- No festival on the given date returns an empty list (not an error)
- Network or payment failure returns 402 or 5xx

## How this service works

Today Chinese festival lookup (今日节日). Returns current Chinese holidays, traditional festivals, lunar observances on a given date (defaults to today). Detects Spring Festival, Mid Autumn, Dragon Boat, Qingming, and many other Chinese cultural festivals. Empty list when no festival. For AI agents handling Chinese cultural queries.

## Output

A list of Chinese festival names (e.g. 春节 / Spring Festival, 中秋节 / Mid-Autumn Festival) observed on the queried date, or an empty list if no festival falls on that date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "string",
   "description": "Date YYYY-MM-DD (optional)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-cn402-com-632e9720/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)