Feng Shui API: Flying Stars, Kua & Tong Shu

Flying Stars (Xuan Kong Fei Xing) maps energy across 9 sectors of any building.

You send us the facing direction in degrees and construction period, we return all 9 palace positions with base star, mountain star, and water star.

Each combination has specific meanings - some bring wealth, others cause problems.

Our API includes interpretations for all 81 possible star combinations, plus annual and monthly overlays.

Response format is clean JSON that's easy to render in any UI.

Most feng shui apps show a 3x3 grid with numbers - those are the flying stars we calculate.

The tricky part (which we handle) is the 'flying' pattern - stars don't just sit there, they move in specific sequences based on the center number.

Kua numbers determine personal favorable directions for sleep, work, and relationships.

Calculate once from birth date and gender, use everywhere in your app.

Our API returns the Kua number (1-9), East or West group classification, all 8 directional influences (Sheng Qi, Tian Yi, etc.), and compatible/incompatible directions.

Real estate apps use this to match properties to buyers - a Kua 1 person wants a different facing direction than Kua 6.

Dating apps use it for compatibility.

Productivity apps suggest optimal desk facing directions.

The API also returns which elements strengthen or weaken the person's energy, useful for color and decor recommendations.

Every year the energy shifts.

Tai Sui (Grand Duke Jupiter) moves to a new position - disturbing that sector causes bad luck.

Five Yellow (worst affliction) lands somewhere different each year.

Three Killings affects an entire 90-degree span.

Your users need to know where these are to avoid problems.

Our API tracks all afflictions with exact degree positions, affected zodiac signs, and recommended remedies.

The data auto-updates at Chinese New Year (February).

For 2025 Snake year: Tai Sui is in Southeast, Five Yellow in West, Three Killings in East.

Apps that show 'feng shui for 2025' need this data - it's what users search for every January.

Tong Shu is the traditional Chinese almanac - it tells which days are good for specific activities.

Moving house? Some days are auspicious, others disastrous.

Getting married? The date affects the marriage.

Starting a business? Choose wrong and face obstacles.

Our API analyzes any date and returns: Day Officer (12 types), 28 Constellation, clash animals, auspicious activities, things to avoid, and best hours.

Wedding planning apps love this - users can search for the best wedding dates in a range.

Real estate apps show optimal moving dates.

The calculations combine lunar calendar, stem-branch cycles, and constellation positions.

FSML Professional costs $110/year and runs on Windows only.

No API, no mobile, no integration.

Every calculation requires manual data entry.

Our API costs $11/month for 5,000 requests - that's enough for a small app with thousands of users.

You get REST endpoints that work anywhere, SDKs for popular languages, and calculations that match professional desktop software.

The algorithms are identical - we use the same classical formulas from traditional feng shui texts.

But we add modern conveniences: multi-language support, JSON responses, webhook notifications for annual updates.

Desktop software is for consultants doing one analysis at a time.

Our API is for developers building products that serve thousands.

Real estate is huge - Asian property buyers expect feng shui analysis.

In Hong Kong, bad feng shui can drop property value 10-20%.

Our API lets platforms add 'Feng Shui Score' alongside Walk Score.

Interior design apps use Flying Stars to recommend colors and furniture placement for each room.

Mobile feng shui apps (there are hundreds on app stores) need calculation backends - that's us.

Dating apps targeting Asian markets add Kua compatibility.

Wellness platforms include feng shui in holistic lifestyle features.

Smart home systems optimize room usage based on energy flow.

Even gaming companies use it for virtual world building.

If your users care about Chinese culture, they probably care about feng shui.