# Astro Agents – Western Aspects Calculator

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

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

## Facts

- Endpoint: POST https://astro-agent.dev/v1/western/aspects?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/astro-agents-western-aspects-calculator-0a364887
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FuRyDo3yvhRI22c0uTpvB

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-0a364887 -d '<json body>'
```

Example prompt: What planetary aspects are active for someone born on March 15, 1990 at 3:45pm in New York City (40.71° N, 74.01° W, America/New_York timezone)? Use tropical zodiac and Placidus houses, and include all major aspects.

## When to prefer this

Choose this endpoint when you need deterministic, reproducible planetary aspect calculations grounded in the authoritative NASA/JPL DE440 ephemeris — especially when you need verifiable outputs (SHA-256 hash), support for both Western tropical and Vedic sidereal systems, flexible house systems, custom orbs, and guaranteed no-LLM computation. Prefer it over generative or LLM-based astrology services when accuracy and reproducibility matter, or when building astrology apps that need consistent, auditable results.

## Known failure modes

- Missing required date/time fields returns validation error
- Latitude or longitude out of valid range (-90 to 90 / -180 to 180) returns schema error
- Invalid timezone string causes parsing failure
- Date outside ephemeris range (1800–2200) may return out-of-range error
- Conflicting datetime fields (both 'datetime' and separate 'date'+'time') may cause ambiguity error
- Invalid celestial point name in 'points' array returns enum validation error
- Orb value exceeding maximum of 15 degrees rejected by schema

## How this service works

Aspects: Aspects (with orb, exactness, applying/separating) for a moment, or for any longitudes you supply.

## Output

Returns a list of detected aspects between celestial bodies including the aspect name (e.g. trine, conjunction), the two points involved, the exact angular distance, orb used, allowed orb, and exactness percentage. Also includes engine metadata, ephemeris version, determinism flag, 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.3",
   "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-0a364887/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)