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 Ten Gods are the classical framework professional BaZi readers use to classify every stem in your chart against your Day Master.
Each of the other three pillars gets scored into one of five paired relationships: Friend or Rob Wealth (same element as you, cooperation vs competition), Eating God or Hurting Officer (the element you generate, creativity vs rebellion), Direct Wealth or Indirect Wealth (the element you control, steady income vs opportunistic gains), Direct Officer or Seven Killings (the element that controls you, structure vs pressure), and Direct Resource or Indirect Resource (the element that generates you, support vs unconventional help).
This is what separates a real BaZi reading from a toy zodiac calculator - free calculators usually stop at the Four Pillars and skip this step entirely.
Our API runs the full Ten Gods classification on every chart and returns each relationship as a labeled group of stems, so you can build career, wealth, and relationship guidance the same way a trained BaZi practitioner would.
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.
The Day Master's element and polarity are also the reference point the Ten Gods calculation runs against - get the Day Master wrong and every Ten God relationship downstream is wrong too.
Our API now surfaces the Day Master's element, polarity, seasonal strength (Prosperous, Strong, Resting, Imprisoned, or Dying based on birth season), and a five-level classification from Very Strong to Very Weak, alongside exact strength percentages and 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 | Full classification: Friend/Rob Wealth, Eating God/Hurting Officer, Direct/Indirect Wealth, Direct Officer/Seven Killings, Direct/Indirect Resource |
| Luck Pillars | 10-year major cycles plus annual variations |
| Day Master Strength | Element, polarity, seasonal strength, and five-level classification (Very Strong to Very Weak) with percentage score |
| 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