predictive

Calculate Planetary Transit to Degree

Calculate when a planet transits to a specific longitude degree.

**Features:**
- Sub-minute precision for transit timing
- Retrograde motion handling with multiple crossings
- Duration calculations (approach and separation)
- All traditional and modern planets supported

**Performance:** <50ms for single transit calculations
post/predictive/transits/planet-to-degree

Request

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

max_crossingsinteger

Maximum crossings to find (for retrograde)

planet_namestring required

Planet name (validated in route)

start_datestring date-time required

Starting date for search

target_degreenumber required

Target longitude degree (0-360)

Example request

{
  "max_crossings": 3,
  "planet_name": "Mars",
  "start_date": "2024-01-01T00:00:00Z",
  "target_degree": 15.5
}

Response

Successful Response

successboolean required

Request success status

total_countinteger required

Number of transits 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.