# Orrery Astrology Interpretation API

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

Computes an astrological chart interpretation for a given birth date, time, and location, returning planetary positions, house placements, and framework-based readings.

## Facts

- Endpoint: POST https://paradox-box-production.up.railway.app/v1/interpret
- Price: $0.3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orrery-astrology-interpretation-api-db2cddce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_T3cP-86cMbxejEVCeV5XO

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-interpretation-api-db2cddce -d '<json body>'
```

Example prompt: Can you generate an astrological chart interpretation 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 a programmatic, machine-readable astrological chart interpretation given a birth date, time, and location. It is particularly suited for AI agent pipelines that need structured astrology data rather than a human-formatted horoscope. Prefer it over generic astrology APIs when you want framework-based spread interpretations and reliable geocoding from place names.

## Known failure modes

- Invalid or unrecognizable place name causes geocoding failure
- Malformed date-time string causes parsing error
- Unknown framework ID returns error or falls back to default
- Missing required fields (when or where) returns 422 validation error
- Payment not included or insufficient returns 402 Payment Required
- Ambiguous location string may resolve to wrong coordinates

## How this service works

Astrology for robots.

## Output

Returns a structured astrological interpretation object containing planetary positions, house cusps, aspects, and framework-specific readings (e.g. four-way spread). When birth time is unknown, house and angle data are flagged as unreliable. The response is machine-readable JSON with additionalProperties allowed for framework-specific extensions.

## 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 Interpret Route V1 Interpret Post",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orrery-astrology-interpretation-api-db2cddce/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)