Flying star (Xuan Kong) feng shui API

The bearing is resolved to one of the 24 mountains, which is the resolution the system actually works at: 15 degrees each, three per sector, and the polarity of the mountain decides the direction the stars fly. From the period number the endpoint places the period star into the centre and flies the remaining eight through the palaces in Luo Shu order. The sitting and facing mountains then give the mountain star and the facing star, each flown forward or backward according to the polarity of the mountain it starts on, which is the rule most implementations get subtly wrong. Every palace comes back with all three stars, their elements, whether each is timely or hostile in the period, and the pair reading that practitioners actually work from.

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 '{
    "facing": 180,
    "period": 8
  }'

{
  "ok": true,
  "data": {
    "period": { "number": 8, "source": "given" },
    "facing": { "degrees": 180, "mountain": "S2", "chinese": "午", "sector": "S", "polarity": "yin" },
    "sitting": { "mountain": "N2", "chinese": "子", "sector": "N", "degrees": 0 },
    "palaces": [
      {
        "palace": "N",
        "degrees": "337.5-22.5",
        "mountainStar": { "star": 9, "name": "Purple Fire", "element": "Fire", "nature": "auspicious" },
        "periodStar": { "star": 4, "name": "Green Wood", "element": "Wood", "nature": "mixed" },
        "facingStar": { "star": 7, "name": "Red Metal", "element": "Metal", "nature": "inauspicious" },
        "pair": "9-7"
      }
    ]
  }
}

Use it behind a consultation tool, a property listing feature, an interior-design workflow or an app that annotates a floor plan. The response is pure structure, so you can render it as a nine-square grid, overlay it on a plan, or feed it to an interpretation layer. Pair it with the annual stars endpoint when you need the current year laid over the natal chart of the building, and with the Kua number when the reading has to account for the occupant rather than the building alone.

The period is required rather than defaulted, deliberately: silently assuming the current period produces a confident chart for a building that does not exist. The flight direction follows the polarity of the starting mountain, and the tables are pinned against published almanac charts. Star names carry their Chinese characters alongside the English gloss.