predictive

Calculate Sign Ingresses

Calculate planetary sign ingresses (when planets change zodiac signs).

**Features:**
- Sub-minute precision for ingress timing
- Retrograde status detection
- All traditional and modern planets
- Batch processing for multiple planets

**Performance:** <200ms for batch ingress calculations
post/predictive/transits/sign-ingresses

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/predictive/transits/sign-ingresses
  • 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

Request body

end_datestring date-time

Search range end date (default: +1 year)

planet_namesstring[]

Specific planets (validated in route)

start_datestring date-time required

Search range start date

target_sign'Aries' | 'Taurus' | 'Gemini' | 'Cancer' | 'Leo' | 'Virgo' | 'Libra' | 'Scorpio' | 'Sagittarius' | 'Capricorn' | 'Aquarius' | 'Pisces'

Zodiac signs for ingress calculations.

Example request

{
  "end_date": "2025-01-01T00:00:00Z",
  "planet_names": [
    "Mars",
    "Jupiter"
  ],
  "start_date": "2024-01-01T00:00:00Z",
  "target_sign": "Aries"
}

Response

Successful Response

ingressesobject required

Ingresses grouped by planet name

successboolean required

Request success status

total_countinteger required

Total number of ingresses found

Example response

{
  "calculation_metadata": {
    "technique_id": "natal",
    "technique_label": "Composite (Davison)",
    "technique_method": "davidson",
    "technique_version": "v1"
  },
  "metadata": {
    "calculation_metadata": {
      "technique_id": "natal",
      "technique_label": "Composite (Davison)",
      "technique_method": "davidson",
      "technique_version": "v1"
    }
  }
}

Changes

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