# Chinese Age Calculator (Xu Sui / Nominal Age)

> Chinese Age Calculator (Xu Sui / Nominal Age) is a paid API for AI agents from api.cn402.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-13).

Computes Chinese nominal age (xu sui), Western actual age, days lived, and lunar birthday from a given birth date

## Facts

- Endpoint: GET https://api.cn402.com/age/calc
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-cn402-com-575d0a40
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SHBi67vhGC6GZNaptV6Zf

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-575d0a40
```

Example prompt: What is my Chinese nominal age (xu sui) and lunar birthday? I was born on March 15, 1990.

## When to prefer this

Use this endpoint when you need to compute Chinese nominal age (xu sui) alongside Western age and lunar birthday from a single birth date — particularly for apps serving Chinese-speaking users, cultural events, BaZi astrology workflows, or any context where traditional Chinese age reckoning matters

## Known failure modes

- Invalid or missing birth date returns an error
- Future birth dates may produce unexpected results
- Malformed date format (non-ISO) may be rejected
- Very old or unusual dates may have limited lunar calendar support

## How this service works

Chinese age calculator, nominal age, xu sui, 虚岁, Chinese traditional age system, Asian age, lunar birthday, Chinese age vs Western age, how old in Chinese culture. Compute Chinese nominal age (xu sui), Western actual age, days lived, and lunar birthday from any birth date.

## Output

Returns a JSON object with the input birth date, reference date (on), Western age as an integer, Chinese nominal age (xu sui) as an integer, number of days lived, and the lunar birthday date string

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "on": {
   "type": "string",
   "description": "On (optional)"
  },
  "birth": {
   "type": "string",
   "description": "Birth (optional)"
  }
 }
}
```

## More

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