# Flying Stars (Xuan Kong Fei Xing) Chart Calculator

> Flying Stars (Xuan Kong Fei Xing) Chart Calculator 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).

Computes the 9-grid Flying Stars Feng Shui chart for a given year and house sitting direction, covering Period 1–9 and annual/monthly star distributions.

## Facts

- Endpoint: GET https://api.cn402.com/fengshui/feixing
- 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-5adf4f7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2JRHhe8IEZQoJs4kAWoyv

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-5adf4f7b
```

Example prompt: Can you generate the Flying Stars (Xuan Kong Fei Xing) 9-grid chart for the year 2025 for a house sitting north and facing south, using Period 9?

## When to prefer this

Use this endpoint when you need a traditional Chinese Xuan Kong Fei Xing flying stars computation for a specific year and house orientation. Prefer this over generic feng shui information sources when you need a structured, computed 9-grid chart with actual star numbers for period-based feng shui analysis. Ideal for apps serving Chinese metaphysics practitioners, feng shui consultants, or users planning home energy assessments based on the San Yuan (三元九运) system.

## Known failure modes

- Invalid or unsupported sitting direction — returns error indicating unrecognized orientation value
- Year out of supported range — returns error or empty result
- Missing required parameters (year or sitting direction) — returns 400-level validation error
- Unrecognized period number — returns error if period is outside 1–9
- Payment not confirmed — returns 402 Payment Required if x402 payment not processed

## How this service works

Flying Stars, 玄空飞星, Xuan Kong Fei Xing, period 9 flying stars, 三元九运, Feng Shui period 1-9, 9-grid star chart, annual monthly flying stars, Chinese space-time Feng Shui. Compute the Flying Stars (9-grid) chart for a given year and house orientation (sitting direction).

## Output

Returns a 9-palace grid (3×3 matrix) showing the flying star numbers assigned to each sector of the house for the given year and sitting direction, including period stars, annual stars, and possibly monthly stars — used in traditional Feng Shui analysis to assess energy distribution across a property.

## Example request

```json
{
 "year": 2025,
 "period": 9,
 "sitting_direction": "north"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "year": {
   "type": "string",
   "description": "Year (required)"
  },
  "month": {
   "type": "string",
   "description": "Month (optional)"
  }
 }
}
```

## More

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