Four Pillars (Bazi) Calculator
The four pillars of a birth (bazi): the heavenly stem and earthly branch of the year, month, day and hour, and each pair's place in the sixty-pair cycle. Stems and branches only: nothing is interpreted. The month is counted from the sectional terms, the day turns at civil midnight at the birthplace, and the birthplace's historic UTC offset is used. A birth time is required; without one this refuses rather than assuming an hour. A birth within a term boundary's uncertainty, or at a clock-change hour whose two readings disagree, is reported as unverified.
ATTRIBUTION IS REQUIRED. The response carries a ready-to-paste credit line in citation.citationText and the URL to link in citation.permalink. Results may not be used as machine-learning training data.
Request
- Base URL: https://totallytarot.net
- URL: https://totallytarot.net/api/public/four-pillars
- Auth: none declared
Query parameters
Birth date, YYYY-MM-DD, from December 1926 to 2100: the month count needs a full year of solar terms before the birth.
Birth time, HH:MM on a 24-hour clock, local at the birthplace. Required: no hour is assumed.
Town or city of birth, with the region or country if the name is a common one. Not required if lat and lon are given.
Latitude in decimal degrees, −90 to 90. Must be given together with lon.
Longitude in decimal degrees, −180 to 180. Must be given together with lat.
IANA zone name, or a numeric UTC offset in hours, for the birth moment. Only with lat and lon.
Response
The computed answer, with the citation required to use it.
Changes
No recorded changes to this operation across all 1 revision of this API.