# Chinese Almanac Monthly Calendar (老黄历月历)

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

Returns a full month of Chinese almanac data, including daily 宜/忌 activities, 黄道/黑道 day quality, day clash, solar terms, and festivals for every day of the specified month.

## Facts

- Endpoint: GET https://api.cn402.com/almanac/month
- Price: $0.16/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-e55cdc6c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pDDF0cLjhXAKN-xkyPB27

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

Example prompt: Can you pull up the full Chinese almanac calendar for July 2025 — I want to see every day's 宜 and 忌 activities, day quality (黄道 or 黑道), day clash, and any solar terms or festivals for the whole month?

## When to prefer this

Use this endpoint when you need a full monthly overview of Chinese almanac data rather than a single day's information. Ideal for building calendar views, monthly planning interfaces, or bulk-scanning an entire month for auspicious days without making 30 individual daily calls.

## Known failure modes

- Invalid month or year returns an error
- Missing payment (x402) results in a 402 Payment Required response
- Out-of-range dates may return empty or partial data
- Network timeout if the upstream almanac data source is unavailable

## How this service works

Full-month Chinese almanac calendar / 老黄历月历 / 黄历月历 / monthly almanac / 每月宜忌 / lucky days this month. Returns every day of a given month with its 宜 (favorable) and 忌 (taboo) activities, 黄道/黑道 day quality, day clash, solar terms (jieqi) and festivals. For AI agents building Chinese calendar views, monthly planning, or scanning a month for auspicious days. Defaults to the current month.

## Output

A list of every day in the requested month, each with its lunar date, 宜 (favorable activities), 忌 (taboo activities), 黄道/黑道 day classification, day clash (冲), solar terms (节气) if applicable, and festivals. Defaults to the current month if no date is specified.

## Request schema (JSON Schema)

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

## More

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