

Flying star charts and Kua numbers that are actually checkable.
Kua Number · Eight Mansions · Flying Star · Annual Flying Stars · Annual Afflictions · Monthly Flying Stars · Bagua Map · Feng Shui Period
Included with every plan (at no extra cost)
Xuan Kong natal chart by period and facing
Period, mountain and water stars per palace
Named formation and reading for every palace
Facing by mountain or by compass bearing
Kua number with its east or west life group
Raw Kua published beside the reassigned one
Eight Mansions from Sheng Chi to Jue Ming
Sectors ranked best to worst for placement
Annual star plate for any solar year
Monthly plate turning at each major solar term
Enhancing and draining element per star
Exact Li Chun changeover date
Tai Sui and Sui Po by mountain
Three Killings split into its named mountains
Five Yellow from the annual plate
Degree spans, not just sector names
Compass Bagua aligned to true directions
Later Heaven and Earlier Heaven trigrams
Life area, element and colours per sector
Lookup by life area such as wealth or love
San Yuan period table with ruling stars
The period in force on any date
Exact Li Chun date each period opened
Flying star catalogue with remedy elements
Compute classical feng shui from one API: Xuan Kong flying star natal charts for any of the nine periods and 24 mountains, Kua numbers and the full Eight Mansions map of favourable and unfavourable directions, annual and monthly star plates, the four annual afflictions with exact degree spans, the compass Bagua map and the 1864 to 2043 period table. Chinese years resolve at Li Chun, computed astronomically, so the boundary is right rather than assumed. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.
Every Feng Shui calculation is covered by 13,957 automated tests per deploy, 3,683 of them gold-standard tests locked to the named references on our methodology page. See how we test.
Interpretations in Deutsch, English, Español, Français, हिन्दी, Português, Русский, 简体中文, 繁體中文, Türkçe, one query parameter away.
Paste a widget into any site builder, install the WordPress plugin, or start from an MIT template you can white-label. Results render from the Feng Shui API with no backend.
A Remote MCP server exposes every endpoint as a tool for Claude, ChatGPT, Cursor and any MCP client, with no local install. Opt-in compact responses cut the tokens your agent reads by roughly 40 to 52 percent, and one call stays one request.
Typed SDKs for TypeScript, Python, PHP, C#, Go, and Rust, generated from the live spec, each with an AGENTS.md so your coding assistant calls the Feng Shui API correctly.
This is what your visitors see. Paste one snippet into Wix, Squarespace, or WordPress and the Feng Shui API reading appears on your site, with no code and no backend. Developers install the same components from npm for Next.js, React, Vue, Svelte, Angular, or plain HTML. MIT licensed and included in every plan.
| Element | Renders |
|---|---|
<roxy-flying-star-chart> | Nine-palace flying star plate with the mountain, period and water star per palace, the facing and sitting mountains and the structure |
<roxy-kua-card> | Kua number and trigram over the eight-sector direction map, favourable and unfavourable sectors ranked |
The depth behind every line above, written out in full.
Want to try without writing code? Try this domain live in API playground →
npm install @roxyapi/sdkimport { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const domain = roxy.fengShuipip install roxy-sdkfrom roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
domain = roxy.feng_shuicomposer require roxyapi/sdkuse function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$domain = $roxy->fengShui;dotnet add package RoxyApi.Sdkusing RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var domain = roxy.FengShui;go get github.com/RoxyAPI/sdk-goimport roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
domain := roxy.FengShuicargo add roxyapiuse roxyapi::Roxy;
let roxy = Roxy::new(std::env::var("ROXY_API_KEY")?)?;
let domain = roxy.feng_shui();claude mcp add --transport http \
roxy-feng-shui https://roxyapi.com/mcp/feng-shui \
--header "X-API-Key: YOUR_KEY"AI agents auto-discover all endpoints as callable tools. Zero configuration. Responses can come back token-optimized and lossless, cutting the tokens your agent spends per call by roughly 40 to 52 percent.
Full MCP setup guidecurl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/feng-shui/Generating your own client? Get the Feng Shui OpenAPI schema.
Want to ship faster? Clone a free template and white-label it as your own app.
Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app.
Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.
{
"period": 9,
"facing": {
"id": "wu",
"chinese": "午",
"pinyin": "Wǔ",
"label": "S2",
"direction": "South",
"yuan": "heaven",
"polarity": "yin",
"startDegree": 172.5,
"endDegree": 187.5
},
"sitting": {
"id": "zi",
"chinese": "子",
"pinyin": "Zǐ",
"label": "N2",
"direction": "North",
"yuan": "heaven",
"polarity": "yin",
"startDegree": 352.5,
"endDegree": 7.5
},
"facingDegrees": 180,
"straddling": false,
"mountainCenterStar": 5,
"waterCenterStar": 4,
"mountainFlight": "reverse",
"waterFlight": "forward",
"structure": {
"id": "double-sitting",
"name": "Double Star at Sitting",
"chinese": "雙星到坐",
"meaning": "Both prosperous stars gather at the back of the building. Good for health, for family and for anyone who works from home, weaker for income arriving from outside. The standard correction is water or open movement at the back, which gives the water star somewhere to work."
},
"palaces": [
{
"palace": "Center",
"base": 5,
"period": 9,
"mountain": 5,
"water": 4,
"reading": "The Five Yellow mountain star sits with the Four Green water star in this palace. The water star controls the mountain star here, Wood acting on Earth, so the money side dominates and gains in this sector tend to come at the expense of health or of the people in it. Read the mountain star for health, for the people in the room and for the relationships between them, and the water star for money, opportunity and whatever arrives from outside."
},
{
"palace": "Northwest",
"base": 6,
"period": 1,
"mountain": 4,
"water": 5,
"reading": "The Four Green mountain star sits with the Five Yellow water star in this palace. The mountain star controls the water star here, Wood acting on Earth, so the people side dominates: relationships hold, and income through this sector is held back rather than released. Read the mountain star for health, for the people in the room and for the relationships between them, and the water star for money, opportunity and whatever arrives from outside."
},
{
"palace": "West",
"base": 7,
"period": 2,
"mountain": 3,
"water": 6,
"reading": "The Three Jade mountain star sits with the Six White water star in this palace. The water star controls the mountain star here, Metal acting on Wood, so the money side dominates and gains in this sector tend to come at the expense of health or of the people in it. Read the mountain star for health, for the people in the room and for the relationships between them, and the water star for money, opportunity and whatever arrives from outside."
},
{
"palace": "Northeast",
"base": 8,
"period": 3,
"mountain": 2,
"water": 7,
"reading": "The Two Black mountain star sits with the Seven Red water star in this palace. The mountain star produces the water star here, Earth feeding Metal, so the people side of the palace pours into the money side and the sector rewards effort spent on the household before effort spent on income. Read the mountain star for health, for the people in the room and for the relationships between them, and the water star for money, opportunity and whatever arrives from outside."
},
{
"palace": "South",
"base": 9,
"period": 4,
"mountain": 1,
"water": 8,
"reading": "The One White mountain star sits with the Eight White water star in this palace. The water star controls the mountain star here, Earth acting on Water, so the money side dominates and gains in this sector tend to come at the expense of health or of the people in it. Read the mountain star for health, for the people in the room and for the relationships between them, and the water star for money, opportunity and whatever arrives from outside."
},
{
"palace": "North",
"base": 1,
"period": 5,
"mountain": 9,
"water": 9,
"reading": "The Nine Purple mountain star sits with the Nine Purple water star in this palace. Both stars carry the Fire phase, so they reinforce each other instead of moderating each other, and whatever this palace does it does emphatically. Read the mountain star for health, for the people in the room and for the relationships between them, and the water star for money, opportunity and whatever arrives from outside."
},
{
"palace": "Southwest",
"base": 2,
"period": 6,
"mountain": 8,
"water": 1,
"reading": "The Eight White mountain star sits with the One White water star in this palace. The mountain star controls the water star here, Earth acting on Water, so the people side dominates: relationships hold, and income through this sector is held back rather than released. Read the mountain star for health, for the people in the room and for the relationships between them, and the water star for money, opportunity and whatever arrives from outside."
},
{
"palace": "East",
"base": 3,
"period": 7,
"mountain": 7,
"water": 2,
"reading": "The Seven Red mountain star sits with the Two Black water star in this palace. The water star produces the mountain star here, Earth feeding Metal, so money and opportunity support health and relationships, and the sector is usually easier to live in than to profit from. Read the mountain star for health, for the people in the room and for the relationships between them, and the water star for money, opportunity and whatever arrives from outside."
},
{
"palace": "Southeast",
"base": 4,
"period": 8,
"mountain": 6,
"water": 3,
"reading": "The Six White mountain star sits with the Three Jade water star in this palace. The mountain star controls the water star here, Metal acting on Wood, so the people side dominates: relationships hold, and income through this sector is held back rather than released. Read the mountain star for health, for the people in the room and for the relationships between them, and the water star for money, opportunity and whatever arrives from outside."
}
]
}Structured JSON with documented fields. Not hallucinated text. See all endpoints
Clone. Edit. Ship. Free and open source by Team Roxy.

Independent proof, domain by domain. Every reference value cited, rerun monthly.
Browse all template or use AI prompts to generate a custom app.
The products teams ship on the Feng Shui API.
Real calls against the production API, no account needed. Every endpoint sits in the public OpenAPI spec and is callable as an MCP tool; open one for its parameters and response examples.
Calculate the Kua number, also called the Ming Gua or life gua, from a birth date and sex. Returns the number, the east or west life group, the personal trigram, and all eight compass sectors classified from best to worst. The Chinese year is resolved at Li Chun by default, so an early February birthday is placed in the correct year rather than the calendar one, and the boundary that decided it is echoed back. Built for room and desk placement features, personalised feng shui reports, and any product that needs a favourable direction per person.
Look up the reference chart for one Kua number: its trigram, its east or west life group, and how it classifies all eight compass sectors. A pure reference endpoint with no birth data required, for building a lookup table or a picker. Number 5 is served for completeness and is never a computed result, because it belongs to the centre and has no direction of its own: a man whose formula gives 5 reads Kua 2 and a woman reads Kua 8, and the chart returned for 5 is therefore the Kua 2 chart.
Build the full Eight Mansions (Ba Zhai) map for a person: all eight compass sectors classified into the four favourable stars, Sheng Chi, Tian Yi, Yan Nian and Fu Wei, and the four unfavourable ones, Huo Hai, Wu Gui, Liu Sha and Jue Ming. Sectors come back ordered best to worst with a composed reading each, plus the ranking that decides which affliction to accept when no favourable sector is reachable. Accepts a Kua number directly or derives one from a birth date and sex. Built for bed and desk placement tools, room-by-room reports and floor plan overlays.
Cast the Xuan Kong flying star natal chart for a building from its construction period and the direction it faces. Returns all nine palaces with the period star, the mountain star that governs health and relationships and the water star that governs wealth, plus the named formation and a composed reading for every palace, and the classical verdict on how the two prosperous stars landed. Facing is accepted as one of the 24 mountains or as a compass bearing. Built for property analysis tools, floor plan overlays and consultation software.
Return the annual flying star plate for a solar year: which of the nine stars occupies each of the nine palaces, what it means there, and which element strengthens or drains it. The annual plate is universal and does not depend on any building, so it is the layer every yearly feng shui guide is built on. The changeover is Li Chun in early February rather than Lunar New Year, and the exact date is returned so a caller can apply the plate on the right day.
Return the monthly flying star plate, the faster overlay that sits on top of the annual one. Months here are SOLAR months: month 1 begins at Li Chun in early February and each month begins at the next of the twelve major solar terms, so they never line up with calendar months. Omit both parameters to get the month in progress. Built for monthly guidance features and for timing work around an affliction that only lands for part of the year.
The reference catalogue of the nine flying stars: name, Chinese characters, five phase, home palace and trigram, the period each rules, what each means, and which element strengthens or drains it. The remedy element is what the star itself produces, because a harmful star is drained by giving it somewhere to go rather than fought with the phase that controls it. A pure reference endpoint that needs no chart.
Return the four annual feng shui afflictions for a solar year with their exact positions: Tai Sui on the mountain of the year branch, Sui Po on the mountain opposite, the Three Killings across the cardinal span opposite the elemental frame of the year, and the Five Yellow wherever it lands on the annual star plate. Positions come with degree ranges rather than only sector names, because Tai Sui occupies 15 degrees and the neighbouring mountains of the same sector are unaffected. All four move at Li Chun in early February, not at Lunar New Year, and the changeover date is returned. Built for renovation planning, date selection and yearly guidance features.
The nine palaces of the compass Bagua map: the eight trigram sectors plus the centre, each with the life area it governs, its five phase, its colours, and both its Later Heaven and Earlier Heaven trigrams. This is the compass map aligned to true directions, so career is always North and wealth is always Southeast whichever way the entrance faces. Trigram details are served from the same source as the I-Ching trigram endpoints, so the two agree field for field. Built for floor plan overlays, room-by-room guides and any interface that maps a space onto life areas.
Look up one palace of the compass Bagua map by its life area id, such as wealth, career or love. Returns the compass sector it occupies, its five phase and colours, both trigram arrangements and what the sector governs. The health palace is the centre and carries no direction and no trigram, because the centre of the Lo Shu is not a trigram.
The nine twenty year periods of the 180 year San Yuan cycle from 1864 to 2043, each with its ruling star, five phase, palace and the exact Li Chun date it opened, plus which period is in force on a given date. A building takes the period it was completed in and keeps that period plate for life, so this is the table that decides which natal chart a property gets. Period 9 opened on 4 February 2024, which means a building finished in January 2024 is still a Period 8 building.
Course creator, Denmark
I think you have done an amazing job, it must have taken a long time. Clients are happy, and so am I.
Natal chart, transit, horoscope, tarot, dream and crystal readings inside her online courses
Founder, United States
I use RoxyAPI as the data layer for my astrology assistant. It has been reliable.
An astrology assistant on Vedic and KP, dashas, divisional charts, panchang, Western astrology, numerology and tarot
Founder, Portugal
I really appreciate the quick and helpful support from the RoxyAPI team.
A self-knowledge platform that combines Astrology, Human Design, Numerology, BaZi and other traditions into one personal reading
Every customer story comes from an account we confirmed and is published with the approval of that customer.
Read customer storiesThe receipts are public: the testing methodology, the open MIT benchmark, the transparency report, and the live API playground. Let ChatGPT, Perplexity, or Claude search the web and tell you what they find about RoxyAPI accuracy, MCP, SDKs, and pricing.
Opens a live web search in a new tab.
Your AI agent
your model, your voice
Remote MCP
auto-discovered, no local setup
Token-optimizedRoxy Ephemeris
13,957 tests, 3683 gold standard
Verified result
18+ domains, one flat rate
Your agent uses calculated charts and readings in its replies, with your model and your own voice. Planetary positions are verified against NASA JPL Horizons. No local setup, no AGPL, no hosted-AI markup.
Audit it yourself: every Feng Shui endpoint runs live in the API playground
Included in the same plan as Feng Shui
Send the construction period of the building and the direction it faces, either as one of the 24 mountains or as a compass bearing, and the API returns all nine palaces with the period star, the mountain star, the water star, the named formation for each pair and the classical verdict on the chart. Omit the period and it defaults to the one in force. Drop in the typed SDKs or point a client at our Remote MCP server, and one key also covers every other RoxyAPI domain.
Flying star charts follow the down gua construction of the Xuan Kong school, the construction modern texts teach, with the period plate flown forward and the mountain and water plates flown by the San Yuan polarity of the mountain each answers to. Eight Mansions follows the classical Da You Nian classification, derived from the trigram lines themselves, so every sector verdict can be checked by hand. Where a genuine school split exists it is stated rather than hidden.
At Li Chun, the astronomical start of spring in early February, and not at Lunar New Year, which is usually two to four weeks later. Every route in this domain uses that boundary: periods, annual stars, monthly stars and all four afflictions. The exact date is computed for each year rather than assumed to be 4 February, which it is not in roughly one year in four, and it is returned on the response so a caller can apply a new chart on the right day.
The Kua number, also called the Ming Gua, places a person on one of the eight trigrams and decides which four compass sectors are favourable for them and which four are not. It is a function of the Chinese year of birth and of sex, because the two formula variants are different arithmetic on the same year. Birth time and place are not used, so no location lookup is needed. A raw result of 5 has no direction of its own and is reassigned, and the API publishes the untouched result beside the reassigned one.
Yes, and reading them the same way is the usual mistake. The mountain star, also called the sitting star, governs health, the people in a room and the relationships between them. The water star, also called the facing star, governs money, career and whatever arrives from outside. A palace is then judged by the PAIR rather than by either star alone, which is why every palace in a chart comes back with the combination for its pair and a reading composed from both.
Precise to the mountain, which is 15 degrees, rather than to the 45 degree sector most guides quote. Tai Sui occupies exactly one mountain, so the two neighbouring mountains of the same sector are unaffected, and the difference decides whether a wall can be drilled. The Three Killings span is returned as both its exact 75 degree branch range and the cardinal sector it sits in, because both readings are in circulation and a caller should be able to see which one they are applying.
Flying star charts and Kua numbers that are actually checkable.
All 18+ domains included with every plan. Every endpoint, MCP server, SDK, and templates.
Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.
View Pricing & Get API KeyHi, I am Rosie, your guide to the RoxyAPI insight tools.
Ask me to read your birth chart, pull a card, or map your numbers, and I will interpret what it means for you. Unlike most AIs, I never make the numbers up: every reading runs on real, verified calculations. Curious about the API, pricing, or docs instead? Ask me that too.