Houses

Compute house cusps, ascendant, midheaven, and related angles for a given location and time.

Text

GET  /v1/houses
POST /v1/houses

Credit cost: 1

Parameters

Parameter	Type	Required	Default	Description
`datetime`	string	One of `datetime` or `jd`	—	ISO 8601 UTC datetime
`jd`	number	One of `datetime` or `jd`	—	Julian Day in UT1
`lat`	number	Yes	—	Observer latitude in degrees
`lon`	number	Yes	—	Observer longitude in degrees
`system`	string	No	`"placidus"`	House system name or code
`sidereal`	string	No	—	Ayanamsha name or ID for sidereal houses
`no_nutation`	boolean	No	`false`	Compute the cusps on the mean frame: mean sidereal time for the ARMC and mean obliquity, like the Swiss Ephemeris `SEFLG_NONUT`. Pair with `no_nutation=true` positions so bodies and cusps share a frame

Response

JSON

{
  "data": {
    "system": "placidus",
    "cusps": [
      198.4521, 228.1234, 261.5678, 298.9012,
      328.3456, 358.7890, 18.4521, 48.1234,
      81.5678, 118.9012, 148.3456, 178.7890
    ],
    "ascendant": 198.4521,
    "midheaven": 118.9012,
    "armc": 117.2345,
    "vertex": 42.6789
  },
  "meta": { "..." }
}

Field	Type	Description
`system`	string	The house system that produced the cusps. Placidus and Koch have no solution on or inside the polar circle; the engine computes the whole chart with Porphyrius there, this field says `Porphyrius`, and `warnings` says why
`warnings`	string[]	Engine conditions that degraded the result, such as the polar-circle fallback. Omitted when there are none
`cusps`	number[]	12 house cusp longitudes in degrees (0–360)
`ascendant`	number	Ascendant longitude
`midheaven`	number	Midheaven (MC) longitude
`armc`	number	ARMC (right ascension of the MC) in degrees
`vertex`	number	Vertex longitude

Examples

Bash

curl "https://api.morphemeris.com/v1/houses?datetime=2024-03-20T12:00:00Z&lat=40.7128&lon=-74.0060&system=placidus" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

javascript

const res = await fetch(
  "https://api.morphemeris.com/v1/houses?datetime=2024-03-20T12:00:00Z&lat=40.7128&lon=-74.0060&system=placidus",
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const data = await res.json();

Python

import requests

res = requests.get(
    "https://api.morphemeris.com/v1/houses",
    params={
        "datetime": "2024-03-20T12:00:00Z",
        "lat": 40.7128,
        "lon": -74.0060,
        "system": "placidus",
    },
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

See House Systems for all 23 supported systems.

Houses

Houses

Parameters

Response

Examples

On this page