# Chinese Daily Almanac Full Bundle (今日黄历 Full)

> Chinese Daily Almanac Full Bundle (今日黄历 Full) 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-15).

Returns a complete Chinese almanac bundle for today in a single call, including lunar date, gan-zhi, zodiac, yi/ji auspicious activities, day clash, lucky directions, 28 mansions, day officer, solar terms, and festivals.

## Facts

- Endpoint: GET https://api.cn402.com/today/full
- Price: $0.08/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-75ed4553
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sIWcrlqsF1Ue2ysrRnxxs

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-75ed4553
```

Example prompt: What does the full Chinese almanac say about today — give me the lunar date, gan-zhi, zodiac, yi and ji activities, day clash, lucky directions, 28 mansion, day officer, solar term, and any festivals all at once.

## When to prefer this

Prefer this endpoint when you need the complete Chinese almanac data for today in a single API call, rather than making multiple separate calls to /today, /lunar, /almanac, and /festival. Ideal for AI agents answering cultural, date-selection, or daily fortune queries that require a full traditional Chinese daily reading without assembling multiple responses.

## Known failure modes

- Network or server error returns a non-200 HTTP status
- Payment failure (x402) if USDC balance is insufficient — returns 402 Payment Required
- Malformed request body returns a 400 error
- Timezone ambiguity: 'today' may be computed server-side in China Standard Time (CST/UTC+8), which may differ from the caller's local date

## How this service works

Complete daily Chinese almanac in ONE call / 今日黄历 / 老黄历 / 黄历今日 / tongsheng today / Chinese lunar calendar today. Bundles lunar date + gan-zhi + zodiac + yi/ji auspicious activities + day clash + lucky directions + 28 mansions + day officer + solar terms (jieqi) + today's festivals. Replaces /today + /lunar + /almanac + /festival in a single request. For AI agents doing daily Chinese cultural, date-selection or fortune queries.

## Output

A comprehensive JSON bundle containing: today's lunar date (month, day, year), gan-zhi cycle notation, Chinese zodiac animal, lists of auspicious (宜) and inauspicious (忌) activities, the day clash (冲), lucky directions, the current 28-mansion (宿), day officer (建除神), active solar term (节气) if any, and today's Chinese cultural or traditional festivals — all in a single response.

## 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-75ed4553/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)