# Chinese Auspicious Date Selection (择日 / 黄道吉日)

> Chinese Auspicious Date Selection (择日 / 黄道吉日) 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).

Given an activity type and date range, returns auspicious days where the activity is favorable (宜) and not taboo (忌), including lunar date and day clash information.

## Facts

- Endpoint: GET https://api.cn402.com/almanac/select
- 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-0420acd1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5K9R46jdvw5To6Cltiw65

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-0420acd1
```

Example prompt: Can you find auspicious days for a wedding (嫁娶) between July 1 and July 31, 2025 using the Chinese almanac — I need days where marriage is in the 宜 list and not in 忌, with the lunar dates and any day clashes?

## When to prefer this

Use this endpoint when a user needs to select an auspicious date for a specific Chinese cultural activity (wedding, moving, business opening, ground-breaking, etc.) based on traditional Chinese almanac (黄历) rules, especially when they need the richer per-activity 宜/忌 filtering rather than just a general monthly calendar view.

## Known failure modes

- Invalid or unrecognized activity type returns an error or empty result
- Date range too wide may return no results or be truncated
- Dates in the past may be rejected or return empty
- Malformed date format causes a 400-level error
- Network or payment (x402) failure prevents response

## How this service works

Chinese auspicious date selection / 择日 / 黄道吉日 / 选吉日 / pick a lucky day / wedding date / 嫁娶吉日 / moving date / 开市吉日. Given an activity (嫁娶/开市/出行/动土/入宅/安床/祭祀/纳财...) and a date range, returns the auspicious days where that activity appears in 宜 (favorable) and not in 忌 (taboo), with day clash and lunar date. For AI agents handling wedding, moving, business-opening or event date-selection queries.

## Output

A list of auspicious days within the requested date range where the specified activity appears in 宜 (favorable) and not in 忌 (taboo), each entry including the Gregorian date, corresponding lunar date, and the day clash (冲) animal/stem-branch.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "string",
   "description": "Days (optional)"
  },
  "start": {
   "type": "string",
   "description": "Start (optional)"
  },
  "activity": {
   "type": "string",
   "description": "Activity (required)"
  }
 }
}
```

## More

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