Endpoint

Chinese

Four Pillars, year animal, and pair scoring. Minutes and timezone determine the solar-term boundary. Gender is ignored.

POST /api/v1/chinese/bazi

POST /api/v1/chinese/animal

POST /api/v1/chinese/compatibility

BaZi request

{
  "day": 15,
  "hour": 14,
  "month": 5,
  "year": 1990
}

BaZi result: year/month/day/hour_pillar objects (stem, branch, full_name, element, animal), animals, elements, summary, sixty_year_cycle. Not four_pillars strings or ten_gods.
API timezone is optional and defaults to UTC. Supply an IANA zone for local birth times. The location-free BaZi report form uses China Standard Time (UTC+8), as labeled on the form.
Animal requires year. Result includes stem/branch, 60-year name/index, and characteristics (strengths, weaknesses, best_match, lucky_numbers, lucky_colors).
Compatibility scores are 1–10 nested objects, not 0–100. Hour defaults to 12 for pillars.