The Zi Wei Dou Shu API Emperors Would Approve

Zi Wei Dou Shu maps your birth moment onto a chart with 12 'palaces' (like rooms in a mansion), each representing a life area: career, wealth, relationships, health, etc.

Then it places 108 stars across these palaces based on complex formulas developed over 1,000 years ago.

The position of the Zi Wei star (Purple Star/Emperor Star) is calculated first - it's the anchor that determines where all other stars go.

Unlike Western astrology that uses actual planet positions, Zi Wei Dou Shu uses symbolic stars with specific meanings.

Each palace can have 5-10 stars influencing it, creating nuanced readings that Western systems can't match.

The 12 palaces are like 12 departments of your life: Life Palace (core personality), Parents Palace, Fortune Palace (hidden blessings), Property Palace, Career Palace, Friends Palace, Travel Palace, Health Palace, Wealth Palace, Children Palace, Spouse Palace, and Siblings Palace.

Each palace tells a different story.

For example, someone might have excellent Career Palace stars but challenging Wealth Palace - meaning they're successful at work but struggle to keep money.

Our API analyzes all 12 palaces with detailed star placements and interpretations.

It's like getting 12 readings in one.

BaZi (Four Pillars) uses 4 elements to describe your destiny.

Zi Wei Dou Shu uses 108 stars across 12 houses - that's way more data points for analysis.

It's like comparing a thermometer (BaZi) to a full weather station (Zi Wei Dou Shu).

BaZi tells you 'you're a Metal person.' Zi Wei Dou Shu tells you 'you have the Emperor Star in your Career Palace with the Wealth Star supporting it, but the Lonely Star in your Spouse Palace might delay marriage.' Much more specific and actionable.

Many Chinese astrologers use both systems together.

Zi Wei Dou Shu has been the preferred system for Chinese imperial courts and elite families for over 1,000 years.

Its accuracy comes from using exact birth time (down to the 2-hour period) to calculate precise star positions.

Users report 80-90% accuracy for personality descriptions and 75% accuracy for life event timing.

The system excels at identifying specific challenges and opportunities in each life area.

Our API uses traditional formulas from classical texts while handling all the complex calculations automatically.

Flying Stars (飞星) are stars that 'fly' from one palace to another based on your 10-year luck periods and annual cycles.

It's like a dynamic overlay on your birth chart that changes over time.

For example, your Wealth Palace might have neutral stars in your birth chart, but during certain periods, powerful flying stars arrive that boost your money-making ability.

Our API calculates both static birth chart stars AND flying stars for any time period.

This makes timing predictions extremely accurate.

Integration is straightforward: (1) Send birth date, time (2-hour Chinese hour), and gender via POST request, (2) Get complete chart with all 108 stars positioned across 12 palaces, (3) Display using our formatted interpretations.

We handle the complex star calculations - you just show results.

Perfect for: fortune-telling apps (detailed readings), dating apps (compatibility matching), business platforms (timing advice).

Response time under 300ms keeps your app fast.