---
title: "Flying Star natal chart (Xuan Kong Fei Xing)"
method: POST
path: "/chinese/feng-shui/flying-star"
tags: ["Chinese: Zodiac & Feng Shui"]
---

# Flying Star natal chart (Xuan Kong Fei Xing)

`POST /chinese/feng-shui/flying-star`

The nine-palace natal chart of a building: mountain star, period star and facing star per sector, the named arrangement (旺山旺水 and the other three), and the special patterns. Send the facing in degrees or as one of the 24 mountains, and the period directly or as the date the building was occupied. Neither is defaulted.

## Request body

- ChineseFlyingStarInput
  - `facing` number
  - `facingMountain` string
  - `period` integer
  - `occupiedDate` string
  - `occupiedTime` string
  - `timezoneOffset` number, nullable — Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.
  - `year` integer

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `period` object, nullable
      - `number` number, nullable
      - `source` string, nullable
      - `startYear` object, nullable
      - `endYear` object, nullable
    - `facing` object, nullable
      - `degrees` number, nullable
      - `mountain` string, nullable
      - `chinese` string, nullable
      - `pinyin` string, nullable
      - `sector` string, nullable
      - `polarity` string, nullable
    - `sitting` object, nullable
      - `mountain` string, nullable
      - `sector` string, nullable
    - `palaces` object[], nullable
      - `palace` string, nullable
      - `sector` string, nullable
      - `degrees` string, nullable
      - `mountainStar` object, nullable
        - `star` number, nullable
        - `chinese` string, nullable
        - `name` string, nullable
        - `element` string, nullable
        - `nature` string, nullable
        - `meaning` string, nullable
      - `periodStar` object, nullable
        - `star` number, nullable
      - `facingStar` object, nullable
        - `star` number, nullable
      - `pair` string, nullable
    - `chartType` object, nullable
      - `id` string, nullable
      - `chinese` string, nullable
      - `meaning` string, nullable
    - `patterns` unknown[], nullable
      - unknown
    - `warnings` unknown[], nullable
      - unknown

## Other responses

- `400` — Validation error
- `401` — Missing or invalid API key

---

[API](https://skmtc.net/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.net/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astroway/astroway-calculation-api/revisions/529d7d36d7d6/schema)