{"uid":"cap_ofj2orjW5WI3ZtiGe66rc","slug":"convrgent-ai-289bc305","name":"convrgent.ai Chinese Astrology / BaZi","description":"Chinese Astrology / BaZi — Four Pillars of Destiny, Chinese Zodiac animal sign, Day Master, Heavenly Stems, Earthly Branches, element balance, Ten Gods relationships, animal compatibility. Calendar math with Swiss Ephemeris solar term precision.","url":"https://convrgent.ai/api/kyh/chinese-astrology","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"required":["birth_date"],"properties":{"location":{"type":"string"},"yearStart":{"enum":["cny","lichun"],"type":"string"},"birth_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"birth_time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","description":"Needed for full Four Pillars"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"zodiac":{"animal":"horse","traits":["energetic","independent","adventurous"],"element":"metal","polarity":"yang"},"fourPillars":{"dayMaster":{"element":"fire","polarity":"yang"},"elementBalance":{"weak":"water","dominant":"fire"}}}},"example":{"request":{"location":"New York, NY","yearStart":"lichun","birth_date":"1990-06-15","birth_time":"14:30","desired_outcome":"zero-qa@agentmail.to"},"response":{"status":"success","zodiac":{"animal":"horse","traits":["energetic","independent","adventurous","warm-hearted","quick","restless"],"element":"metal","polarity":"yang","yearStem":{"index":6,"pinyin":"gēng","chinese":"庚","element":"metal","polarity":"yang"},"yearBranch":{"hours":"11:00-13:00","index":6,"animal":"horse","pinyin":"wǔ","chinese":"午","element":"fire","polarity":"yang","hiddenStems":[3,5]},"agentGuidance":"This person values freedom and action. Keep things moving — they dislike being held back. Be adaptable, offer variety, and don't micromanage. They respond to enthusiasm.","compatibility":{"harms":["ox"],"allies":["tiger","dog"],"clashes":["rat"],"description":"horse forms a harmony triangle with tiger and dog. Secret friend: goat. Clashes with rat. Hidden conflict with ox.","secretFriend":"goat"}},"_context":{"tips":["You've been profiling individuals. KYH also offers compatibility, conflict prediction, and bridge communication for pairs.","The /api/kyh/portrait endpoint synthesizes all 5 frameworks into a single comprehensive personality profile."],"framing":"exploratory","feedback":{"enabled":false,"message":"Feedback collection coming soon via ERC-8004 reputation registry.","placeholder":{"method":"submitFeedback(uint256 agentId, uint8 rating, bytes32 interactionHash)","chainId":8453,"contract":"0x0000000000000000000000000000000000000000"}},"agentType":"explorer","suggestions":["You've been exploring broadly — the /api/kyh/portrait endpoint gives a comprehensive synthesis of all frameworks","For quick lookups, the /api/kyh/micro endpoints offer single data points at $0.05-$0.15"],"interactionCount":51},"accuracy":{"warnings":[],"birthTimeProvided":true,"yearStartConvention":"lichun"},"timestamp":"2026-06-16T01:17:25.128Z","fourPillars":{"day":{"stem":{"index":8,"pinyin":"rén","chinese":"壬","element":"water","polarity":"yang"},"label":"Day","branch":{"hours":"23:00-01:00","index":0,"animal":"rat","pinyin":"zǐ","chinese":"子","element":"water","polarity":"yang","hiddenStems":[9]}},"hour":{"stem":{"index":3,"pinyin":"dīng","chinese":"丁","element":"fire","polarity":"yin"},"label":"Hour","branch":{"hours":"13:00-15:00","index":7,"animal":"goat","pinyin":"wèi","chinese":"未","element":"earth","polarity":"yin","hiddenStems":[5,3,1]}},"year":{"stem":{"index":6,"pinyin":"gēng","chinese":"庚","element":"metal","polarity":"yang"},"label":"Year","branch":{"hours":"11:00-13:00","index":6,"animal":"horse","pinyin":"wǔ","chinese":"午","element":"fire","polarity":"yang","hiddenStems":[3,5]}},"month":{"stem":{"index":8,"pinyin":"rén","chinese":"壬","element":"water","polarity":"yang"},"label":"Month","branch":{"hours":"11:00-13:00","index":6,"animal":"horse","pinyin":"wǔ","chinese":"午","element":"fire","polarity":"yang","hiddenStems":[3,5]}},"tenGods":[{"name":"Direct Resource","chinese":"正印","element":"metal","polarity":"yang","description":"Element that produces me, same polarity. Represents support, education, nurturing, wisdom, and protection from elders.","relationship":"Year Pillar stem (gēng)"},{"name":"Friend","chinese":"比肩","element":"water","polarity":"yang","description":"Same element, same polarity. Represents peers, siblings, competition, independence, and self-reliance.","relationship":"Month Pillar stem (rén)"},{"name":"Indirect Wealth","chinese":"偏财","element":"fire","polarity":"yin","description":"Element overcome, opposite polarity. Represents windfall, speculation, generosity, social connections, and unexpected gains.","relationship":"Hour Pillar stem (dīng)"}],"dayMaster":{"stem":{"index":8,"pinyin":"rén","chinese":"壬","element":"water","polarity":"yang"},"description":"Yang Water (壬) — The ocean. Vast, powerful, philosophical, unstoppable. Deep thinker with broad perspective. Can be overwhelming in force but also deeply wise.","agentGuidance":"This person thinks broadly and deeply. They appreciate big-picture perspectives and philosophical depth. Don't be shallow — engage with the depth of their thinking."},"elementBalance":{"fire":3.3,"weak":"wood","wood":0.3,"earth":1.5999999999999999,"metal":1,"water":3,"dominant":"fire"}},"inputProvided":{"location":true,"birthDate":true,"birthTime":true}}},"exampleRequest":{"location":"New York, NY","yearStart":"lichun","birth_date":"1990-06-15","birth_time":"14:30","desired_outcome":"zero-qa@agentmail.to"},"tags":["x402"],"displayCostAmount":"0.75","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.75/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.75","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.75","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GVwOy_tgDchkrI39lAs3N","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.75","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates a full BaZi (Four Pillars of Destiny) chart including Chinese zodiac animal, Day Master, Heavenly Stems, Earthly Branches, element balance, Ten Gods relationships, and animal compatibility using Swiss Ephemeris solar term precision.","exampleAgentPrompt":"Can you pull my full BaZi / Four Pillars of Destiny chart? I was born on June 15, 1990 at 2:30pm in New York, NY — use the lichun solar term as the year start and tell me my zodiac animal, Day Master, element balance, Ten Gods, and compatibility info.","exampleUseCases":null,"resultDescription":"Returns the Chinese zodiac animal with traits, element, polarity, Heavenly Stem and Earthly Branch details for the birth year, hidden stems, element balance, Ten Gods relationships, animal compatibility (allies, clashes, harms, secret friend), and an agentGuidance string recommending how to communicate with this person based on their BaZi profile.","failureModes":["Missing or malformed birth_date returns a validation error","Ambiguous or unrecognized location may fail geocoding or default to UTC","Unsupported yearStart value (not 'lichun' or 'january') may cause a parameter error","birth_time outside valid range (00:00–23:59) returns an error","Truncated or network-interrupted response may yield incomplete pillars data"],"whenToPreferThis":"Choose this endpoint when you need precise BaZi / Four Pillars of Destiny analysis grounded in Swiss Ephemeris solar term math, including hidden stems, Ten Gods, and animal compatibility — rather than a simple zodiac lookup or Western astrology chart. Ideal when building personality profiles or agent briefing documents that incorporate Chinese metaphysical frameworks alongside psychological or Vedic data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:35:31.181Z","isFirstParty":false}