# Astro Agents Western Transits API

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

Calculates precise Western astrology transit hits for a natal chart over a specified time window using JPL DE440 ephemeris

## Facts

- Endpoint: POST https://astro-agent.dev/v1/western/transits?utm_source=zero.xyz
- Price: $0.08/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-transits-api-20b2f220
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OKWOp4q-c7X5qe22LyQbz

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-20b2f220 -d '<json body>'
```

Example prompt: What planetary transits will hit my natal chart between January 1 and December 31 2026? I was born on March 15 1985 at 2:30pm civil time in New York City (latitude 40.7128, longitude -74.0060). Show me conjunctions, squares, and oppositions to all natal planets using the Placidus house system and tropical zodiac.

## When to prefer this

Choose this endpoint when you need deterministic, reproducible Western astrology transit calculations backed by the NASA/JPL DE440 ephemeris rather than LLM-generated or approximated astrology output. Ideal when you need exact UTC timing of planetary aspect perfections, SHA-256 verifiable results, support for multiple house systems (Placidus, Whole Sign, Koch, etc.), tropical or sidereal zodiac options, and fine-grained control over aspect types and orbs. Prefer this over general astrology chatbots when accuracy, auditability, and reproducibility are required.

## Known failure modes

- Missing required natal latitude or longitude returns validation error
- Invalid datetime format causes parsing failure
- Requesting a transit window outside the ephemeris range 1800–2200 returns out-of-range error
- Unsupported aspect or point enum value causes schema validation failure
- Ambiguous local time without timezone or time_basis specified may produce incorrect results
- Payment not included or insufficient USDC causes 402 payment required response

## How this service works

Transits: Transits to a natal chart at a moment, and exact hit times over a window of up to a year.

## Output

Returns a list of transit hits within the requested time window, each containing the natal point affected, the transiting planet, the aspect type (e.g. conjunction, square), the exact UTC datetime of the transit's perfection, and whether the transiting planet is retrograde. Also includes a total count of hits and a SHA-256 hash of the result for reproducibility verification, plus ephemeris and engine metadata.

## 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.3",
   "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-20b2f220/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)