comparative

Calculate Natal Transits

Calculate a synastry-style overlay between a natal chart and transits.

  • Chart A: natal subject at birth
  • Chart B: the same subject/location at transit_datetime (defaults to now UTC)
post/comparative/natal-transits

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/comparative/natal-transits
  • 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

Request body

include_visualboolean

If true, a full visual SVG or PNG output will be rendered and returned alongside the chart data. Note: Visuals incur a +2 credit surcharge.

Example request

{
  "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": "Alice"
  },
  "transit_datetime": {
    "iso": "2025-01-01T00:00:00Z"
  }
}

Response

Successful Response

Changes

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