electional

Relocated Natal Angle Crossing Search

Find the moments a transiting body is on a relocated natal angle (AC, DC, MC, or IC) at a geographic point P — "when is this body on MY relocated angle here". A relocated natal angle is a fixed zodiacal (ecliptic-longitude) degree, computed once from the natal instant at P via the same house calculation POST /ephemeris/relocation uses — not a horizon circle that sweeps with time, which is what GET /electional/angle-crossings answers for a bare geographic point instead.

Each result is an orb window: enter (body enters orb_deg of the angle), exact (the crossing moment), and leave (body exits orb_deg). A retrograde triple pass over the same angle produces three separate windows, one per pass, each with its own enter/exact/leave/retrograde — never a single window with multiple exacts. Ranges are capped at 366 days and are rejected rather than silently truncated.

Pricing (by requested span, decided before any compute): up to 1 month (31 days) = 5, up to 3 months (92 days) = 8, up to 6 months (183 days) = 10, up to 1 year (366 days) = 12 credits. The 366-day range limit applies on every plan. A span above your plan's limit is rejected with 400 search_span_limit naming the limit and the bracket that fits — nothing is charged. Any 4xx/5xx outcome is refunded, including a 429 compute_overload shed; rate-limit 429s are refused before anything is charged. Results are capped by max_results (reported as truncated in the summary).

post/electional/natal-angle-crossings

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/electional/natal-angle-crossings
  • 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

Output format: json (default) or llm.

Request body

anglesstring

Comma-separated angles: AC, DC, MC, IC. ASC/DSC are accepted as aliases. Defaults to all four. Vertex is not a valid value here.

bodiesstring

Comma-separated body names. Defaults to the classical seven (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn). Same vocabulary and aliases as GET /electional/angle-crossings.

endstring required

End of the search range, same datetime rules as start. A range over 366 days is rejected (400 search_span_limit for metered callers, 422 otherwise) rather than silently clamped.

house_system'P' | 'K' | 'O' | 'R' | 'C' | 'E' | 'W'

Supported house systems.

max_resultsinteger

Maximum number of windows to return.

orb_degnumber double

Orb, in degrees, used to compute each window's enter/leave bounds around the exact crossing. Defaults to 1.0.

relocation_latnumber

Query point P latitude in decimal degrees (positive north). Required — omitting it is rejected, never defaulted to 0.

relocation_lonnumber

Query point P longitude in decimal degrees (positive east). Required — omitting it is rejected, never defaulted to 0.

startstring required

Start of the search range. ISO 8601 zoned datetime; a naive clock time is rejected rather than guessed at, and a bare date resolves to 12:00 UTC. Required — there is no sensible default window for a natal-specific search.

Example request

{
  "natal": {
    "configuration": {
      "coordinate_system": "geocentric",
      "house_system": "P",
      "object_set": "modern_plus_chiron",
      "zodiac_type": "tropical"
    },
    "options": {
      "include_aspects": true
    },
    "subject": {
      "birth_datetime": {
        "iso": "1990-06-15T14:30:00"
      },
      "birth_location": {
        "latitude": {
          "decimal": 40.7128
        },
        "longitude": {
          "decimal": -74.006
        },
        "timezone": {
          "iana_name": "America/New_York"
        }
      },
      "name": "John Doe"
    }
  }
}

Response

Chronological relocated-natal-angle crossing windows

search_summaryobject required

Echo of the resolved search plus provenance. calculation_mode is "Zodiacal (Relocated Natal Angles)" — the relocated angle is a fixed ecliptic-longitude degree for the whole search, distinct from GET /electional/angle-crossings' in-mundo geometry; the two calculation_mode strings never collide. When truncated is true the window list is NOT a complete chronological slice of the range — truncated_at_body, truncated_at_angle and omitted_bodies name what was left unsearched.

Changes

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