# Chinese Almanac (老黄历) Daily Calendar API

> Chinese Almanac (老黄历) Daily Calendar API is a paid API for AI agents from api.cn402.com, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-14).

Returns traditional Chinese almanac data for a given date, including auspicious/inauspicious activities, deity directions, lunar mansions, and 15+ classical calendar fields

## Facts

- Endpoint: GET https://api.cn402.com/almanac
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-cn402-com-c00fd2f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KC3fIHeHtlx3BeIriY84A

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-c00fd2f0
```

Example prompt: What does the Chinese almanac (老黄历) say for July 18, 2025? I need the auspicious and inauspicious activities, deity directions, lunar mansion, and all the traditional calendar fields for that day.

## When to prefer this

Use this endpoint when you need authoritative traditional Chinese almanac (老黄历) data for a specific date, especially for cultural event planning, wedding date selection, business launch timing, content localization for Chinese audiences, or any application that needs the full set of classical Chinese calendar fields. Prefer this over generic lunar calendar converters when you need auspicious/inauspicious activity lists, deity directions, lunar mansions, and the complete stem-branch cycle.

## Known failure modes

- Invalid date format returns an error — must use YYYY-MM-DD
- Missing date parameter defaults to today in Beijing time, which may not be intended
- Dates far outside supported range may return empty or error responses
- Payment failure (402) if USDC balance or x402 header is missing or insufficient
- Network timeout for slow connections

## How this service works

Chinese almanac (老黄历, Tong Sheng, 黄历) for daily date selection. Returns lunar date, ganzhi heavenly stems and earthly branches (天干地支), na yin (纳音), yi ji auspicious activities (宜忌), zodiac day clash, 28 lunar mansions (二十八宿), 12 day officers (建除十二神), pengzu taboos (彭祖百忌). For Chinese cultural queries, wedding date picking, business date picking, traditional astrology. Accepts payment on Base or Solana — either network works.

## Output

A structured response containing 15+ traditional Chinese almanac fields for the requested date, including: auspicious activities (宜), inauspicious activities (忌), lucky deity directions, lunar mansion (宿), day conflict (冲), solar term, ten-thousand-year calendar stem-branch cycle for year/month/day/hour, nine star (九星), twelve day officer (十二建), and other classical Chinese calendar metadata — all in Beijing time context.

## Request schema (JSON Schema)

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

## More

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