POST/v1/western/horary

Western horary chart facts

The chart of a question's moment with the facts Lilly's horary method reads, each rule named. House rulers (traditional rulers), the significators (lord of the 1st and the Moon for the querent, lord of the quesited house), their aspects with Lilly's orbs and whether an applying aspect perfects before a sign change, the Moon's last and next aspects and void-of-course state, combustion, and the considerations before judgement (radicality by the hour lord, early or late Ascendant, Saturn in the 7th, the Moon in the Via Combusta). The yes or no is left to the reader. Christian Astrology (1647).

Request parameters

daterequired

string

Date the question was asked, YYYY-MM-DD (local).

timerequired

string

Time the question was asked, HH:MM (24-hour, local).

locationoptional

string | null

Place the question was asked, as a city name.

latitudeoptional

number | null

Latitude in decimal degrees, north positive. Use with longitude and timezone instead of location.

longitudeoptional

number | null

Longitude in decimal degrees, east positive. Use with latitude and timezone instead of location.

timezoneoptional

string | null

IANA timezone of the place.

house_systemoptional

string

Lilly used Regiomontanus, which is not yet available; Placidus is the default.

quesited_houseoptional

integer | null

The house of the matter asked about (7 for a partner, 10 for a job, 2 for money …). Its ruler becomes the quesited's significator.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.moment_utc

string

data.moment_local

string

data.house_system

string

data.sect

string

data.ascendant

object

data.mc

object

data.planets

array[object]

Each planet: sign, degree, house, retrograde, speed, dignity and Lilly's essential dignities, combustion.

data.house_rulers

array[object]

Traditional ruler of each house cusp and where that ruler stands.

data.quesited_house

integer | null

data.significators

array[object]

Lord of the 1st and the Moon for the querent; lord of the quesited house when given.

data.aspects_between_significators

array[object]

Aspect, orb against the moiety of Lilly's orbs, applying or separating, exact time, and whether it perfects before a sign change.

data.moon

object

Separating-from and applying-to aspects within the Moon's sign, void of course, Via Combusta, late degrees.

data.considerations

object

Lilly's considerations before judgement, each as a flag with its rule.

data.orbs

object

data.note

string

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Request

POST·application/json

curl
Python
TypeScript

curl -X POST "https://api.asterwise.com/v1/western/horary" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-01-01","time":"14:30","latitude":51.5074,"longitude":-0.1278,"timezone":"Europe/London","quesited_house":10}'

import asterwise
from asterwise.api.western_astrology_api import WesternAstrologyApi
from asterwise.models.western_horary_request import WesternHoraryRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = WesternHoraryRequest(
    date="2026-01-01",
    time="14:30",
    latitude=51.5074,
    longitude=-0.1278,
    timezone="Europe/London",
    quesited_house=10,
)

with asterwise.ApiClient(configuration) as client:
    api = WesternAstrologyApi(client)
    result = api.western_horary(western_horary_request=request)
    print(result)

import { createClient, createConfig, westernHorary } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await westernHorary({
  client,
  body: {
      "date": "2026-01-01",
      "time": "14:30",
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London",
      "quesited_house": 10
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "moment_utc": "2026-01-01T14:30:00Z",
    "moment_local": "2026-01-01T14:30:00+00:00",
    "house_system": "placidus",
    "sect": "day",
    "ascendant": {
      "sign": "Gemini",
      "degree_in_sign": 21.9463,
      "longitude": 81.9463
    },
    "mc": {
      "sign": "Aquarius",
      "degree_in_sign": 16.1736
    },
    "planets": [
      {
        "planet": "Sun",
        "sign": "Capricorn",
        "sign_index": 9,
        "degree_in_sign": 11.1842,
        "longitude": 281.1842,
        "house": 8,
        "is_retrograde": false,
        "speed": 1.0189,
        "dignity": "peregrine",
        "dignity_score": 0,
        "essential_dignities": {
          "domicile": 0,
          "exaltation": 0,
          "triplicity": 0,
          "term": 0,
          "face": 0,
          "detriment": 0,
          "fall": 0,
          "peregrine": true,
          "total": -5,
          "applicable": true,
          "system": "lilly"
        },
        "is_combust": false,
        "combustion_rule": null
      },
      {
        "planet": "Moon",
        "sign": "Gemini",
        "sign_index": 2,
        "degree_in_sign": 15.7928,
        "longitude": 75.7928,
        "house": 12,
        "is_retrograde": false,
        "speed": 15.0513,
        "dignity": "peregrine",
        "dignity_score": 0,
        "essential_dignities": {
          "domicile": 0,
          "exaltation": 0,
          "triplicity": 0,
          "term": 0,
          "face": 0,
          "detriment": 0,
          "fall": 0,
          "peregrine": true,
          "total": -5,
          "applicable": true,
          "system": "lilly"
        },
        "is_combust": false,
        "combustion_rule": null
      },
      "... and 8 more items"
    ],
    "house_rulers": [
      {
        "house": 1,
        "cusp_sign": "Gemini",
        "cusp_degree_in_sign": 21.9463,
        "ruler": "Mercury",
        "ruler_position": {
          "planet": "Mercury",
          "sign": "Sagittarius",
          "sign_index": 8,
          "degree_in_sign": 29.5743,
          "longitude": 269.5743,
          "house": 7,
          "is_retrograde": false,
          "speed": 1.529,
          "dignity": "detriment",
          "dignity_score": -5,
          "essential_dignities": {
            "domicile": 0,
            "exaltation": 0,
            "triplicity": 0,
            "term": 0,
            "face": 0,
            "detriment": -5,
            "fall": 0,
            "peregrine": true,
            "total": -10,
            "applicable": true,
            "system": "lilly"
          },
          "is_combust": false,
          "combustion_rule": null
        }
      },
      {
        "house": 2,
        "cusp_sign": "Cancer",
        "cusp_degree_in_sign": 9.4287,
        "ruler": "Moon",
        "ruler_position": {
          "planet": "Moon",
          "sign": "Gemini",
          "sign_index": 2,
          "degree_in_sign": 15.7928,
          "longitude": 75.7928,
          "house": 12,
          "is_retrograde": false,
          "speed": 15.0513,
          "dignity": "peregrine",
          "dignity_score": 0,
          "essential_dignities": {
            "domicile": 0,
            "exaltation": 0,
            "triplicity": 0,
            "term": 0,
            "face": 0,
            "detriment": 0,
            "fall": 0,
            "peregrine": true,
            "total": -5,
            "applicable": true,
            "system": "lilly"
          },
          "is_combust": false,
          "combustion_rule": null
        }
      },
      "... and 10 more items"
    ],
    "quesited_house": 10,
    "significators": [
      {
        "role": "querent",
        "house": 1,
        "planet": "Mercury",
        "position": {
          "planet": "Mercury",
          "sign": "Sagittarius",
          "sign_index": 8,
          "degree_in_sign": 29.5743,
          "longitude": 269.5743,
          "house": 7,
          "is_retrograde": false,
          "speed": 1.529,
          "dignity": "detriment",
          "dignity_score": -5,
          "essential_dignities": {
            "domicile": 0,
            "exaltation": 0,
            "triplicity": 0,
            "term": 0,
            "face": 0,
            "detriment": -5,
            "fall": 0,
            "peregrine": true,
            "total": -10,
            "applicable": true,
            "system": "lilly"
          },
          "is_combust": false,
          "combustion_rule": null
        }
      },
      {
        "role": "querent_co_significator",
        "house": null,
        "planet": "Moon",
        "position": {
          "planet": "Moon",
          "sign": "Gemini",
          "sign_index": 2,
          "degree_in_sign": 15.7928,
          "longitude": 75.7928,
          "house": 12,
          "is_retrograde": false,
          "speed": 15.0513,
          "dignity": "peregrine",
          "dignity_score": 0,
          "essential_dignities": {
            "domicile": 0,
            "exaltation": 0,
            "triplicity": 0,
            "term": 0,
            "face": 0,
            "detriment": 0,
            "fall": 0,
            "peregrine": true,
            "total": -5,
            "applicable": true,
            "system": "lilly"
          },
          "is_combust": false,
          "combustion_rule": null
        }
      },
      "... and 1 more item"
    ],
    "aspects_between_significators": [
      {
        "planets": [
          "Mercury",
          "Saturn"
        ],
        "aspect": "square",
        "orb": 3.3715,
        "moiety_of_orbs": 8.0,
        "is_applying": false,
        "exact_at": null,
        "perfects_before_sign_change": null,
        "rule": "Orbs: Lilly CA pp. 57-83; an applying aspect that perfects before either planet changes sign is perfection; one that doe…"
      },
      {
        "planets": [
          "Moon",
          "Saturn"
        ],
        "aspect": "square",
        "orb": 10.41,
        "moiety_of_orbs": 10.5,
        "is_applying": true,
        "exact_at": "2026-01-02T07:09:28Z",
        "perfects_before_sign_change": true,
        "rule": "Orbs: Lilly CA pp. 57-83; an applying aspect that perfects before either planet changes sign is perfection; one that doe…"
      },
      "... and 1 more item"
    ],
    "moon": {
      "sign": "Gemini",
      "degree_in_sign": 15.7928,
      "house": 12,
      "separating_from": {
        "planet": "Saturn",
        "aspect": "sextile",
        "exact_at": "2025-12-31T06:58:08Z"
      },
      "applying_to": [
        {
          "planet": "Saturn",
          "aspect": "square",
          "exact_at": "2026-01-02T07:09:28Z"
        }
      ],
      "is_void_of_course": false,
      "leaves_sign_at": "2026-01-02T13:09:00Z",
      "in_via_combusta": false,
      "in_late_degrees": false,
      "rules": "Void of course: no further aspect before leaving the sign (CA p. 112). Via Combusta: last 15° of Libra to first 15° of S…"
    },
    "considerations": {
      "lord_of_hour": "Sun",
      "lord_of_ascendant": "Mercury",
      "triplicity_ruler_of_ascendant": "Saturn",
      "is_radical_by_hour": false,
      "ascendant_degree": 21.9463,
      "ascendant_in_early_degrees": false,
      "ascendant_in_late_degrees": false,
      "saturn_in_7th": false,
      "saturn_in_1st": false,
      "lord_of_ascendant_combust": false,
      "moon_void_of_course": false,
      "moon_in_via_combusta": false,
      "rules": "Radical when the lord of the hour and the lord of the Ascendant are one, or of one triplicity (CA p. 121). Saturn in the…"
    },
    "orbs": {
      "Saturn": 9.0,
      "Jupiter": 9.0,
      "Mars": 7.0,
      "Sun": 15.0,
      "Venus": 7.0,
      "Mercury": 7.0,
      "Moon": 12.0
    },
    "note": "Facts of the horary chart with Lilly's rules named. Whether the matter perfects, and the yes or no, is the reader's judg…"
  }
}

Request parameters​

Response fields​

Errors​

Related endpoints​

Request parameters

Response fields

Errors

Related endpoints