{"uid":"cap_PVfHlazHoiI0a6dImfLCu","slug":"chinese-calendar-bazi-four-pillars-calculator-18c68013","name":"Chinese Calendar BaZi (Four Pillars) Calculator","description":"Four Pillars (BaZi) chart for a date and optional time: stems, branches, animals, five-element counts, day master.","url":"https://chinese-culture.x402tookit.com/bazi?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["date"],"properties":{"date":{"type":"string","description":"Civil date YYYY-MM-DD, 1930 to 2100"},"time":{"type":"string","description":"Local clock time HH:MM; omit to skip the hour pillar"},"dayStarts":{"type":"string","description":"midnight (default) or 23:00 for schools whose day begins at 23:00"},"utcOffset":{"type":"number","description":"Clock offset from UTC in hours, -12 to 14, default 8 (China)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"source":{"type":["null","string"]},"pillars":{"type":["null","object"],"properties":{"day":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"stemElement":{"type":["null","string"]},"branchAnimal":{"type":["null","string"]},"stemPolarity":{"type":["null","string"]},"branchElement":{"type":["null","string"]}}},"hour":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"stemElement":{"type":["null","string"]},"branchAnimal":{"type":["null","string"]},"stemPolarity":{"type":["null","string"]},"branchElement":{"type":["null","string"]}}},"year":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"stemElement":{"type":["null","string"]},"branchAnimal":{"type":["null","string"]},"stemPolarity":{"type":["null","string"]},"branchElement":{"type":["null","string"]}}},"month":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"stemElement":{"type":["null","string"]},"branchAnimal":{"type":["null","string"]},"stemPolarity":{"type":["null","string"]},"branchElement":{"type":["null","string"]}}}}},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"baziYear":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"dayMaster":{"type":["null","object"],"properties":{"stem":{"type":["null","string"]},"element":{"type":["null","string"]},"polarity":{"type":["null","string"]}}},"utcOffset":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"dayStartsAt":{"type":["null","string"]},"elementCounts":{"type":["null","object"],"properties":{"Fire":{"type":["null","number"]},"Wood":{"type":["null","number"]},"Earth":{"type":["null","number"]},"Metal":{"type":["null","number"]},"Water":{"type":["null","number"]}}},"missingElements":{"type":["array","null"],"items":{"type":"string"}},"sunLongitudeDeg":{"type":["null","number"]},"strongestElements":{"type":["array","null"],"items":{"type":"string"}},"hourPillarIncluded":{"type":["boolean","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UPr4HhgWIdMCLhoytx7Hs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a Four Pillars (BaZi) astrology chart for a given date and optional time, returning heavenly stems, earthly branches, zodiac animals, five-element counts, and day master details.","exampleAgentPrompt":"Can you generate the Four Pillars BaZi chart for March 15, 1990 at 14:30, using UTC+8, showing the heavenly stems, earthly branches, zodiac animals, and five-element counts for each pillar?","exampleUseCases":[{"title":"Birth chart for astrology reading","prompt":"Generate the full BaZi Four Pillars chart for someone born on July 22, 1985 at 08:15 AM in China (UTC+8) — I need the stems, branches, zodiac animals, five-element counts, and day master for a Chinese astrology reading."},{"title":"Auspicious date analysis","prompt":"What are the heavenly stem and earthly branch pillars for January 8, 2025? I want to check the five-element energies of that day to see if it's auspicious, using midnight as the day start."},{"title":"Hour pillar for feng shui consultant","prompt":"I need the BaZi hour pillar for a meeting starting at 11:00 on April 3, 2024, with UTC+8 offset — give me the stem, branch, animal, and element for the hour pillar specifically."}],"resultDescription":"Returns a structured BaZi chart object with four pillars (year, month, day, hour): each pillar includes Chinese character text, pinyin romanization, heavenly stem element and polarity, earthly branch element, and zodiac animal. Also includes aggregate five-element counts across all pillars, the day master (day stem identity), and metadata such as the source and calculation timestamp.","failureModes":["Date out of supported range (1930–2100) returns an error","Malformed date format (not YYYY-MM-DD) causes a validation error","Invalid time format (not HH:MM) causes a validation error","UTC offset outside -12 to 14 returns a validation error","Hour pillar omitted if time parameter is not supplied (expected behavior, not a failure)","Network or payment errors may return 402 or 5xx responses"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable BaZi / Four Pillars data including stems, branches, animals, five-element counts, and day master for a specific Gregorian date and optional time. It is more suitable than a general Chinese calendar lookup when the use case is Chinese metaphysics, astrology, feng shui, or destiny analysis rather than simple lunar date conversion. It covers dates from 1930 to 2100 and supports configurable UTC offsets and day-start conventions (midnight or 23:00) for different BaZi schools.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:30:14.870Z","isFirstParty":false,"canonicalSlug":"chinese-calendar-bazi-four-pillars-calculator-18c68013"}