Sidereal Astrology Houses 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 Sidereal Houses API calculates astrological house systems and chart angles using sidereal zodiac coordinates derived from the selected ayanamsa. In addition to house cusps, this endpoint returns full chart context required for accurate rendering and analysis. All access uses API key authentication.

Endpoint

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

Include Authorization: Bearer <API_KEY>.

Supported House Systems

• placidus (default)
• whole
• equal
• koch (available when enabled)
• campanus (available when enabled)
• porphyry (available when enabled)

Example Request (Sidereal)

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

Example Response

{
  "type": "houses",
  "house_system": "placidus",
  "status": "ok",
  "planets": {
    "Sun": { "lon": 336.85, "sign": "Pisces" },
    "Moon": { "lon": 338.32, "sign": "Pisces" }
  },
  "houses": {
    "ascendant": 71.21,
    "mc": 185.49,
    "systems": {
      "whole_sign": {
        "name": "Whole sign",
        "houses": { "1": 330, "2": 0 }
      },
      "equal": {
        "name": "Equal",
        "houses": { "1": 71.21, "2": 101.21 }
      },
      "placidus": {
        "name": "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"
  },
  "input": {
    "date": "1990-01-01",
    "time": "12:00",
    "lat": 40.7128,
    "lon": -74.0060,
    "zodiac": "sidereal",
    "ayanamsa": "lahiri"
  }
}

Quick Test / curl

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

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

Common Uses

• Sidereal chart wheel rendering
• House-based analytics
• Synastry overlays
• Coordinate-system comparison
• Advanced astrology dashboards

This API provides raw calculation data only; interpretation, scoring, and compatibility logic are handled client-side.

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

# Python — Sidereal Houses API
import requests

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

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