Flying Star natal chart (Xuan Kong Fei Xing)

POST

/chinese/feng-shui/flying-star

request.sh

curl -X POST https://api.astroway.info/v1/chinese/feng-shui/flying-star \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "period": 8, "facing": 180, "year": 2026 }'

▸ Спробувати POST /chinese/feng-shui/flying-star

• Production

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.

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

fields

string

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

Example

planets.name,planets.longitude

precision

integer

<= 15

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Example

4

Request Body ^required

Media type application/json

object

facing

number

<= 360

facingMountain

string

>= 1 characters <= 8 characters

period

integer

>= 1 <= 9

occupiedDate

string

/^\d{4}-\d{2}-\d{2}$/

occupiedTime

string

/^\d{2}:\d{2}(:\d{2})?$/

timezoneOffset

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.

number

0 nullable >= -14 <= 14

year

integer

>= 1800 <= 2200

language

string

Example

{
  "period": 8,
  "facing": 180,
  "year": 2026
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

period

object

number

number

nullable

source

string

nullable

startYear

nullable

endYear

nullable

facing

object

degrees

number

nullable

mountain

string

nullable

chinese

string

nullable

pinyin

string

nullable

sector

string

nullable

polarity

string

nullable

sitting

object

mountain

string

nullable

chinese

string

nullable

pinyin

string

nullable

sector

string

nullable

degrees

number

nullable

palaces

Array<object>

nullable

object

palace

string

nullable

sector

string

nullable

degrees

string

nullable

mountainStar

object

star

number

nullable

chinese

string

nullable

name

string

nullable

element

string

nullable

nature

string

nullable

meaning

string

nullable

periodStar

object

star

number

nullable

chinese

string

nullable

name

string

nullable

element

string

nullable

nature

string

nullable

meaning

string

nullable

facingStar

object

star

number

nullable

chinese

string

nullable

name

string

nullable

element

string

nullable

nature

string

nullable

meaning

string

nullable

annualStar

object

star

number

nullable

chinese

string

nullable

name

string

nullable

element

string

nullable

nature

string

nullable

meaning

string

nullable

pair

string

nullable

chartType

object

id

string

nullable

chinese

string

nullable

meaning

string

nullable

patterns

Array

nullable

flight

object

mountain

object

centre

number

nullable

direction

string

nullable

facing

object

centre

number

nullable

direction

string

nullable

annualYear

number

nullable

warnings

Array

nullable

notes

Array<string>

nullable

Example

{
  "ok": true,
  "data": {
    "period": {
      "number": 8,
      "source": "given",
      "startYear": null,
      "endYear": null
    },
    "facing": {
      "degrees": 180,
      "mountain": "S2",
      "chinese": "午",
      "pinyin": "Wu",
      "sector": "S",
      "polarity": "yin"
    },
    "sitting": {
      "mountain": "N2",
      "chinese": "子",
      "pinyin": "Zi",
      "sector": "N",
      "degrees": 0
    },
    "palaces": [
      {
        "palace": "N",
        "sector": "N",
        "degrees": "337.5-22.5",
        "mountainStar": {
          "star": 9,
          "chinese": "九紫",
          "name": "Purple Fire",
          "element": "Fire",
          "nature": "auspicious",
          "meaning": "Future prosperity, celebration and multiplication. The ruling star of period 9."
        },
        "periodStar": {
          "star": 4,
          "chinese": "四綠",
          "name": "Green Wood",
          "element": "Wood",
          "nature": "mixed",
          "meaning": "Study, writing and romance. Read as scholarly when timely and as scandal when not."
        },
        "facingStar": {
          "star": 7,
          "chinese": "七赤",
          "name": "Red Metal",
          "element": "Metal",
          "nature": "inauspicious",
          "meaning": "Robbery, betrayal and cutting. Was timely in period 7 and is read as hostile now."
        },
        "annualStar": {
          "star": 6,
          "chinese": "六白",
          "name": "White Metal",
          "element": "Metal",
          "nature": "auspicious",
          "meaning": "Authority, patronage and heaven luck. The retiring star of period 6."
        },
        "pair": "9-7"
      }
    ],
    "chartType": {
      "id": "double-facing",
      "chinese": "雙星到向",
      "meaning": "Both stars gather in the facing palace: read as good for money, and as needing a mountain form at the back to support people."
    },
    "patterns": [],
    "flight": {
      "mountain": {
        "centre": 4,
        "direction": "forward"
      },
      "facing": {
        "centre": 3,
        "direction": "reverse"
      }
    },
    "annualYear": 2026,
    "warnings": [],
    "notes": [
      "The mountain star (山星) is read for people and health, the facing star (向星) for money and opportunity, and the period star (運星) for the era the building belongs to."
    ]
  }
}

400

Validation error

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Date must be YYYY-MM-DD",
    "details": [
      {
        "path": "date",
        "message": "Date must be YYYY-MM-DD"
      }
    ]
  }
}

401

Missing or invalid API key

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}