ephemeris

Out-of-Bounds Declination Analysis

Analyse ecliptic coordinates to compute equatorial declinations, detect out-of-bounds (OOB) planets, and find declination aspects (parallels and contraparallels).

A planet is out of bounds when its declination exceeds the obliquity of the ecliptic (~23.44°). OOB planets operate outside the Sun's framework and are interpreted as wildcards in contemporary astrology. The Moon is the most frequently OOB body.

Parallels (same declination, same hemisphere) behave like conjunctions; contraparallels (equal but opposite declination) behave like oppositions.

🤖 Agent-first endpoint — pure deterministic math, no ephemeris kernel required.

post/ephemeris/declinations

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/ephemeris/declinations
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Query parameters

formatstring

Response format: json | llm.

output_modestring nullable

Deprecated: use format. Accepts full|simple|llm.

Request body

obliquitynumber double

Obliquity of the ecliptic in degrees. Defaults to J2000 mean obliquity (23.4393°).

parallel_orbnumber double

Orb in degrees for detecting parallels and contraparallels. Default 1.0°.

Response

Successful Response

max_declinationnumber double

Most extreme absolute declination across all bodies.

obliquitynumber double

Obliquity value used for the analysis.

oob_countinteger

Number of bodies that are out of bounds.

successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.