# Chinese Auspicious Hours Selector (黄道吉时)

> Chinese Auspicious Hours Selector (黄道吉时) 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 all 12 two-hour shichen periods for a given date, each rated with favorable/taboo activities and auspicious/inauspicious quality, with optional filtering for the best hours for a specific activity.

## Facts

- Endpoint: GET https://api.cn402.com/almanac/hours
- 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-92b6fc42
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cYWaEhGY36jjdSGTx-5lV

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-92b6fc42
```

Example prompt: What are the luckiest hours on June 14, 2025 for a wedding ceremony (嫁娶)? I want to know which shichen periods are 黄道 auspicious and specifically which ones list 嫁娶 as a 宜 favorable activity.

## When to prefer this

Use this endpoint when you need hour-level auspicious timing within a day, as a complement to /almanac/select which picks the lucky day. Ideal for wedding ceremony time selection, business opening hour, travel departure, or any event where traditional Chinese almanac hour quality matters. Prefer this over generic scheduling APIs when the user specifically asks about 黄道吉时, shichen, or Chinese auspicious hours.

## Known failure modes

- Invalid or missing date parameter returns an error
- Unrecognized activity type string returns no filtered results or an error
- Dates far outside supported range may return empty or error
- Malformed POST body causes 400 error
- Payment not included or insufficient returns 402 Payment Required

## How this service works

Chinese auspicious hour selection, 择时, 时辰吉凶, 黄道吉时, lucky hours, best time of day, 嫁娶吉时. Returns all 12 shichen (two-hour periods) of a date, each with its 宜 (favorable), 忌 (taboo) activities and 黄道/黑道 quality. Optional activity param returns the best hours for that activity. Pairs with /almanac/select: which day, then which hour. For AI agents handling event timing, wedding/ceremony hour selection.

## Output

A list of all 12 shichen (two-hour time blocks) for the requested date, each with its name, start/end time, 黄道 or 黑道 classification, list of 宜 (favorable) activities, and list of 忌 (taboo) activities. If an activity parameter is provided, the response highlights or filters to the best hours for that specific activity.

## Request schema (JSON Schema)

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

## More

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