Transits

Calculate current planetary transits and their aspects to a natal chart.

Current Transits

curl -X POST "https://api.astroapi.cloud/api/calc/transits" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "natal": {
      "datetime": "1990-06-15T14:30:00",
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDate": "2024-01-15T12:00:00",
    "transitTimezone": "Europe/London"
  }'

Transit Range

Calculate transits over a date range:

curl -X POST "https://api.astroapi.cloud/api/calc/transits/range" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "natal": {
      "datetime": "1990-06-15T14:30:00",
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "startDate": "2024-01-01",
    "endDate": "2024-01-31",
    "aspects": ["conjunction", "opposition", "trine", "square"]
  }'

Parameters

Parameter	Type	Required	Description
natal	object	Yes	Natal chart data
transitDate	string	Yes*	Transit datetime
startDate	string	Yes*	Range start date
endDate	string	Yes*	Range end date
aspects	array	No	Filter to specific aspects
planets	array	No	Filter to specific transiting planets
orbs	object	No	Custom orb settings

Response

{
  "data": {
    "type": "transits",
    "attributes": {
      "transits": [
        {
          "transitPlanet": "saturn",
          "natalPlanet": "sun",
          "aspect": "conjunction",
          "orb": 1.2,
          "applying": true,
          "exactDate": "2024-01-18T04:30:00Z"
        }
      ]
    }
  }
}

Transit Events

Get exact dates when transits perfect:

curl -X POST "https://api.astroapi.cloud/api/calc/transits/events" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "natal": { ... },
    "startDate": "2024-01-01",
    "endDate": "2024-12-31",
    "transitPlanet": "saturn",
    "natalPlanet": "sun"
  }'