# Convrgent AI – Natal Chart / Birth Chart

> Convrgent AI – Natal Chart / Birth Chart is a paid API for AI agents from convrgent.ai, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-15).

Generates a Western astrology natal chart with planetary positions, zodiac signs, houses, aspects, and personality interpretation using Swiss Ephemeris precision.

## Facts

- Endpoint: POST https://convrgent.ai/api/kyh/natal-chart
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/convrgent-ai-0837b1e5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f265hUt5Crj3jSyAR2kft

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-0837b1e5 -d '<json body>'
```

Example prompt: Can you generate a full Western natal chart for someone born on March 14, 1990 at 7:32 AM in Chicago, IL — I want the Sun, Moon, and Rising signs, house placements, planetary aspects, and a personality interpretation.

## When to prefer this

Choose this endpoint when you need a full Western tropical astrology natal chart with Swiss Ephemeris precision and personality interpretation in a single call. Prefer this over sibling endpoints when you need comprehensive planetary positions, house placements, and aspects together rather than a Vedic/sidereal chart (use the Vedic endpoint for that) or a quick single psychological dimension.

## Known failure modes

- Missing or invalid birth date returns a 400 error
- Ambiguous or unrecognizable birth location may fail geocoding
- Missing birth time may limit Rising sign and house calculations
- Malformed request body returns validation error
- Service unavailability returns 5xx error

## How this service works

Natal chart / birth chart — astrology, planetary positions, zodiac signs, Sun sign, Moon sign, Rising sign, houses, aspects. Swiss Ephemeris precision with personality interpretation and horoscope-style agent guidance.

## Output

Returns a complete Western astrology natal chart including planetary positions (Sun, Moon, Mercury, Venus, Mars, etc.), zodiac sign placements, Rising sign (Ascendant), house assignments for each planet, major aspects (conjunctions, trines, squares, etc.), and a horoscope-style personality interpretation and agent guidance narrative — all calculated with Swiss Ephemeris precision.

## 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": {
     "type": "object",
     "required": [
      "year",
      "month",
      "day",
      "location"
     ],
     "properties": {
      "day": {
       "type": "integer"
      },
      "hour": {
       "type": "integer",
       "description": "Highly recommended. Defaults to 12 if omitted."
      },
      "year": {
       "type": "integer"
      },
      "month": {
       "type": "integer"
      },
      "minute": {
       "type": "integer",
       "description": "Defaults to 0 if omitted."
      },
      "latitude": {
       "type": "number",
       "description": "Optional override"
      },
      "location": {
       "type": "string",
       "description": "City and country. Coordinates auto-resolved."
      },
      "timezone": {
       "type": "number",
       "description": "Optional — auto-resolved from location"
      },
      "longitude": {
       "type": "number",
       "description": "Optional override"
      }
     }
    },
    "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": {
  "chart": {
   "houses": [
    "..."
   ],
   "aspects": [
    "..."
   ],
   "planets": [
    "..."
   ],
   "sunSign": "Gemini",
   "moonSign": "Scorpio",
   "risingSign": "Libra"
  },
  "agent_prompt": "# Personality Profile — New York, NY\n## Core Identity\nGemini Sun...",
  "interpretation": {
   "coreIdentity": "...",
   "elementProfile": "...",
   "communicationStyle": "...",
   "emotionalLandscape": "..."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/convrgent-ai-0837b1e5/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)