Sidereal Astrology Aspects 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.

Calculate angular relationships between planets using sidereal zodiac coordinates. Aspect geometry is invariant; only the underlying planetary longitudes are adjusted using the selected ayanamsa.

Endpoint

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

Include Authorization: Bearer <API_KEY>.

Example Request (Sidereal)

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

Example Response

{
  "type": "aspects",
  "input": {
    "birth": {
      "date": "1990-01-01",
      "time": "12:00",
      "lat": 40.7128,
      "lon": -74.0060
    },
    "zodiac": "sidereal",
    "ayanamsa": "lahiri"
  },
  "aspects": {
    "planets": {
      "Sun": { "lon": 336.85, "sign": "Pisces" },
      "Moon": { "lon": 338.32, "sign": "Pisces" }
    },
    "houses": {
      "ascendant": 71.21,
      "mc": 185.49,
      "systems": {
        "whole_sign": { "houses": { "1": 330, "2": 0 } },
        "placidus": { "houses": { "1": 71.21, "2": 109.44 } }
      }
    },
    "aspects": [
      { "p1": "Sun", "p2": "Moon", "type": "conjunction", "distance": 1.47, "orb": 1.47 }
    ],
    "nodes": { "mean": { "sign": "Gemini", "deg_in_sign": 5.12 } },
    "metadata": { "note": "Sidereal coordinates using Lahiri ayanamsa; DE421 ephemeris" }
  }
}

Quick Test / curl

Use this curl command to quickly test the Sidereal Aspects API endpoint:

curl -i https://api.astroapi.io/api/astro/aspects \
  -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
    },
    "zodiac": "sidereal",
    "ayanamsa": "lahiri"
  }'

Common Uses

• Sidereal natal chart analysis
• Aspect geometry visualization
• Comparative astrology research
• Coordinate-system experimentation

This API does not perform interpretation, scoring, or compatibility analysis. Aspect meaning and interpretation are the responsibility of the client application.

// JavaScript — Sidereal Aspects API
fetch("https://api.astroapi.io/api/astro/aspects", {
  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
    },
    zodiac: "sidereal",
    ayanamsa: "lahiri"
  })
})
  .then(res => res.json())
  .then(data => console.log(data));

# Python — Sidereal Aspects API
import requests

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

payload = {
  "birth": {
    "date": "1990-01-01",
    "time": "12:00",
    "lat": 40.7128,
    "lon": -74.0060
  },
  "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())