# Astro Agents - Western Astrology Positions

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

Computes Western astrology planetary positions, house placements, and aspects for a given date, time, and location using NASA/JPL DE440 ephemeris with reproducible SHA-256 results.

## Facts

- Endpoint: POST https://astro-agents-api.vercel.app/v1/western/positions?utm_source=zero.xyz
- Price: $0.01/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-astrology-positions-3b967e87
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PtmkeWoxzUnyVlVWyxHNW

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-astrology-positions-3b967e87 -d '<json body>'
```

Example prompt: Calculate the Western astrology planetary positions for October 1, 1990 at 8:30am civil time in New York City (40.7128° N, 74.0060° W, America/New_York timezone) using the Placidus house system and tropical zodiac — give me all planets including the moon and their retrograde status.

## When to prefer this

Choose this endpoint when you need deterministic, reproducible Western astrology planetary positions backed by the NASA/JPL DE440 ephemeris rather than LLM-generated or approximated astrological data. Ideal when result integrity is important (e.g. auditable birth charts, automated astrological pipelines) and when you need support for multiple house systems, tropical or sidereal zodiac, and configurable aspect orbs.

## Known failure modes

- Missing required date or location fields returns a validation error
- Coordinates outside valid range (-90 to 90 lat, -180 to 180 lon) return a schema error
- Unrecognized timezone string causes parsing failure
- Date outside ephemeris range (before 1800 or after 2200) returns an out-of-range error
- Invalid enum value for house_system, zodiac, or ayanamsa returns a validation error
- Ambiguous local time (DST transitions) handled by ambiguous_time field; omitting it defaults to 'earlier'

## 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 the endpoint name, metadata (engine version, ephemeris source, deterministic flag, SHA-256 result hash), and an array of planetary positions each with the point name, formatted zodiac position (degree/minute/second and sign), retrograde status, and longitude speed. Also includes house cusps and aspect data when requested.

## 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": "269109e17efc86d60897373ac8244ecff90f9c71f9dd1836d848fddba92fcae1"
  },
  "endpoint": "western/positions",
  "result_excerpt": {
   "points": [
    {
     "point": "sun",
     "position": "8°19'49\" Libra",
     "retrograde": false,
     "speed_longitude": 0.982927
    },
    {
     "point": "moon",
     "position": "11°02'54\" Gemini",
     "retrograde": false,
     "speed_longitude": 14.283559
    }
   ]
  }
 }
}
```

## More

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