Astrology Houses API (Placidus & Whole Sign)

The Houses API calculates all 12 astrological house cusps and chart angles using a selected house system. Houses divide the birth chart into thematic life areas such as identity, finances, relationships, work, and purpose. Different house systems shift the boundaries of each house, offering alternate interpretive frameworks.

Houses API Endpoint

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

Supported Astrology House Systems

AstroAPI supports widely used traditional and modern house systems:

• placidus — default, globally popular
• whole — whole-sign houses
• koch — time-based system
• equal — equal 30° houses
• campanus — spatial division
• porphyry — quadrant-based division

Houses API Request Body

Field	Type	Required	Description
date	string	Yes	Birth date (YYYY-MM-DD).
time	string	Yes	Birth time (HH:MM, 24-hour).
lat	number	Yes	Latitude in decimal degrees.
lon	number	Yes	Longitude in decimal degrees.
tz	string	Yes	Timezone (e.g. America/New_York).
house_system	string	No	Selected house system (default: placidus).

Example Houses API Response

{
  "house_system": "placidus",
  "houses": {
    "1": 212.9,
    "2": 240.3,
    "3": 267.0,
    "4": 295.7,
    "5": 323.5,
    "6": 351.8,
    "7": 23.4,
    "8": 50.7,
    "9": 78.2,
    "10": 106.4,
    "11": 134.1,
    "12": 162.0
  },
  "ascendant": 212.9,
  "midheaven": 106.4
}

Common Uses for House Data

• Full chart rendering with 12-house wheels
• Natal interpretations and AI readings
• Synastry and house overlays
• Career, relationship, and life-theme analysis
• Life-area focus UI widgets
• Yearly and long-term theme dashboards

AstroAPI delivers precise, astronomy-backed house calculations. You control interpretation, design, and presentation.

// JavaScript — Houses API Example
fetch("https://api.astroapi.io/v1/houses", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    date: "1995-11-08",
    time: "14:22",
    lat: 34.05,
    lon: -118.24,
    tz: "America/Los_Angeles",
    house_system: "placidus"
  })
})
  .then(res => res.json())
  .then(data => console.log("Houses:", data.houses));

# Python — Houses API Example
import requests

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

payload = {
    "date": "1995-11-08",
    "time": "14:22",
    "lat": 34.05,
    "lon": -118.24,
    "tz": "America/Los_Angeles",
    "house_system": "placidus"
}

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