Calculate a complete BaZi natal chart with Four Pillars, Luck Pillars, Life Gua, and stars.

Args: birth_date: ISO 8601 date, e.g. '1994-01-26' birth_time: Local time as 'HH:MM', e.g. '07:11' gender: 'male' or 'female' timezone: IANA timezone, e.g. 'Asia/Kuala_Lumpur' (optional, improves accuracy near solar term boundaries)

Get the Year, Month, and Day pillars for any date.

Args: date: ISO 8601 date, e.g. '2026-04-10'

Get Tong Shu day quality indicators — Day Officer, 28 Constellation, and Flying Star. No natal chart needed. Instant calculation.

Args: date: ISO 8601 date, e.g. '2026-04-10'

Check natal chart clashes and combinations for a specific date.

Args: date: ISO 8601 date to check, e.g. '2026-04-10' birth_date: Your birth date, e.g. '1994-01-26' birth_time: Your birth time as 'HH:MM', e.g. '07:11' timezone: IANA timezone (optional)

Get the 12 two-hour pillar blocks for any date (23:00-22:59).

Args: date: ISO 8601 date, e.g. '2026-04-10'

Calculate the 10-year Luck Pillar timeline (decades of fortune).

Args: birth_date: ISO 8601 date, e.g. '1994-01-26' birth_time: Local time as 'HH:MM', e.g. '07:11' gender: 'male' or 'female' timezone: IANA timezone (optional)

Look up the Xuan Kong Da Gua hexagram for a stem-branch pillar.

Args: stem: Heavenly Stem — Chinese ('壬'), pinyin ('Ren'), or index (0-9) branch: Earthly Branch — Chinese ('子'), pinyin ('Zi'), animal ('Rat'), or index (0-11)

Get the exact date of a solar term (Jie Qi) for any year.

There are 24 solar terms per year. Term 1 = Lichun (Start of Spring, ~Feb 4).

Args: year: Year to query, e.g. 2026 term_number: Solar term number 1-24 (1=Lichun, 2=Yushui, ..., 24=Dahan)