POST/api/astro/house_hora/1 Credit

Hausbeziehungen

Das Beziehungsgefüge eines Geburtshoroskops: welche Zeichen welche aspektieren, welche Planeten welche aspektieren, wer mit wem befreundet ist und welche Planeten die klassischen Texte als bedeutsam für die Wendepunkte eines Horoskops hervorheben. Ein großer Teil der Mechanik hinter der Beurteilung nach Jaimini und Parashari, Stück für Stück abrufbar. Es gibt drei Gruppen. Die Hausklassen-Keys (`trikonas`, `kendras`, `quadrants`, `dushthanas`, `chathusras`, `upachayas`) sind reine Geometrie: zwölf Zeilen, eine pro Zeichen, mit Zeichennummern von 1 bis 12, unabhängig vom Horoskop. Die Aspekt- und Beziehungs-Keys (`raasi_drishti_of_the_planet`, die drei Keys `aspected_*_of_the_planet`, die beiden Keys `*_of_the_raasi`, `argala`, `associations_of_the_planet`, die drei Keys zur natürlichen Freundschaft und `baadhakas_of_raasi`) beschreiben, wie die Himmelskörper des Horoskops zueinander stehen. Die Jaimini-Keys (`chara_karakas`, `marakas`, `brahma`, `rudra`, `maheshwara`, `trishoola_rasis`, `order_of_planets_by_strength`) benennen die Planeten, auf die es bei Langlebigkeit und beim Zeitpunkt großer Ereignisse ankommt. Planeten werden durchgehend als Indizes geliefert: 0 Sonne, 1 Mond, 2 Mars, 3 Merkur, 4 Jupiter, 5 Venus, 6 Saturn, 7 Rahu, 8 Ketu. Zeichen sind in den Aspekt- und Jaimini-Keys nullbasiert (0 Widder bis 11 Fische), in den Hausklassen-Keys dagegen einsbasiert (1 bis 12) – prüfe also, was du gerade liest. Das Anfragefeld `planet` wird mit großem Anfangsbuchstaben geschrieben, die Groß-/Kleinschreibung wird beachtet ('Sun', nicht 'sun'). `raasi` ist eine nullbasierte Ganzzahl ohne Bereichsprüfung; ein Wert außerhalb von 0–11 lässt die Anfrage scheitern.

https://api.occultapi.com/api/astro/house_hora/

Anfrage testen

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Felder der Anfrage

Feld	Typ	Pflicht	Hinweise
date_time	string (date-time)	Pflicht	Der Zeitpunkt, für den gerechnet wird, im Format ISO 8601. Gib IMMER einen Offset oder ein abschließendes Z an – ein Wert ohne Zone wird als Asia/Kolkata (UTC+05:30) gelesen, nicht als UTC, und kann mit Status 200 das Ergebnis des Vortags liefern. '2026-09-01T06:00:00Z' und '2026-09-01 06:00:00' sind verschiedene Zeitpunkte und ergeben verschiedene Antworten. FORMATVORGABE. DRF DateTimeField: nur ISO-8601 (Standard-Eingabeformate von DRF), z. B. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" oder "2026-09-01 06:00:00" (ohne Zeitzone wird UTC angenommen).
keys	array	Pflicht	Welche Berechnungen zurückgegeben werden, als Liste von Namen. Siehe die Key-Tabelle dieses Endpoints; ein unbekannter Name lässt die ganze Anfrage scheitern. Ein Aufruf kostet einen Credit, egal wie viele Keys du anforderst – fordere also alles, was du brauchst, auf einmal an, statt mehrere Aufrufe zu machen. `trikonasdushthanaschathusrasquadrantskendrasupachayaschara_karakasraasi_drishti_of_the_planetaspected_planets_of_the_planetaspected_rasis_of_the_planetaspected_houses_of_the_planetaspected_houses_of_the_raasi` Array von Strings. Die Keys mit der Endung '_of_the_planet' sowie 'associations_of_the_planet' erfordern `planet`; die Keys mit der Endung '_of_the_raasi' sowie 'baadhakas_of_raasi' erfordern `raasi`.
latitude	number (double)	Pflicht	Breitengrad des Ortes in Dezimalgrad. Positiv ist Nord, negativ ist Süd. Beispiel: 26.9124 für Jaipur, 40.7128 für New York. Minuten und Sekunden werden nicht akzeptiert – vorher umrechnen. min -90 · max 90
longitude	number (double)	Pflicht	Längengrad des Ortes in Dezimalgrad. Positiv ist Ost, negativ ist West. Beispiel: 75.7873 für Jaipur, -74.0060 für New York. Achte auf das Vorzeichen: Ein fehlendes Minus verlegt New York nach China. min -180 · max 180
node	string	Pflicht	`truemean` Groß-/Kleinschreibung wird beachtet; nur Kleinbuchstaben. 'true' verwendet die wahren, 'mean' die mittleren Mondknoten. Jeder andere Wert führt zu einem KeyError -> 400. Wird weitergereicht.
planet	string	Pflicht	`SunMoonMarsMercuryJupiterVenusSaturnRahuKetu` Groß-/Kleinschreibung wird BEACHTET; mit großem Anfangsbuchstaben – anders als die kleingeschriebenen Namen der Himmelskörper bei /api/astro/chart_analysis/.
raasi	integer	Pflicht	`01234567891011` Ganzzahl, kein String. Dient als NULLBASIERTER Zeichenindex: 0 = Widder ... 11 = Fische. Es gibt keine Bereichsprüfung: Werte außerhalb des Bereichs lösen einen IndexError -> 400 aus, negative Werte werden stillschweigend von hinten gezählt.
timezone_as_float	number (double)	Pflicht	UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30), -5 für New York im Winter, 5.75 für Nepal. Wird NICHT gegen date_time validiert – stimmen beide nicht überein, erhältst du eine erfolgreiche Antwort für den falschen Zeitpunkt; leite daher beide aus derselben Quelle ab. Nutze den an diesem Datum gültigen Offset, nicht den heutigen: Eine Sommergeburt in einem Land mit Sommerzeit braucht den Sommer-Offset. min -12 · max 14

Verfügbare Keys (29)

Liste in keys genau die Berechnungen auf, die du brauchst. Ein unbekannter Key lässt die ganze Anfrage scheitern. Du zahlst 1 Credit, ganz gleich, wie viele du anforderst – fass sie also in einer Anfrage zusammen.

Key	Zusätzliche Felder	Beschreibung
argala	—	Argala und Virodhargala für das ganze Horoskop, als Liste mit zwei Elementen. Das erste Element ist Argala, das Eingreifen, das von einem Haus ausgeht: zwölf Zeilen, eine pro Haus ab dem Aszendenten, jede mit vier Strings für das 2., 4., 5. und 11. Haus ab diesem Haus. Die Indizes der dort stehenden Planeten sind mit '/' verbunden; wo kein Planet steht, steht ein leerer String. Das zweite Element ist Virodhargala, die Behinderung dieses Eingreifens, in derselben Struktur für das 12., 10., 9. und 3. Haus – in genau dieser Reihenfolge, sodass die Spalten den Argala-Spalten paarweise gegenüberstehen.
aspected_houses_of_the_planet	planet	Dieselben Graha-Drishti-Aspekte wie `aspected_rasis_of_the_planet`, aber als Hausnummern ab dem Aszendenten (1 bis 12) statt als Zeichenindizes. Erfordert `planet`.
aspected_houses_of_the_raasi	raasi	Die Häuser (1 bis 12, ab dem Aszendenten gezählt), die das angegebene Zeichen per Rasi-Drishti aspektiert – alle, egal ob ein Planet darin steht. Erfordert `raasi` als nullbasierten Zeichenindex.
aspected_planets_of_the_planet	planet	Die Planeten, die der angegebene Planet per Graha-Drishti aspektiert – also nach dem Planetenaspekt der Parashari-Astrologie, bei dem jeder Planet das 7. Haus sieht und Mars, Jupiter und Saturn zusätzliche Aspekte haben. Liefert eine Liste von Planetenindizes. Erfordert `planet`.
aspected_raasis_of_the_raasi	raasi	Dieselbe Rasi-Drishti-Beziehung wie `aspected_houses_of_the_raasi`, aber als nullbasierte Zeichenindizes statt als Hausnummern – also völlig unabhängig vom Aszendenten. Erfordert `raasi`.
aspected_rasis_of_the_planet	planet	Die Zeichen, die der angegebene Planet per Graha-Drishti aspektiert, als Liste nullbasierter Zeichenindizes von 0 für Widder bis 11 für Fische. Die Zeichen-Variante von `aspected_houses_of_the_planet`. Erfordert `planet`.
associations_of_the_planet	planet	Alle Planeten, mit denen der angegebene Planet auf einem der drei klassischen Wege in Verbindung steht: Sie stehen im selben Zeichen, er aspektiert sie per Graha-Drishti, oder sie tauschen mit ihm die Zeichen (Parivartana). Liefert eine Liste von Planetenindizes ohne Duplikate. Erfordert `planet`.
baadhakas_of_raasi	raasi	Das Baadhaka-Haus (das hemmende Haus) für ein aufsteigendes Zeichen und die Planeten, die es beherrschen – das 11. Haus bei beweglichen Zeichen, das 9. Haus bei festen und das 7. Haus bei doppelten. Liefert eine Liste mit zwei Elementen: [das nullbasierte Baadhaka-Zeichen, eine Liste der Indizes seiner Herrscher]. Erfordert `raasi`.
brahma	—	Brahma, der Planet, den Jaimini mit der Erhaltung des Lebens verbindet. Ermittelt als stärkster der Herrscher des 6., 8. und 12. Hauses, gezählt ab dem stärkeren von Aszendent und 7. Haus. Rahu und Ketu sind ausgeschlossen; bei Gleichstand entscheiden Würde, Stellung in einem ungeraden Zeichen und Position innerhalb der Hälfte. Liefert einen einzelnen Planetenindex.
chara_karakas	—	Die acht Chara-Karakas als Liste von acht Planetenindizes, absteigend nach ihrem Grad im Zeichen sortiert. Der erste Eintrag ist der Atmakaraka, die übrigen folgen in der Standardreihenfolge (Amatya, Bhratri, Matri, Pitri, Putra, Gnati, Dara). Ketu ist ausgeschlossen, und Rahu wird – wie es die klassische Regel verlangt – nach seiner umgekehrten Länge eingeordnet.
chathusras	—	Zwölf Zeilen mit je zwei Zeichennummern 1–12. In der aktuellen Implementierung liefert jede Zeile das 3. und 5. Zeichen ab dem Zeichen – Zeile 1 ist [3, 5] – und nicht das 4. und 8., die das klassische Chatusra-Paar bilden.
dushthanas	—	Zwölf Zeilen mit je drei Zeichennummern 1–12. In der aktuellen Implementierung liefert jede Zeile das Zeichen selbst sowie das 3. und 7. Zeichen ab ihm – Zeile 1 ist [1, 3, 7]. Das ist nicht der klassische Dusthana-Satz aus 6./8./12.; verstehe die Ausgabe also als das, was der Code berechnet, und nicht als Dusthanas im Lehrbuchsinn.
kendras	—	Die Quadranten jedes Zeichens: zwölf Zeilen, eine pro Zeichen, jeweils eine Liste von vier Zeichennummern von 1 bis 12. Zeile 0 ist Widder. Braucht kein Argument. Die Struktur unterscheidet sich vom Key `kendras` bei /api/astro/strength/: Der nimmt ein `asc_house` entgegen und liefert eine einzelne flache Liste von vier NULLBASIERTEN Indizes. Achte darauf, die beiden unterschiedlichen Zählweisen nicht zu verwechseln.
maheshwara	—	Derselbe Wert wie `maheshwara_from_planet_positions` – dieser Key ruft direkt jenen auf und liefert denselben einzelnen Planetenindex. Fordere nur einen der beiden an.
maheshwara_from_planet_positions	—	Maheshwara, der Planet, den Jaimini mit der Todesart verbindet. Ermittelt als Herrscher des achten Zeichens ab dem Atmakaraka, mit den klassischen Ersetzungen, wenn dieser Herrscher im eigenen Zeichen steht oder mit einem Mondknoten verbunden ist bzw. ihm gegenübersteht. Liefert einen einzelnen Planetenindex; wäre das Ergebnis Rahu oder Ketu, wird es durch Merkur bzw. Jupiter ersetzt.
marakas	—	Dieselben Maraka-Planeten wie `marakas_from_planet_positions`, aber aus der Haus-zu-Planet-Darstellung des Horoskops berechnet. Das Ergebnis ist dieselbe Liste von Planetenindizes; fordere also nur einen der beiden Keys an.
marakas_from_planet_positions	—	Die Maraka-Planeten (todbringende Planeten): die Herrscher des 2. und 7. Hauses sowie jeder Planet, der in einem dieser Häuser oder bei einem dieser Herrscher steht. Liefert eine Liste von Planetenindizes in beliebiger Reihenfolge. Berechnet aus der Planetenpositions-Darstellung des Horoskops.
natural_enemies_of_planets	—	Die Standardtabelle der Feindschaften, als Liste von neun Listen, indiziert nach Planet 0–8, jeweils mit den Planeten, die ihm feindlich gesinnt sind. Fest und vom Horoskop unabhängig, das Gegenstück zu `natural_neutral_of_planets`.
natural_friends_of_planets	—	Dauerhafte Planetenfreundschaft, abgeleitet aus den Zeichenherrschaften dieses Horoskops: ein Objekt mit dem Planetenindex 0–8 als Schlüssel und jeweils einer Liste der Planeten, die ihm freundlich gesinnt sind. Bei den sieben klassischen Planeten zählt neben den Herrschern der Freundeszeichen auch der Herrscher des Erhöhungszeichens dazu.
natural_neutral_of_planets	—	Die Standardtabelle der Neutralität, als Liste von neun Listen, indiziert nach Planet 0–8, jeweils mit den Planeten, die ihm gegenüber neutral sind. Anders als `natural_friends_of_planets` ist das die feste klassische Tabelle, die überhaupt nicht vom Horoskop abhängt.
order_of_planets_by_strength	—	Alle neun Planeten nach Stärke geordnet, der stärkste zuerst, als Liste von neun Planetenindizes. Die Reihenfolge ergibt sich aus dem paarweisen Stärkevergleich des Rechenkerns – demselben, der bei Rudra und Maheshwara zwischen mehreren möglichen Herrschern entscheidet.
planets_aspecting_the_planet	planet	Soll die Planeten liefern, die per Graha-Drishti auf den angegebenen Planeten blicken, als Liste von Planetenindizes. In der aktuellen Implementierung wird jedoch der großgeschriebene Planetenname mit Listen von Planetenindizes verglichen, daher kommt für jede Eingabe eine leere Liste zurück. Rufe stattdessen `aspected_planets_of_the_planet` nacheinander für jeden Planeten auf und kehre das Ergebnis um.
quadrants	—	Die Eckhäuser jedes Zeichens: zwölf Zeilen mit je vier Zeichennummern 1–12, nämlich das Zeichen selbst sowie das 4., 7. und 10. Zeichen ab ihm. Zeile 1 ist [1, 4, 7, 10]. Bei diesem Endpoint ein Alias für `kendras` – die beiden können sich nicht unterscheiden; wer beide anfordert, verschwendet nur einen Platz in der Antwort.
raasi_drishti_of_the_planet	planet	Die Planeten in den Zeichen, die das Zeichen des angegebenen Planeten per Rasi-Drishti aspektiert – also nach dem Aspekt von Zeichen zu Zeichen nach Jaimini, bei dem bewegliche Zeichen die festen sehen und umgekehrt und doppelte Zeichen einander sehen. Liefert eine Liste von Planetenindizes. Erfordert `planet`.
rudra	—	Rudra, ermittelt als der stärkere von zwei Herrschern: dem des 8. Hauses ab dem Aszendenten und dem des 8. Hauses ab dem 7. Haus. Liefert [Planetenindex, das nullbasierte Zeichen, in dem er steht, die drei nullbasierten Trigonzeichen dieses Zeichens]. Beachte: Das weicht von `rudra_based_on_planet_positions` ab, wo der zweite Herrscher anders abgeleitet wird; dort kann daher ein anderer Planet herauskommen.
rudra_based_on_planet_positions	—	Rudra, der Planet, den Jaimini mit der zerstörerischen Wendung in einem Horoskop verbindet – hier der stärkere von zwei Herrschern: dem des achten Zeichens ab dem Aszendenten und dem des 7. Hauses. Liefert eine Liste mit drei Elementen: [Planetenindex, das nullbasierte Zeichen, in dem er steht, die drei nullbasierten Trigonzeichen dieses Zeichens]. Die Ableitung unterscheidet sich von `rudra`, und beide können verschiedene Planeten nennen.
trikonas	—	Die Trigone jedes Zeichens: zwölf Zeilen mit je drei Zeichennummern 1–12, nämlich das Zeichen selbst sowie das 5. und 9. Zeichen ab ihm. Zeile 1 ist [1, 5, 9]. Reine Geometrie – für jedes Horoskop gleich.
trishoola_rasis	—	Die Trishula-Rasis, der „Dreizack“ aus drei Zeichen, an dem man den Zeitpunkt der schädlichsten Periode eines Horoskops abliest: die Trigone des Zeichens, in dem Rudra steht. Liefert drei nullbasierte Zeichenindizes.
upachayas	—	Zwölf Zeilen mit je vier Zeichennummern 1–12. In der aktuellen Implementierung liefert jede Zeile das Zeichen selbst sowie das 4., 8. und 9. Zeichen ab ihm – Zeile 1 ist [1, 4, 8, 9] – und nicht das 3., 6., 10. und 11., die klassisch den Upachaya-Satz bilden.

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/house_hora/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["trikonas"],"raasi":2,"planet":"Mars","node":"mean","date_time":"2025-02-12T09:35:49.036Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Antwort

{
  "data": {
    "trikonas": [
      [
        1,
        5,
        9
      ],
      [
        2,
        6,
        10
      ],
      [
        3,
        7,
        11
      ],
      [
        4,
        8,
        12
      ],
      [
        5,
        9,
        1
      ],
      [
        6,
        10,
        2
      ],
      [
        7,
        11,
        3
      ],
      [
        8,
        12,
        4
      ],
      [
        9,
        1,
        5
      ],
      [
        10,
        2,
        6
      ],
      [
        11,
        3,
        7
      ],
      [
        12,
        4,
        8
      ]
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data, jeweils unter dem Key, den du angefordert hast.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.