# Astro Agents Western Natal Chart API

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

Computes a deterministic Western astrology natal chart (planets, houses, aspects, rising sign) from birth coordinates using NASA/JPL DE440 ephemeris — no LLM involved.

## Facts

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

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-9f91a940 -d '<json body>'
```

Example prompt: Calculate my Western natal chart using Placidus houses for someone born on April 28, 1990 at 3:45 PM civil time in New York City (latitude 40.7128, longitude -74.0060, timezone America/New_York) — I want to know their sun sign, moon sign, rising sign, and all major aspects.

## When to prefer this

Choose this endpoint when you need reproducible, auditable astrology computations with no probabilistic AI output — the SHA-256 hash guarantees the same inputs always yield the same chart. Ideal for building astrology apps, verifying chart consistency, or feeding structured planetary data into downstream analysis without LLM hallucination risk. Prefer over LLM-based astrology tools when precision, determinism, and the NASA/JPL DE440 ephemeris are required.

## Known failure modes

- Missing required latitude or longitude returns a validation error
- Invalid date/time format causes a parsing failure
- Timezone string not recognized results in an error
- Datetime outside ephemeris range (1800–2200) returns an out-of-range error
- Orb values exceeding 15 degrees are rejected by schema validation
- Payment not included or insufficient USDC triggers a 402 Payment Required response

## How this service works

Western natal chart: Complete natal chart: planets in signs and houses, ascendant, MC, 11 house systems, aspects, summary.

## Output

Returns a JSON object containing: a meta block (engine version, ephemeris used, determinism flag, SHA-256 hash of the result), a summary (sun sign, moon sign, rising sign, chart ruler in modern and traditional), the ascendant degree, planetary positions, house cusps, and computed aspects between points — all derived without any LLM inference.

## 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.3",
   "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-9f91a940/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from astro-agent.dev](https://www.zero.xyz/host/astro-agent.dev/llms.txt)