# Astro Agents Western Natal Chart API

> Astro Agents Western Natal Chart API is a paid API for AI agents from astro-agents-api.vercel.app, paid per call via x402, $0.06/call, status unknown (last checked 2026-10-12).

Computes a deterministic Western astrology natal chart from birth coordinates and time using NASA/JPL DE440 ephemeris, returning planetary positions, house cusps, aspects, and chart summary with a reproducible SHA-256 hash.

## Facts

- Endpoint: POST https://astro-agents-api.vercel.app/v1/western/natal?utm_source=zero.xyz
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/astro-agents-western-natal-chart-api-df96e7a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FfqgyVrVz2vt7mD6Fz3Xy

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 astro-agents-western-natal-chart-api-df96e7a4 -d '<json body>'
```

Example prompt: Calculate my Western natal birth chart for someone born on April 28, 1990 at 7:45 AM civil time in London (51.5074° N, 0.1278° W), using Placidus houses and tropical zodiac — I want to know my sun sign, moon sign, rising sign, and the major aspects between planets.

## When to prefer this

Choose this endpoint when you need a mathematically precise, reproducible natal chart calculation backed by NASA/JPL DE440 ephemeris data — ideal for astrology apps, research, and AI agents that must guarantee the same input always produces the same output (verified via SHA-256). Prefer this over LLM-based astrology responses when accuracy, auditability, and support for multiple house systems (Placidus, Whole Sign, Koch, etc.) and zodiac types (tropical/sidereal) matter.

## Known failure modes

- Missing required latitude or longitude returns a validation error
- Invalid date/time format causes a parsing failure
- Latitude or longitude out of range (-90 to 90 / -180 to 180) returns a constraint violation
- Unknown timezone string causes a timezone resolution error
- Payment failure (x402) prevents execution and returns a payment-required response
- Orb values exceeding 15 degrees are rejected by schema validation

## How this service works

Deterministic Western + Vedic astrology API for AI agents: JPL DE440 ephemeris, no LLM, reproducible SHA-256 hashes.

## Output

Returns a JSON object with a meta block (engine version, ephemeris used, deterministic flag, result SHA-256 hash) and a result containing: a summary with sun sign, moon sign, rising sign, and chart ruler (modern and traditional); ascendant degree; planetary positions for requested points; house cusp degrees; and calculated aspects between planets based on selected orbs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "latitude",
      "longitude"
     ],
     "properties": {
      "date": {
       "type": "string"
      },
      "time": {
       "type": "string"
      },
      "options": {
       "type": "object",
       "properties": {
        "orbs": {
         "type": "object",
         "additionalProperties": {
          "type": "number",
          "maximum": 15,
          "minimum": 0
         }
        },
        "points": {
         "oneOf": [
          {
           "enum": [
            "all"
           ],
           "type": "string"
          },
          {
           "type": "array",
           "items": {
            "enum": [
             "sun",
             "moon",
             "mercury",
             "venus",
             "mars",
             "jupiter",
             "saturn",
             "uranus",
             "neptune",
             "pluto",
             "mean_node",
             "true_node",
             "mean_lilith"
            ],
            "type": "string"
           }
          }
         ]
        },
        "zodiac": {
         "enum": [
          "tropical",
          "sidereal"
         ],
         "type": "string",
         "default": "tropical"
        },
        "aspects": {
         "oneOf": [
          {
           "enum": [
            "all"
           ],
           "type": "string"
          },
          {
           "type": "array",
           "items": {
            "enum": [
             "conjunction",
             "opposition",
             "trine",
             "square",
             "sextile",
             "quincunx",
             "semisextile",
             "semisquare",
             "sesquiquadrate",
             "quintile",
             "biquintile"
            ],
            "type": "string"
           }
          }
         ]
        },
        "ayanamsa": {
         "enum": [
          "fagan_bradley",
          "krishnamurti",
          "lahiri",
          "raman",
          "true_chitrapaksha",
          "yukteshwar"
         ],
         "type": "string",
         "default": "lahiri"
        },
        "house_system": {
         "enum": [
          "alcabitius",
          "campanus",
          "equal",
         
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "engine": "astro-agents/1.0.0",
   "llm_used": false,
   "ephemeris": "NASA/JPL DE440 (1800-01-01..2200-01-01)",
   "deterministic": true,
   "result_sha256": "be1fb244a2d60d64f2996cbccab5d7603af0c17e9127b5cb558c58e72f56adfe"
  },
  "endpoint": "western/natal",
  "result_excerpt": {
   "summary": {
    "sun_sign": "Taurus",
    "moon_sign": "Capricorn",
    "chart_ruler": {
     "modern": "Mercury",
     "traditional": "Mercury"
    },
    "rising_sign": "Virgo"
   },
   "ascendant": "10°14'44\" Virgo"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/astro-agents-western-natal-chart-api-df96e7a4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from astro-agents-api.vercel.app](https://www.zero.xyz/host/astro-agents-api.vercel.app/llms.txt)