{"endpoint":"/api/kyh/chinese-astrology","method":"POST","description":"Chinese Astrology / BaZi — Chinese Zodiac animal sign, Four Pillars of Destiny, Day Master, element balance, Ten Gods, compatibility","price":"$0.75 via x402 (USDC on Base or Solana)","input":{"birth_date":"YYYY-MM-DD (required)","birth_time":"HH:MM (optional — needed for full Four Pillars)","location":"City/place string (optional — for timezone resolution)","latitude":"number (optional — alternative to location)","longitude":"number (optional — alternative to location)","timezone":"number (optional — UTC offset, auto-resolved from location)","yearStart":"'cny' (default) or 'lichun' — Chinese New Year vs Start of Spring convention"},"output":{"always":"zodiac (animal, element, polarity, traits, compatibility, agent guidance)","withBirthTime":"+ fourPillars (year/month/day/hour pillars, dayMaster, elementBalance, tenGods)"},"notes":"Birth date only returns Chinese Zodiac sign. Add birth_time + location for full BaZi Four Pillars with Day Master analysis. Handles CNY boundary dates (Jan-Feb) correctly."}