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

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

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"
  }
}