Sidereal Astrology API Documentation

Optional sidereal coordinate system support for AstroAPI.

AstroAPI supports sidereal astrology as an explicit opt-in mode. When enabled, planetary longitudes are adjusted using an ayanamsa offset. Western (tropical) astrology remains the default behavior for all endpoints.

Sidereal mode provides coordinate transforms only. It does not implement full Vedic astrology systems or Panchanga logic.

Sidereal Mode: Capabilities & Limitations

What Sidereal Mode CAN Do

• Convert tropical planetary longitudes to sidereal using ayanamsa offsets
• Support explicit opt-in via "zodiac": "sidereal"
• Apply Lahiri ayanamsa for sidereal longitude calculations
• Generate sidereal planetary positions using JPL DE421 ephemeris data
• Calculate sidereal birth charts, aspects, houses, transits, and synastry
• Compute Moon Nakshatra and pada from sidereal longitude
• Preserve deterministic, interpretation-free calculation output
• Return raw data suitable for research, analytics, and custom logic

What Sidereal Mode CANNOT Do

• Does not implement full Vedic astrology systems
• No Panchanga, tithi, yoga, karana, or muhurta calculations
• No Vedic sunrise/sunset day-boundary rules
• No dashas, yogas, or predictive timing frameworks
• No interpretive or religious astrology logic
• No regional or tradition-specific calendar alignment
• Does not attempt to match every third-party Vedic API output

Differences between AstroAPI sidereal results and Vedic-only astrology platforms are expected. Those systems often embed additional cultural, calendrical, or interpretive rules that AstroAPI intentionally does not apply.

• 🔐 Authentication

  API keys are used for API access. JWTs are used for dashboard login only.

• 🌙 Sidereal Birth Chart API

  Generate natal charts using sidereal planetary positions with ayanamsa offsets. Moon nakshatras included.

• 🪐 Sidereal Transits API

  Calculate planetary transits using sidereal longitudes. Aspect geometry remains invariant.

• ✨ Sidereal Aspects API

  Aspect calculations using sidereal positions. Angular relationships are unchanged.

• 🏠 Sidereal Houses API

  House systems computed using sidereal zodiac offsets. No Panchanga day logic applied.

• 💞 Sidereal Synastry API

  Relationship comparison using sidereal planetary coordinates for both charts.

All sidereal endpoints require "zodiac": "sidereal" to be explicitly specified in the request body.

// JavaScript — Sidereal Birth Chart Example
fetch("https://api.astroapi.io/api/astro/birth-chart", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    date: "2000-01-01",
    time: "12:00",
    lat: 0.0,
    lon: 0.0,
    zodiac: "sidereal",
    ayanamsa: "lahiri"
  })
})
  .then(res => res.json())
  .then(data => console.log(data));

# Python — Sidereal Birth Chart Example
import requests

url = "https://api.astroapi.io/api/astro/birth-chart"

payload = {
    "date": "2000-01-01",
    "time": "12:00",
    "lat": 0.0,
    "lon": 0.0,
    "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())