Authentic Four Pillars of Destiny calculations in under 250ms.
Traditional Chinese methods with modern precision for your apps.
BaZi API works best combined with our other tools. Add
Built for scale, optimized for speed
From basic calculations to advanced 10 Gods analysis
Everything you need to know about authentic Chinese astrology calculations for your app
Chinese BaZi (Four Pillars of Destiny) is like a crystal ball that actually works. Instead of vague horoscopes, BaZi uses your exact birth time to create a detailed map of your personality, strengths, challenges, and life timing. Think of it like the iPhone of Chinese divination - much more sophisticated than simple zodiac signs. Our API calculates authentic Four Pillars charts in under 250ms using traditional Chinese methods that have worked for over 1,000 years. Perfect for apps targeting Asian markets where users expect real Chinese astrology, not Western zodiac knock-offs.
BaZi works by mapping your birth moment onto the Chinese calendar system.
Here's the simple version: (1) We convert your birth date/time to the Chinese solar calendar, (2) Calculate four 'pillars' - year, month, day, hour stems and branches, (3) Analyze the Five Elements (Wood, Fire, Earth, Metal, Water) in your chart, (4) Determine your Day Master element and strength.
Each pillar has a Heavenly Stem (like your personality) and an Earthly Branch (like your foundation).
Unlike Western astrology that uses planets, Chinese BaZi uses natural elements and their interactions.
It's like a personality DNA test that also predicts timing.
The 10 Gods are like personality archetypes in your BaZi chart.
Based on how elements interact with your Day Master (your core element), you get different 'God' types: Wealth (money-making ability), Officer (authority and status), Seal (education and support), Eating God (creativity and expression), Hurting Officer (rebellion and innovation), plus five more.
It's much more detailed than Western astrology's 12 signs.
For example, if you're a Metal Day Master and have lots of Wood in your chart, that becomes your 'Wealth' - meaning you're naturally good at making money.
Our API calculates all 10 Gods automatically and explains what they mean in plain language.
Luck Pillars are like knowing the weather forecast for your whole life.
Every 10 years you enter a new 'fortune cycle' that changes your life themes and opportunities.
Our API calculates exactly when these periods start/end and what each brings.
For example, you might have a 'Wealth Luck' period from age 25-35 (great for career), then 'Relationship Luck' from 35-45 (marriage/partnerships).
It's incredibly accurate for major life planning.
Chinese billionaires use this for business timing.
Our API gives you 80+ years of fortune cycles with detailed explanations for each period.
Your Day Master (birthday stem) is like your core operating system.
It can be 'strong' (lots of supporting elements) or 'weak' (needs help from other elements).
This determines EVERYTHING - your personality, what brings you luck, ideal career paths, compatible partners, even best colors to wear.
Strong Day Masters are independent and powerful.
Weak Day Masters are flexible and cooperative.
Our API calculates exact strength percentages and tells you which elements to embrace vs avoid.
It's like a user manual for your own personality.
Chinese BaZi has been tested on billions of people over 1,000 years.
It's not magic - it's pattern recognition at massive scale.
Our API uses authentic formulas from classical texts like 'Di Tian Sui' and 'Qiong Tong Bao Jian'.
We combine traditional wisdom with modern precision (exact birth time calculations, correct Chinese calendar conversions).
Users report 85% accuracy for personality analysis and 78% accuracy for life timing predictions.
That's much higher than Western horoscopes (about 40% accuracy), because BaZi uses your exact birth moment, not just your birth month.
Asian users expect authentic Chinese astrology, not Western knock-offs.
Our API makes integration super easy: (1) Send birth date/time/location, (2) Get complete Four Pillars chart in JSON format, (3) Display with our formatted interpretations in Chinese/English.
We handle all the complex calendar conversions and cultural nuances.
Perfect for dating apps (compatibility matching), business platforms (timing advice), wellness apps (elemental balance), or divination features.
Response time under 250ms won't slow down your app, and authentic calculations build trust with Asian users.
Traditional Chinese compatibility matching, optimal wedding timing, relationship harmony analysis
Business timing advice, team compatibility, leadership assessment, business name selection
Investment timing, wealth fortune periods, career change guidance, prosperity forecasting
Daily fortune readings, personalized advice, traditional Chinese divination features
Personality assessment, team building, career guidance, leadership development
Chinese culture learning, metaphysics education, traditional wisdom preservation
| API Response Time | <250ms average calculation (5x faster than manual) |
| Calendar Accuracy | Chinese solar calendar with leap month handling |
| Historical Range | 1900-2100 CE with full accuracy |
| Four Pillars | Complete year, month, day, hour stem/branch analysis |
| Five Elements | Wood, Fire, Earth, Metal, Water strength calculations |
| Ten Gods Analysis | Complete personality archetype mapping |
| Luck Pillars | 10-year major cycles plus annual variations |
| Day Master Strength | Strong/weak classification with percentage |
| Element Interactions | Supporting, conflicting, and neutral relationships |
| Cultural Context | Traditional Chinese, Simplified Chinese, English |
| Timezone Support | Global locations with historical daylight saving |
| Local Solar Time (LST) | True solar time adjustment based on birth longitude |
| Output Formats | JSON, XML, formatted text interpretations |
| Traditional Methods | Classical texts: Di Tian Sui, Qiong Tong Bao Jian |
| Compatibility Analysis | Relationship harmony scoring between charts |
| SDK Support | JavaScript, Python, PHP, Ruby, Swift, Kotlin |
| Feature | Astrology API | Others |
|---|---|---|
| Calculation Method | Traditional Chinese formulas | Simplified Western adaptations |
| Four Pillars | Complete stem/branch analysis | Basic year/day only |
| Five Elements | Precise strength percentages | Simple element counting |
| Ten Gods Analysis | Complete personality mapping | Not available |
| Luck Pillars | 10-year + annual cycles | Basic yearly predictions |
| Day Master Strength | Scientific calculation | Guesswork or missing |
| Chinese Calendar | Authentic solar calendar | Approximated or wrong |
| Cultural Accuracy | Traditional Chinese methods | Westernized interpretations |
| Local Solar Time (LST) | Automatic LST adjustment toggle | Not available |
| Response Time | <250ms | 1-3 seconds |
| Historical Accuracy | 1900-2100 precise | Limited date range |
| Language Support | Chinese + English | English only |
| Compatibility Analysis | Detailed harmony scoring | Basic or missing |
| Price | $37/month | $99-299/month |
| Free Tier | 100 calculations | 50-100 calculations |
| Setup Time | 15 minutes | 2-3 hours |
Purple Star Astrology - Imperial Chinese fortune telling
Daily Chinese zodiac predictions
Western astrology birth charts
Chinese numerology calculations
Relationship compatibility analysis
Complete technical reference
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 to real questions - no corporate babble