# Astro Agents - Western Transits API

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

Calculates planetary transit aspects to a natal chart over a specified time window using NASA/JPL DE440 ephemeris, returning exact aspect hits with UTC timestamps.

## Facts

- Endpoint: POST https://astro-agents-api.vercel.app/v1/western/transits?utm_source=zero.xyz
- Price: $0.08/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-transits-api-6018535a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m0RH8sK4kHsdWoGzlKw0T

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-transits-api-6018535a -d '<json body>'
```

Example prompt: Look up all major planetary transits hitting my natal chart between January 1 and December 31 2026 — my birth location is 40.7128° N, 74.0060° W, born on March 15 1990 at 10:30 AM civil time in America/New_York timezone, using the Placidus house system and tropical zodiac, including conjunctions, oppositions, trines, and squares.

## When to prefer this

Choose this endpoint when you need deterministic, reproducible planetary transit calculations grounded in the NASA/JPL DE440 ephemeris rather than LLM-generated or approximated astrology. Ideal when you require exact UTC timestamps for transit hits, verifiable SHA-256 hashes for audit trails, support for both tropical and sidereal zodiacs, multiple house systems, and fine-grained orb control. Prefer this over generic astrology chatbots or LLM-based astrological interpretation when precision and reproducibility matter.

## Known failure modes

- Missing required natal latitude or longitude returns validation error
- Invalid datetime format causes parsing failure
- Window start date after end date returns empty or error response
- Requested ayanamsa not in allowed enum returns schema validation error
- Orb values outside 0-15 degree range rejected
- Unsupported aspect type in array returns validation error
- Very long time windows may return large payloads
- Payment not included or insufficient USDC returns 402 error

## 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 containing a list of transit aspect hits within the requested window, each with the aspect type (e.g. square, trine), exact UTC datetime, the natal point being aspected, the transiting planet, and whether the transit planet is retrograde. Also includes a total count, engine metadata, ephemeris version, a deterministic flag, and a SHA-256 hash for result 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": [
      "natal"
     ],
     "properties": {
      "natal": {
       "type": "object",
       "required": [
        "latitude",
        "longitude"
       ],
       "properties": {
        "date": {
         "type": "string"
        },
        "time": {
         "type": "string"
        },
        "datetime": {
         "type": "string"
        },
        "latitude": {
         "type": "number",
         "maximum": 90,
         "minimum": -90
        },
        "timezone": {
         "type": "string"
        },
        "longitude": {
         "type": "number",
         "maximum": 180,
         "minimum": -180
        },
        "time_basis": {
         "enum": [
          "civil",
          "utc",
          "lmt",
          "true_solar"
         ],
         "type": "string",
         "default": "civil"
        },
        "ambiguous_time": {
         "enum": [
          "earlier",
          "later"
         ],
         "type": "string",
         "default": "earlier"
        }
       }
      },
      "window": {
       "type": "object",
       "properties": {
        "end": {
         "type": "string"
        },
        "start": {
         "type": "string"
        },
        "include_moon": {
         "type": "boolean"
        }
       }
      },
      "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": [
          "tropic
… (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": "7e7a7b2568e4629efff09bbaa2b3757bb2da232061273d5aa32beb896236d9f0"
  },
  "endpoint": "western/transits",
  "result_excerpt": {
   "window": {
    "hits": [
     {
      "aspect": "square",
      "exact_utc": "2026-10-02T08:49Z",
      "natal_point": "uranus",
      "transit_point": "sun",
      "transit_retrograde": false
     },
     {
      "aspect": "square",
      "exact_utc": "2026-10-02T17:40Z",
      "natal_point": "jupiter",
      "transit_point": "sun",
      "transit_retrograde": false
     }
    ],
    "count": 95
   }
  }
 }
}
```

## More

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