Feng Shui API
The Kua number and Eight Mansions, a building's gua, Xuan Kong flying star charts with an SVG grid, and each year's stars, Five Yellow, Tai Sui, Sui Po and San Sha. It says where the traditional stars fall and gives no cures.
| Operation | Credits | Key |
|---|---|---|
POST /v1/feng-shui/kuaA person's Kua number, East or West group and eight directions | 1 | secret |
POST /v1/feng-shui/houseA building's gua from its facing, its eight mansions, and how it fits an occupant's Kua | 1 | secret |
POST /v1/feng-shui/flying-starsA Xuan Kong flying star chart: base, mountain and water stars in all nine palaces, and its structure | 2 | secret |
POST /v1/feng-shui/flying-stars.svgThe flying star chart drawn as a nine-palace grid in SVG, south at the top | 2 | secret |
POST /v1/feng-shui/annualA year's flying stars, Five Yellow, Tai Sui, Sui Po and San Sha, with the twelve monthly charts | 1 | secret |
Example: A person's Kua number, East or West group and eight directions
POST /v1/feng-shui/kua · 200 OK
{
"data": {
"year": 1990,
"year_boundary": "li_chun",
"boundaries_agree": true,
"number": 8,
"gua": "gen",
"chinese": "艮",
"group": "west",
"home_direction": {
"id": "NE",
"name": "northeast"
},
"mansions": [
{
"id": "sheng_qi",
"chinese": "生气",
"name": "Life Generating",
"kind": "good",
"direction": {
"id": "SW",
"name": "southwest"
}
},
{
"id": "tian_yi",
"chinese": "天医",
"name": "Heavenly Doctor",
"kind": "good",
"direction": {
"id": "NW",
"name": "northwest"
}
},
{
"id": "yan_nian",
"chinese": "延年",
"name": "Longevity",
"kind": "good",
"direction": {
"id": "W",
"name": "west"
}
},
{
"id": "fu_wei",
"chinese": "伏位",
"name": "Stability",
"kind": "good",
"direction": {
"id": "NE",
"name": "northeast"
}
},
{
"id": "huo_hai",
"chinese": "祸害",
"name": "Mishap",
"kind": "bad",
"direction": {
"id": "S",
"name": "south"
}
},
{
"id": "wu_gui",
"chinese": "五鬼",
"name": "Five Ghosts",
"kind": "bad",
"direction": {
"id": "N",
"name": "north"
}
},
{
"id": "liu_sha",
"chinese": "六煞",
"name": "Six Killings",
"kind": "bad",
"direction": {
"id": "E",
"name": "east"
}
},
{
"id": "jue_ming",
"chinese": "绝命",
"name": "Life Ending",
"kind": "bad",
"direction": {
"id": "SE",
"name": "southeast"
}
}
]
},
"meta": {
"request_id": "req_example",
"api_version": "v1",
"engine_version": "2026.10.10",
"mode": "live",
"credits_charged": 1
},
"warnings": []
}