What is Feng Shui API and how does it work?

Feng Shui API is a REST service that calculates traditional Chinese feng shui analysis programmatically. Send property details (facing direction, construction year) or birth data, receive complete Flying Stars charts, Kua numbers, and recommendations in JSON format. Response time under 300ms. Used by 50+ apps for real estate analysis, mobile feng shui apps, and interior design software.

What feng shui calculations does the API include?

The API covers: Flying Stars (Xuan Kong Fei Xing) with all 144 natal charts, Kua number calculator with 8 directions, annual afflictions (Tai Sui, Five Yellow, Three Killings), Tong Shu date selection, 24 Mountains compass analysis, space analysis for properties, and a remedies database with 500+ traditional cures. Essentially everything a professional feng shui master uses.

Is this authentic traditional feng shui or Western feng shui?

Authentic traditional Chinese feng shui. Our calculations follow classical texts like the Purple White Scripts and methods taught by Hong Kong masters. We include proper Chinese terminology (Xuan Kong, Fei Xing, etc.) alongside English. The Flying Stars algorithms match what professional consultants use - not simplified 'put a plant in the wealth corner' Western adaptations.

What is Period 9 in feng shui and why does it matter?

Period 9 started February 4, 2024 and runs until 2044. In Flying Stars feng shui, the 20-year period determines which stars are prosperous or declining. Star 9 is now most auspicious (was Star 8 in Period 8). Buildings constructed in Period 9 have different energy maps than Period 8 buildings. Our API is fully updated for Period 9 calculations - many desktop software tools are still stuck in Period 8.

How do I integrate Feng Shui API into my React app?

Use REST API with fetch or axios. Get your API key, make POST requests to our endpoints: /fengshui/flying-stars with facing and period params, or /fengshui/kua with birthYear and gender. Responses in JSON format. TypeScript types available in docs. Examples for React, Vue, Next.js in our documentation. Average integration time is 30 minutes for basic features.

What data format does the Flying Stars endpoint return?

JSON with: period number, facing/sitting directions, 9 palace objects each containing base star, mountain star, water star, annual star (optional), monthly star (optional), combination rating (1-10), and interpretation text. Also includes special combinations (Ho Tu, Sum of Ten), best/avoid sectors, and actionable recommendations. All interpretations available in 9 languages.

How accurate are the feng shui calculations?

Our algorithms match professional desktop software like FSML. Flying Stars uses the traditional Yang Dwelling method with correct flying sequences. Kua calculations follow the standard male/female formulas with proper year cutoffs (Chinese New Year, not January 1). We validate against published feng shui master references. Compass precision is 24 mountains (15-degree sectors).

Can I get annual affliction updates automatically?

Yes. The annual afflictions endpoint returns current year positions by default. Data updates automatically at Chinese New Year (typically early February). You can also query specific years. For proactive updates, set up a webhook - we notify you when annual data changes. No manual updates needed in your app.

What programming languages are supported?

Official SDKs for JavaScript/TypeScript, Python, PHP, and Ruby. The REST API works with any language that can make HTTP requests. We provide OpenAPI/Swagger specs for generating clients in other languages. Most developers are up and running within an hour regardless of their stack.

How does the Kua number calculator work?

Send birth year, birth month/day (for Chinese year cutoff), and gender. The API returns: Kua number (1-9), East or West group, 4 favorable directions (Sheng Qi, Tian Yi, Nian Yan, Fu Wei) with meanings and uses, 4 unfavorable directions (Huo Hai, Wu Gui, Liu Sha, Jue Ming), compatible elements, and personalized recommendations for bedroom, office, and front door directions.

What is Tong Shu date selection and what activities does it cover?

Tong Shu is the traditional Chinese almanac for choosing auspicious dates. Our API analyzes any date and returns: Day Officer (12 types like Success, Open, Close), 28 Lunar Constellation, clash animal and direction, list of favorable activities, list of things to avoid, and auspicious hours. Covers weddings, moving house, starting business, signing contracts, renovations, and more.

What annual afflictions does the API track?

Four main afflictions: Tai Sui (Grand Duke) - the year's ruling direction, Five Yellow (Wu Wang) - most dangerous star requiring metal cures, Three Killings (San Sha) - 90-degree danger zone, and Sui Po (Year Breaker) - opposite of Tai Sui. Each includes exact degree positions, affected zodiac signs, and traditional remedies. Critical for any feng shui app showing yearly updates.

Does the API provide feng shui remedies and cures?

Yes. The remedies endpoint returns traditional cures for any star combination or affliction. Includes element-based cures (metal for Five Yellow, water for Star 8), object recommendations (Wu Lou, Pi Yao, pagodas), color suggestions, and placement instructions. Over 500 remedies catalogued. Perfect for e-commerce apps selling feng shui products.

How much does Feng Shui API cost?

Free tier: 50 requests/month. Starter: $11/month for 1,000 requests. Professional: $37/month for 55,000 requests. Business: $99/month for 220,000 requests with all endpoints. Enterprise: $399+/month for unlimited requests and dedicated support. Compare to FSML desktop at $110/year for single-user, no-API access. Our Starter plan costs less and lets you build apps serving thousands of users.

Is there a free tier for testing feng shui calculations?

Yes. 50 free requests every month, forever. No credit card required to start. Enough to build and test your integration, run demos, or power a small personal project. All endpoints included in free tier - Flying Stars, Kua, Tong Shu, afflictions. Upgrade anytime when you need more volume.

How do real estate platforms use Feng Shui API?

Add 'Feng Shui Score' to property listings based on Flying Stars analysis. Show which sectors are best for bedrooms/offices. Flag properties with Five Yellow or Tai Sui afflictions. Match properties to buyer Kua numbers for personalized recommendations. In Asian markets (Hong Kong, Singapore, Vancouver), this directly impacts property values and buyer decisions. Chinese investors buy $30B+ in global real estate annually - they expect feng shui data.

Can I build a mobile feng shui app with this API?

Absolutely - that's our primary use case. The API provides all calculations needed for a complete feng shui app: personal Kua analysis, home Flying Stars charts, annual predictions, date selection, remedies. Response times under 300ms work great for mobile. SDKs available for React Native and Flutter via our JavaScript/Dart clients. Over 50 feng shui apps already powered by our API.

How do interior designers use feng shui calculations?

Flying Stars tells designers which elements and colors work best in each room. A sector with Star 2 (illness) benefits from metal decor. Star 4 (romance) enhances with wood and water. Our API returns element recommendations for each palace, making it easy to generate room-by-room design guides. Interior design apps add feng shui as a premium feature - users pay more for 'energetically optimized' spaces.

Complete Feng Shui Solution

Feng Shui API: Flying Stars, Kua & Tong Shu

The only comprehensive Feng Shui API.

All 144 Flying Star charts, Kua number calculator, annual afflictions, Tong Shu date selection. Build feng shui apps in minutes, not months.

API Docs

144

Flying Star Charts

<300ms

Response Time

Languages

50+

Apps Powered

Used by real estate platforms in Asia

99.9% uptime SLA

Period 9 calculations (2024-2043)

Flying Stars has 144 different natal charts to calculate
Desktop software costs $110/year with no API access
Westernized calculators miss traditional accuracy
Annual afflictions change every Chinese New Year
No comprehensive API exists on the market

Solve with

All 144 Flying Star charts with interpretations
Kua calculator with 8 directions analysis
Auto-updated annual afflictions (Tai Sui, Five Yellow)
Tong Shu date selection for all activities
Multi-language support from $11/month

API Performance Metrics

Built for production feng shui applications

<300ms

Response Time

144

Flying Star Charts

Star Combinations

Kua Directions

Languages

99.9%

Uptime

Complete Feng Shui Toolkit

Everything a professional feng shui master uses, as an API

Flying Stars (Xuan Kong)

Complete Period 9 calculations with all 144 natal charts, annual/monthly overlays, and 81 star combinations

Base, Mountain, Water stars + interpretations

Kua Number Calculator

Personal Kua calculations with favorable/unfavorable directions, compatible elements, and life aspects

East/West group, 8 directions analysis

Annual Afflictions

Tai Sui, Five Yellow, Three Killings positions with remedies. Auto-updates every Chinese New Year

Real-time affliction tracking

Tong Shu Date Selection

Traditional Chinese almanac for auspicious dates. Weddings, moves, business launches, renovations

12 Day Officers, 28 Constellations

Space Analysis

Complete property analysis combining Flying Stars with occupant Kua numbers for optimal room placement

Multi-occupant compatibility

24 Mountains

Precise compass analysis with all 24 mountain positions, trigrams, and directional influences

15-degree precision

Remedies Database

Traditional cures for every star combination. Element-based solutions, placement recommendations

500+ remedies catalogued

Business Feng Shui

Office optimization, desk placement, meeting room analysis for corporate productivity

Sector-based recommendations

Multi-language Support

All interpretations available in 9+ languages including Chinese, English, Spanish, German

Native translations, not machine

What is Feng Shui API? Complete Developer Guide

Everything you need to build feng shui features into your apps

Ever tried building a feng shui app and got stuck on the calculations? Flying Stars alone has 144 different natal charts based on period and facing direction. Then add annual stars, monthly stars, Kua numbers, and you're looking at weeks of development just for the math. Our Feng Shui API handles all that complexity - you send a request, you get back complete analysis with interpretations in under 300ms. It's the same calculations used by professional feng shui masters in Hong Kong, not some simplified Western version. Perfect for real estate platforms targeting Asian markets, mobile feng shui apps, or interior design software. We're in Period 9 now (started Feb 2024), so all our calculations are current - unlike desktop software stuck in Period 8.

How Does the Flying Stars API Work?

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.

All 144 natal charts + 81 star combination interpretations included

1 min read

What Can I Build with Kua Number Calculator API?

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.

Personal directions + compatibility + element analysis in one call

1 min read

Why Do Annual Afflictions Matter for Feng Shui Apps?

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.

2025: Tai Sui SE, Five Yellow W, Three Killings E - auto-updated yearly

1 min read

How Does Tong Shu Date Selection API Help Users?

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.

Find auspicious dates for weddings, moves, business launches

1 min read

Feng Shui API vs Desktop Software: What's the Difference?

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 1,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.

$11/mo API vs $110/yr desktop - unlimited apps vs single user

1 min read

Which Industries Use Feng Shui API?

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.

Real estate, interior design, mobile apps, dating, wellness, smart home

1 min read

Use Cases

Real Estate Platforms

Add Feng Shui Score to listings. Property analysis, facing direction assessment, affliction warnings for Asian market buyers

Mobile Feng Shui Apps

Power your iOS/Android app with professional calculations. Flying Stars, Kua, date selection - complete backend

Interior Design Software

Room-by-room recommendations based on Flying Stars. Color schemes, furniture placement, element balancing

Dating & Compatibility Apps

Kua number matching for relationship compatibility. East/West group analysis, element harmony

Wedding & Event Planning

Tong Shu integration for auspicious date selection. Best days for ceremonies, launches, moves

Business & Productivity Tools

Office feng shui optimization. Desk directions, meeting room selection, career enhancement

Technical Specifications

API Response Time	<300ms average, <500ms p99
Flying Star Charts	144 natal charts (all periods + directions)
Star Combinations	81 interpretations with remedies
Kua Calculations	9 Kua numbers, 8 directions each
Annual Afflictions	Tai Sui, Five Yellow, Three Killings, Sui Po
Date Selection	12 Day Officers, 28 Constellations
Languages Supported	9: EN, ZH, ES, DE, FR, PT, IT, NL, PL
Compass Precision	24 Mountains (15-degree sectors)
Period Support	Periods 1-9 (1864-2043)
Remedies Database	500+ traditional cures catalogued
SDK Availability	JavaScript, Python, PHP, Ruby
Uptime SLA	99.9% availability guarantee

Feng Shui API vs Alternatives

Feature	Astrology API	Others
Flying Stars (all 144 charts)	Yes	Partial or none
Annual/Monthly Stars	Yes, auto-updated	Manual only
Kua Calculator	Full analysis	Basic number only
Tong Shu Date Selection	Complete system	Not available
Annual Afflictions	All 4 types + remedies	Not available
Space Analysis	Multi-occupant support	Not available
REST API	Yes	Desktop only (FSML)
Multi-language	9 languages	English only
Price	From $11/month	$110/year (single user)
Mobile Integration	Full SDK support	Not possible

Related Chinese Astrology APIs

Chinese Horoscope API

Zodiac signs, yearly predictions, compatibility

BaZi Four Pillars API

Destiny analysis, life path calculations

Chinese Compatibility API

Relationship matching, zodiac harmony

API Documentation

Complete endpoint reference and examples

Simple, Transparent Pricing

Start free, scale as you grow. No hidden fees, no surprises.

Always Free

Start Free

Perfect for learning, testing, and small personal projects

50 API calls/month

Basic natal charts

5 house systems

Community support

Pro

$11/month

For small apps and personal projects

All basic endpoints
12 house systems
Email support

Best Value

Pro Plus

$21/month

For growing apps and medium traffic

All enhanced endpoints
18 house systems
AI interpretations
Priority email support

Ultra

$37/month

For professional astrology applications

Credit math ↓

All premium endpoints
23 house systems
Advanced AI interpretations
Priority support

High Volume Plans

For enterprise-scale applications

Business

$99/month

For high-volume applications

Credit math ↓

ALL endpoints
White-label ready
Custom AI fine-tuning
Phone support

UNLIMITED

Enterprise

$399+per month

Unlimited requests with dedicated infrastructure

Dedicated server infrastructure
Sub-300ms guaranteed
24/7 dedicated support
99.99% uptime SLA

All plans include comprehensive documentation and SDKs

Questions? Talk to our team

Frequently Asked Questions

Everything developers need to know about Feng Shui API

Explore Related APIs

Feng Shui API works great with other Chinese astrology endpoints for comprehensive features.

Chinese Horoscope API BaZi Four Pillars Chinese Compatibility Chinese Elements Chinese Zodiac

Build Feng Shui Apps in Minutes

Join 50+ apps powered by Astrology API's Feng Shui endpoints

Start Free View API Docs

50 free requests/month

99.9% uptime SLA

Period 9 ready

No credit card required

Feng Shui API: Flying Stars, Kua & Tong Shu

Building Feng Shui Apps Is Complex

One API for Everything Feng Shui

API Performance Metrics

Complete Feng Shui Toolkit

Flying Stars (Xuan Kong)

Kua Number Calculator

Annual Afflictions

Tong Shu Date Selection

Space Analysis

24 Mountains

Remedies Database

Business Feng Shui

Multi-language Support

What is Feng Shui API? Complete Developer Guide

How Does the Flying Stars API Work?

What Can I Build with Kua Number Calculator API?

Why Do Annual Afflictions Matter for Feng Shui Apps?

How Does Tong Shu Date Selection API Help Users?

Feng Shui API vs Desktop Software: What's the Difference?

Which Industries Use Feng Shui API?

Use Cases

Real Estate Platforms

Mobile Feng Shui Apps

Interior Design Software

Dating & Compatibility Apps

Wedding & Event Planning

Business & Productivity Tools

Technical Specifications

Feng Shui API vs Alternatives

Related Chinese Astrology APIs

Chinese Horoscope API

BaZi Four Pillars API

Chinese Compatibility API

API Documentation

Simple, Transparent Pricing

Always Free

Pro

Pro Plus

Ultra

High Volume Plans

Business

Enterprise

Frequently Asked Questions

What is Feng Shui API and how does it work?

What feng shui calculations does the API include?

Is this authentic traditional feng shui or Western feng shui?

What is Period 9 in feng shui and why does it matter?

How do I integrate Feng Shui API into my React app?

What data format does the Flying Stars endpoint return?

How accurate are the feng shui calculations?

Can I get annual affliction updates automatically?

What programming languages are supported?

How does the Kua number calculator work?

What is Tong Shu date selection and what activities does it cover?

What annual afflictions does the API track?

Does the API provide feng shui remedies and cures?

How much does Feng Shui API cost?

Is there a free tier for testing feng shui calculations?

How do real estate platforms use Feng Shui API?

Can I build a mobile feng shui app with this API?

How do interior designers use feng shui calculations?

Explore Related APIs

Build Feng Shui Apps in Minutes

Building Feng Shui Apps Is Complex

One API for Everything Feng Shui

API Performance Metrics

Complete Feng Shui Toolkit

Flying Stars (Xuan Kong)

Kua Number Calculator

Annual Afflictions

Tong Shu Date Selection

Space Analysis

24 Mountains

Remedies Database

Business Feng Shui

Multi-language Support

Simple, Transparent Pricing

Always Free

Pro