# BaZi Yong Shen (Useful God / Favorable Element) Calculator

> BaZi Yong Shen (Useful God / Favorable Element) Calculator 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-13).

Determines the Yong Shen (Useful God / favorable element) for a BaZi chart, identifying the element that brings life balance and guides lucky directions, colors, and life choices.

## Facts

- Endpoint: GET https://api.cn402.com/bazi/yongshen
- Price: $0.16/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-a50ffeec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sj-eHpC6dU3AZnzChVq1t

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

Example prompt: What's my Yong Shen — my favorable BaZi element — for someone born on March 15, 1990 at 7:30 AM? I want to know which element to enhance and what lucky colors and directions it points to.

## When to prefer this

Use this endpoint when you need to determine the core favorable element (Yong Shen) from a BaZi chart for life balance recommendations, lucky element identification, feng shui color/direction guidance, or any Chinese metaphysical application requiring the foundational remedy element. Prefer this over generic horoscope or Western astrology APIs when working within the BaZi / Four Pillars of Destiny framework.

## Known failure modes

- Invalid or missing birth date/time returns an error response
- Ambiguous or out-of-range birth hour causes computation failure
- Unsupported date formats result in parsing errors
- Edge cases near midnight or time-zone boundaries may yield incorrect pillar assignment
- Missing required fields (year, month, day, hour) return 400-level errors

## How this service works

Useful God, 用神, Yong Shen, BaZi favorable element, what element to enhance for life balance, Chinese astrology core remedy, lucky element for life. Determine the Useful God (favorable element) for a BaZi chart, which guides lucky directions, colors, and life choices.

## Output

Returns the Yong Shen (Useful God / favorable element) derived from the BaZi chart, indicating which of the five elements (Wood, Fire, Earth, Metal, Water) is most beneficial for the person, along with associated lucky directions, colors, and life guidance based on Chinese metaphysical principles.

## Request schema (JSON Schema)

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

## More

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