# Western Natal Astrology Chart API

> Western Natal Astrology Chart API is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns tropical planet placements by sign/degree, retrograde flags, Whole-Sign houses, Ascendant, Midheaven, and major Ptolemaic aspects for a birth date and optional time/place.

## Facts

- Endpoint: GET https://api.agentstools.dev/personality/western
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/western-natal-astrology-chart-api-6a42234e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x6xo3c-c61qoYcWZ2iX_y

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 western-natal-astrology-chart-api-6a42234e
```

Example prompt: Can you calculate my western natal chart? I was born on May 15, 1990 at 7:30 AM in New York, USA — I need my planet signs and degrees, retrograde flags, Whole-Sign houses, my Ascendant and Midheaven, and the major aspects, using the America/New_York timezone.

## When to prefer this

Use this endpoint when you need only western tropical natal astrology (planet signs/degrees, Whole-Sign houses, Ascendant, Midheaven, Ptolemaic aspects) without Vedic or Chinese systems — it is cheaper and simpler than the multi-framework sibling endpoint. Prefer it for birth chart lookups, rising sign detection, retrograde identification, and aspect analysis using classical Western methods. It requires no API key and is fully deterministic.

## Known failure modes

- Missing required 'date' parameter returns a 400 error
- Unrecognizable birth place text fails geocoding and returns an error
- Providing time without place or coordinates returns angles as unavailable
- Invalid date format (not YYYY-MM-DD) causes a parsing error
- Unknown IANA timezone name causes a tz resolution error
- Ambiguous place names may resolve to an incorrect location

## How this service works

Western natal astrology only: tropical planet placements by sign and degree with retrograde flags, Whole-Sign houses, the Ascendant and Midheaven angles and the major Ptolemaic aspects. Give a birth date, and for the angles a time, place and tz or utc_offset. Deterministic ephemeris, no LLM, no keys.

## Output

A JSON object containing tropical planet placements (sign, degree, retrograde flag) for all major planets, Whole-Sign house assignments, Ascendant and Midheaven angles, and major Ptolemaic aspects (conjunction, sextile, square, trine, opposition) — all computed deterministically from Swiss Ephemeris or equivalent, with no AI fabrication.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "date"
     ],
     "properties": {
      "tz": {
       "type": "string",
       "description": "IANA timezone name for the birth time, such as America/New_York. Used to place the local time in UT. Alternatively pass utc_offset."
      },
      "lat": {
       "type": "number",
       "description": "Birth latitude in degrees, north positive."
      },
      "lon": {
       "type": "number",
       "description": "Birth longitude in degrees, east positive."
      },
      "date": {
       "type": "string",
       "description": "Birth date in YYYY-MM-DD format, such as 1990-05-15."
      },
      "time": {
       "type": "string",
       "description": "Birth time in HH:MM 24-hour local clock time. Optional; without it a no-time chart is returned and houses, the Ascendant and the exact Moon degree are flagged unavailable rather than fabricated."
      },
      "place": {
       "type": "string",
       "description": "Birth place as free text, such as New York, USA. Geocoded to coordinates. Alternatively pass explicit lat and lon."
      },
      "utc_offset": {
       "type": "number",
       "description": "UT offset of the birth time in hours, such as -4 or 3."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/western-natal-astrology-chart-api-6a42234e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)