Authentic 108-star Purple Star Astrology calculations in under 300ms.
The most detailed Chinese astrology system for your apps.
Zi Wei Dou Shu API works best combined with our other tools. Add
Built for scale, optimized for authentic calculations
From basic charts to advanced flying star calculations
Everything developers need to know about the Emperor's astrology system for modern apps
Zi Wei Dou Shu (紫微斗数), also called Purple Star Astrology, is like the secret weapon Chinese emperors used for major decisions. While BaZi is popular, Zi Wei Dou Shu goes way deeper - it uses 108 stars arranged across 12 life palaces to map your entire destiny. Think of it as upgrading from a compass to GPS. Our API calculates authentic Zi Wei Dou Shu charts in under 300ms, tracking all 108 stars including the famous Zi Wei star (the Emperor Star). Perfect for astrology apps that want to offer something unique and powerful that most competitors don't have.
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.
Zi Wei Dou Shu Spouse Palace analysis for matching, relationship timing, and marriage compatibility predictions
Career Palace analysis for professional guidance, business timing, leadership assessment, and partnership matching
Wealth Palace analysis for investment timing, prosperity periods, and financial opportunity forecasting
Offer Zi Wei Dou Shu as a premium feature - detailed 108-star readings that differentiate from basic horoscopes
Zi Wei Dou Shu is extremely popular in Taiwan, Hong Kong, and Chinese communities - authentic readings build trust
Chinese astrology learning apps, traditional wisdom courses, cultural education platforms
| API Response Time | <300ms average (faster than loading a webpage) |
| Stars Calculated | 108 stars including 14 major stars and 94 minor stars |
| Palace System | Complete 12-palace analysis with star placements |
| Historical Range | 1900-2100 CE with full accuracy |
| Flying Stars | 10-year major periods plus annual flying star overlays |
| Birth Time System | Traditional 12 Chinese hours (2-hour periods) |
| Star Brightness | Miao, Wang, De, Xian, Luo brightness levels |
| Interpretation Depth | Each palace with multiple stars and interactions explained |
| Compatibility Analysis | Compare two charts for relationship harmony scoring |
| Language Support | Traditional Chinese, Simplified Chinese, English |
| Output Formats | JSON with star positions, palace descriptions, interpretations |
| Chart Schools | San He (Three Harmony) and Flying Star methods supported |
| Timezone Support | Global locations with accurate Chinese hour conversion |
| SDK Support | JavaScript, Python, PHP, Ruby, Swift, Kotlin |
| Traditional Methods | Based on classical Zi Wei Dou Shu texts and formulas |
| Feature | Astrology API | Others |
|---|---|---|
| Stars Calculated | 108 stars (complete) | 14-40 stars (partial) |
| Palace Analysis | All 12 palaces with interpretations | Main palaces only |
| Flying Stars | 10-year + annual flying stars | Not available |
| Star Brightness | 5 levels calculated | Basic or missing |
| Interpretation Quality | Professional astrologer level | Generic descriptions |
| Chart Schools | San He + Flying Star methods | Single method only |
| Compatibility | Full Spouse Palace comparison | Basic or missing |
| Response Time | <300ms | 1-5 seconds |
| Language Support | Chinese + English | Chinese only or poor translation |
| API Integration | Clean REST API + SDKs | Complex or no API |
| Price | $37/month | $99-299/month |
| Free Tier | 100 calculations | 10-50 calculations |
| Documentation | Complete with examples | Minimal or outdated |
| Historical Accuracy | 1900-2100 precise | Limited date range |
| Setup Time | 30 minutes | 2-5 hours |
Start free, scale as you grow. No hidden fees, no surprises.
For small apps and personal projects
For growing apps and medium traffic
For enterprise-scale applications
All plans include comprehensive documentation and SDKs
Questions? Talk to our team
Real answers about Purple Star Astrology calculations