# Orrery Electional Astrology API

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

Finds astrologically auspicious time windows within a date range and location, scored and ranked by intent type.

## Facts

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

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-electional-astrology-api-b4fab9ab -d '<json body>'
```

Example prompt: Can you find the top 3 most astrologically auspicious time windows for a product launch in San Francisco between September 11 and September 25, 2026, weighted for a launch intent?

## When to prefer this

Choose this endpoint when you need programmatic electional astrology — finding the most auspicious moment within a date range for a specific location and purpose. It is uniquely suited for scheduling workflows that want to factor in astrological timing signals, and is the only known API-based electional astrology scorer that accepts intent weighting. Prefer it over generic calendar or scheduling APIs when the user explicitly wants astrological guidance on timing.

## Known failure modes

- Missing required fields (start, end, where) returns a validation error
- Unrecognizable place name may fail geocoding and return an error
- Very short step_hours over a long date range may time out or return slowly
- Invalid date format causes a 422 unprocessable entity error
- top_n not specified defaults to a system default number of results
- Intent value not matching enum options may be ignored or cause an error

## How this service works

Astrology for robots.

## Output

Returns a ranked list of the top N astrologically scored time windows within the specified date range and location. Each window includes the timing and an astrological score weighted by the specified intent (commerce, legal, travel, etc.), ordered best-first.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "end",
  "start",
  "where"
 ],
 "properties": {
  "end": {
   "type": "string",
   "description": "End of the search range, e.g. '2026-09-25'."
  },
  "start": {
   "type": "string",
   "description": "Start of the search range, e.g. '2026-09-11'."
  },
  "top_n": {
   "type": "integer",
   "description": "How many windows to return, best first."
  },
  "where": {
   "type": "string",
   "description": "Place name to geocode, or [latitude, longitude]."
  },
  "intent": {
   "type": "string",
   "description": "What the action is for. Weights the scoring toward factors that bear on the intent. Options: commerce, communication, creative, general, launch, legal, travel"
  },
  "step_hours": {
   "type": "number",
   "description": "Hours between scored moments. Smaller is finer but slower."
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

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