# Orrery Astrology API

> Orrery Astrology API is a paid API for AI agents from paradox-box-production.up.railway.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Computes an astrological chart (natal/preview spread) for a given birth or event date/time and location, returning planetary positions, houses, and framework-specific interpretations.

## Facts

- Endpoint: POST https://paradox-box-production.up.railway.app/v1/preview
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orrery-astrology-api-20d188de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WqAIuea2LGVwyDTwmpkp9

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 orrery-astrology-api-20d188de -d '<json body>'
```

Example prompt: Can you calculate an astrological chart for someone born on June 14, 1988 at 3:22 AM in Chicago, Illinois using the standard four-way spread?

## When to prefer this

Choose this endpoint when you need programmatic, machine-readable astrological chart data (planetary positions, houses, angles) for a specific date/time and location — especially when integrating astrology into an AI pipeline, personalization feature, or automated report. Prefer this over generic astronomy APIs when astrological frameworks and interpretations (not just raw ephemeris data) are needed.

## Known failure modes

- Missing required fields 'when' or 'where' returns a validation error
- Unrecognizable place name that cannot be geocoded returns a geocoding failure
- Invalid datetime format for 'when' returns a parse error
- Unknown framework ID returns an error or falls back to default spread
- Payment not received (x402) results in 402 Payment Required response

## How this service works

Astrology for robots.

## Output

Returns a JSON object containing the astrological chart data for the requested date, time, and location — including planetary positions, house cusps, angles, and interpretations according to the selected framework(s). When birth time is unknown, houses and angles are flagged as unreliable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "when",
  "where"
 ],
 "properties": {
  "when": {
   "type": "string",
   "description": "Local date and time, e.g. '1988-06-14 03:22'."
  },
  "where": {
   "type": "string",
   "description": "Place name to geocode, or [latitude, longitude] to skip geocoding."
  },
  "frameworks": {
   "type": "string",
   "description": "Preset framework ids. Defaults to the standard four way spread. See GET /v1/systems for the full list."
  },
  "time_unknown": {
   "type": "boolean",
   "description": "Set when the birth time is not known. Houses and angles are then unreliable and are reported as such."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "Response Preview V1 Preview Post",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orrery-astrology-api-20d188de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from paradox-box-production.up.railway.app](https://www.zero.xyz/host/paradox-box-production.up.railway.app/llms.txt)