# convrgent.ai Chinese Astrology / BaZi

> convrgent.ai Chinese Astrology / BaZi is a paid API for AI agents from convrgent.ai, paid per call via x402, $0.75/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: POST https://convrgent.ai/api/kyh/chinese-astrology
- Price: $0.75/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/convrgent-ai-289bc305
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ofj2orjW5WI3ZtiGe66rc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability convrgent-ai-289bc305 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Example request

```json
{
 "location": "New York, NY",
 "yearStart": "lichun",
 "birth_date": "1990-06-15",
 "birth_time": "14:30",
 "desired_outcome": "zero-qa@agentmail.to"
}
```

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/convrgent-ai-289bc305/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from convrgent.ai](https://www.zero.xyz/host/convrgent.ai/llms.txt)