Sidereal Astrology Transits API

AstroAPI uses Western (tropical), geocentric astrology by default. Sidereal calculations are applied only when explicitly enabled using "zodiac": "sidereal" and an ayanamsa selection. This endpoint provides sidereal coordinate transforms only and does not implement full Vedic astrology systems.

The Transits API calculates planetary positions for a specified date using sidereal zodiac coordinates and compares them to a natal chart. Designed for passive, server-to-server usage using API key authentication.

Endpoint

POST https://api.astroapi.io/api/astro/transits

Include Authorization: Bearer <API_KEY>.

Required Request Fields

• birth.date — ISO date (YYYY-MM-DD)
• birth.time — 24-hour time (HH:MM)
• birth.lat — latitude (decimal)
• birth.lon — longitude (decimal)
• transitDate — ISO date (YYYY-MM-DD)

How Transits Work

Planetary positions are calculated for the requested transit date using sidereal longitudes derived from the selected ayanamsa and returned alongside full chart context, including house systems, aspects, lunar nodes, and metadata.

Example Request (Sidereal)

{
  "birth": {
    "date": "1990-01-01",
    "time": "12:00",
    "lat": 40.7128,
    "lon": -74.0060
  },
  "transitDate": "2025-01-01",
  "zodiac": "sidereal",
  "ayanamsa": "lahiri"
}

Example Response

{
  "type": "transits",
  "input": {
    "birth": {
      "date": "1990-01-01",
      "time": "12:00",
      "lat": 40.7128,
      "lon": -74.006
    },
    "transitDate": "2025-01-01",
    "zodiac": "sidereal",
    "ayanamsa": "lahiri"
  },
  "transits": {
    "status": "ok",
    "planets": {
      "Sun": { "lon": 336.85, "sign": "Pisces" },
      "Moon": { "lon": 338.32, "sign": "Pisces" }
    },
    "houses": {
      "ascendant": 71.21,
      "mc": 185.49,
      "systems": {
        "placidus": {
          "houses": {
            "1": 71.21,
            "2": 109.44,
            "3": 152.65,
            "4": 5.49,
            "5": 28.53,
            "6": 60.81,
            "7": 251.21,
            "8": 289.44,
            "9": 332.65,
            "10": 185.49,
            "11": 208.53,
            "12": 240.81
          }
        }
      }
    },
    "aspects": [],
    "nodes": {},
    "metadata": {
      "note": "Sidereal coordinates using Lahiri ayanamsa; DE421 ephemeris"
    }
  }
}

Quick Test / curl

Use this curl command to quickly test the Sidereal Transits API endpoint with your API key:

curl -i https://api.astroapi.io/api/astro/transits \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -d '{
    "birth": {
      "date": "2000-01-01",
      "time": "12:00",
      "lat": 33.7488,
      "lon": -84.3877
    },
    "transitDate": "2025-12-30",
    "zodiac": "sidereal",
    "ayanamsa": "lahiri"
  }'

Common Uses

• Sidereal timing and forecasting
• Transit-based research tools
• Coordinate-system comparison
• Advanced astrology dashboards

Interpretation, scoring, and predictive analytics are handled client-side. This API provides raw sidereal transit calculation data only.

// JavaScript — Sidereal Transits API
fetch("https://api.astroapi.io/api/astro/transits", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    birth: {
      date: "1990-01-01",
      time: "12:00",
      lat: 40.7128,
      lon: -74.0060
    },
    transitDate: "2025-01-01",
    zodiac: "sidereal",
    ayanamsa: "lahiri"
  })
})
  .then(res => res.json())
  .then(data => console.log(data));

# Python — Sidereal Transits API
import requests

url = "https://api.astroapi.io/api/astro/transits"

payload = {
  "birth": {
    "date": "1990-01-01",
    "time": "12:00",
    "lat": 40.7128,
    "lon": -74.0060
  },
  "transitDate": "2025-01-01",
  "zodiac": "sidereal",
  "ayanamsa": "lahiri"
}

headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())