# Astro Agents - Western Aspects Calculator

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

Computes planetary aspects (angular relationships) between celestial bodies for a given date, time, and location using the NASA/JPL DE440 ephemeris with deterministic, reproducible results.

## Facts

- Endpoint: POST https://astro-agents-api.vercel.app/v1/western/aspects?utm_source=zero.xyz
- Price: $0.02/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-aspects-calculator-9129100c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rxCoT5lj31nFYBKu5Dbgf

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-aspects-calculator-9129100c -d '<json body>'
```

Example prompt: What planetary aspects were active at the moment I was born — June 15, 1990 at 3:42 AM in Los Angeles (34.05°N, 118.24°W) — using the tropical zodiac and Placidus houses? Show me all major aspects with their orbs and exactness.

## When to prefer this

Choose this endpoint when you need deterministic, reproducible planetary aspect calculations verifiable by SHA-256 hash, based on the authoritative NASA/JPL DE440 ephemeris rather than approximations or LLM-generated astrology. It supports both tropical and sidereal zodiacs, multiple house systems, and fine-grained orb control, making it ideal for natal chart analysis, synastry, electional astrology, or any use case requiring scientifically grounded, auditable astrological data.

## Known failure modes

- Missing required date/time fields returns a validation error
- Latitude or longitude out of range (-90 to 90 / -180 to 180) causes rejection
- Invalid timezone string causes a parsing error
- Specifying an orb greater than 15 degrees is rejected by the schema
- Date outside the ephemeris range (1800-01-01 to 2200-01-01) may return an error
- Ambiguous local time near DST transitions may produce unexpected results if ambiguous_time is not specified

## How this service works

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

## Output

Returns a list of planetary aspect objects each containing the two celestial points involved (point_a, point_b), the aspect name (e.g. trine, conjunction), the exact angle, the orb in degrees, the allowed orb, and an exactness percentage. Also includes metadata confirming no LLM was used, the ephemeris version, and a SHA-256 hash of the result for reproducibility verification.

## 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": [],
     "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",
          "koch",
          "meridian",
          "
… (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": "d9b6880d14220f7cafea3de8822c09202288b87349b8cd71f67e169591ad39f0"
  },
  "endpoint": "western/aspects",
  "result_excerpt": {
   "aspects": [
    {
     "orb": 0.8,
     "angle": 120,
     "aspect": "trine",
     "point_a": "sun",
     "point_b": "saturn",
     "orb_allowed": 9,
     "exactness_pct": 91.1
    },
    {
     "orb": 2.2,
     "angle": 0,
     "aspect": "conjunction",
     "point_a": "moon",
     "point_b": "saturn",
     "orb_allowed": 10,
     "exactness_pct": 78
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/astro-agents-western-aspects-calculator-9129100c/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)