API-Referenz
Alle Endpunkte im Überblick
37 Endpunkte, gruppiert nach Bereich. Klick auf einen Eintrag oeffnet die Detail-Ansicht mit Beschreibung, Parameter-Tabelle und Code-Beispielen in cURL, PHP, JavaScript und Python — vanilla oder mit unserem Single-File-Helper. Identisches Material wie in /openapi.json.
Allgemein 2
-
GET
/v1/healthStatus der API und der Datenbank.
Monitoring-Endpunkt, ohne API-Key aufrufbar. Liefert 200, wenn die API laeuft und die Datenbank erreichbar ist, 503 sonst.
-
GET
/v1/meAuthInfo zum eigenen Client (Name, Plan, Rate-Limit).
Praktisch, um schnell zu pruefen, dass ein API-Key gueltig ist und welcher Plan zugeordnet ist.
Berechnung 34
-
GET
/v1/planetsAuthEkliptikale Positionen und Geschwindigkeiten aller Standardpunkte fuer einen Zeitpunkt.
Liefert Laenge, Breite, Distanz und die drei Geschwindigkeitskomponenten fuer Sonne, Mond, Merkur, Venus, Mars, Jupiter, Saturn, Uranus, Neptun, Pluto, Mean/True Node, Mean/Osculating Apogee (Lilith), Earth und Chiron. Geozentrisch — keine …
-
POST
/v1/aspectsAuthBerechnet Aspekte zwischen Positionen. Fuer freie Positionslisten oder Synastrie.
Entweder "positions" (und optional "positions_b" fuer Synastrie) oder "datetime" uebergeben. Orben sind frei konfigurierbar ueber Presets oder eigene Werte. Liefert pro Aspekt Orbis, Applying/Separating, Exaktpunkt in Tagen und normierte St…
-
POST
/v1/radixAuthKompletter Radix: Planeten + Haeuser + Aspekte in einer Antwort.
Der zentrale Radix-Endpunkt. Nimmt Geburtsdaten und Ort entgegen und liefert per "include"-Parameter steuerbar Planetenpositionen, Haeusersystem und Aspekte. Default: alle drei.
-
POST
/v1/transitsAuthTransite gegen ein Radix. Snapshot (Zeitpunkt) oder Window (Zeitraum mit Exaktpunkten).
Liefert entweder aktuell wirksame Transit-Aspekte zum Zeitpunkt "at" (Snapshot-Modus) oder alle Aspekt-Exaktereignisse zwischen "start" und "end" (Window-Modus, inklusive Retrograd-Mehrfachtreffer). Radix-Input entweder als Geburtsdaten ("n…
-
POST
/v1/progressionsAuthSekundaer-Progression oder Solararc-Direktion. Snapshot oder Window.
Progressierte Positionen und Exakt-Kontakte mit Radix. "method": "secondary" (1 Tag = 1 Jahr) oder "solar_arc" (alle Punkte um Sonnenbogen verschoben). Snapshot via "age_years"/"at", Window via "age_start"/"age_end". Default-Orben: "progres…
-
POST
/v1/returnsAuthWiederkehrhoroskope (Returns): Sonne, Mond, Merkur, Venus, Mars, Jupiter, Saturn.
Findet den/die naechsten Zeitpunkt/e, an denen der/die Transitplanet/en die Radix-Laenge wieder erreichen. Optional wird fuer jedes Return ein komplettes Chart am Return-Ort berechnet (Planeten, Haeuser, Aspekte). Retrograde Mehrfachreturns…
-
POST
/v1/mercury-returnAuthMercury-Return — Convenience-Alias fuer /v1/returns mit planet=mercury.
Identisch zu /v1/returns, der Transitplanet ist auf Merkur fixiert. Fuer Merkur typischerweise 3 Returns pro Jahr (direkt → retrograd → direkt). Body, Validierung und Antwort identisch zum generischen Endpunkt — siehe /v1/returns fuer das v…
-
POST
/v1/venus-returnAuthVenus-Return — Convenience-Alias fuer /v1/returns mit planet=venus.
Identisch zu /v1/returns, der Transitplanet ist auf Venus fixiert. Auch Venus-Returns koennen in Retrograd-Phasen drei Treffer pro Zyklus aufweisen. Body und Antwort identisch zum generischen Endpunkt — siehe /v1/returns.
-
POST
/v1/mars-returnAuthMars-Return — Convenience-Alias fuer /v1/returns mit planet=mars.
Identisch zu /v1/returns, der Transitplanet ist auf Mars fixiert. Mars-Returns kommen ungefaehr alle zwei Jahre und koennen retrograd dreifach treffen. Body und Antwort identisch zum generischen Endpunkt — siehe /v1/returns.
-
POST
/v1/jupiter-returnAuthJupiter-Return — Convenience-Alias fuer /v1/returns mit planet=jupiter.
Identisch zu /v1/returns, der Transitplanet ist auf Jupiter fixiert. Jupiter-Returns kommen alle ~12 Jahre. Body und Antwort identisch zum generischen Endpunkt — siehe /v1/returns.
-
POST
/v1/saturn-returnAuthSaturn-Return — Convenience-Alias fuer /v1/returns mit planet=saturn.
Identisch zu /v1/returns, der Transitplanet ist auf Saturn fixiert. Klassisches Schwellen-Ereignis um Lebensjahr 29-30, weitere Returns alle ~29.5 Jahre. Body und Antwort identisch zum generischen Endpunkt — siehe /v1/returns.
-
POST
/v1/lotsAuthHellenistische Lots (arabische Punkte): Fortune, Spirit, Eros, Necessity, Courage, Victory, Nemesis, Basis u.a.
Berechnet die klassischen Lots nach der Formel A + B − C (mod 360) mit automatischer Day/Night-Regel (Tag-Horoskop = Sonne ueber dem Horizont). Einige Lots referenzieren andere (z.B. Eros nutzt Spirit) — wird intern aufgeloest. Katalog in c…
-
POST
/v1/ephemerisAuthZeitreihen-Ephemeriden: Positionen ausgewaehlter Punkte ueber einen Zeitraum.
Abtastung mit frei waehlbarer Schrittweite (Tage, Stunden oder Minuten). Liefert pro Sample die gewaehlten Felder (longitude, latitude, distance, speed, retrograde, sign, sign_degree). Maximum 10000 Samples pro Request — sonst "invalid_inpu…
-
POST
/v1/asteroidsAuthAsteroiden-Positionen zu einem Zeitpunkt (Live-Berechnung).
Berechnet ekliptikale Positionen einer Liste von Asteroiden zum angegebenen UTC-Zeitpunkt. Eingabe akzeptiert MPC-Nummern (z.B. 433 fuer Eros) oder Namen (z.B. "ceres", "lilith"). Aliase: "lilith" und "black_moon" werden auf Mean Apogee gem…
-
POST
/v1/declinationsAuthDeklinationen + Parallel/Contraparallel-Aspekte zu einem Zeitpunkt.
Liefert aequatoriale Koordinaten (Rektaszension, Deklination + Speeds) der Standardplaneten zum angegebenen Zeitpunkt sowie optional Parallel- und Contraparallel-Aspekte zwischen ihnen. Parallel: gleiche Deklination mit gleichem Vorzeichen.…
-
POST
/v1/antisciaAuthAntiscia und Contra-Antiscia: Spiegelpunkte im Tierkreis.
Liefert pro Body Antiscion (Spiegelung an der Solstitial-Achse 0° Krebs / 0° Steinbock, Formel (180-λ) mod 360) und Contra-Antiscion (Spiegelung an der Aequinoctial-Achse 0° Widder / 0° Waage, Formel (360-λ) mod 360). Optional Paar-Aspekte:…
-
POST
/v1/lunar-phasesAuthMondphasen: aktuelle Phase oder alle Phasenwechsel im Fenster.
Phasenwinkel = (lon_moon - lon_sun) mod 360°. Vier Hauptphasen: 0° = new_moon, 90° = first_quarter, 180° = full_moon, 270° = last_quarter. Zwei Modi: "at" → Snapshot mit aktueller Phase, Beleuchtung und naechstem Hauptevent. "start"+"end" →…
-
POST
/v1/ingressesAuthZeichenwechsel der Planeten im Window.
Findet alle Sign-Ingresse (Eintritt in ein neues Tierkreiszeichen) der angegebenen Bodies im Zeitraum. Pro Event Body, exakter UTC-Zeitpunkt, from_sign, to_sign, longitude (immer ein Vielfaches von 30°) und direction (direct | retrograde). …
-
POST
/v1/stationsAuthStationen (Wendepunkte) der Planeten im Window.
Findet alle Punkte, an denen ein Planet die Bewegungsrichtung wechselt: kind="station_retrograde" wenn longitude_speed von positiv nach negativ kreuzt (Beginn der Rueckwaertsphase), kind="station_direct" beim umgekehrten Wechsel. Default-Bo…
-
POST
/v1/rise-transit-setAuthAufgang, Hoechststand und Untergang von Bodies fuer einen Standort.
Liefert pro Body den naechsten Eintrittszeitpunkt fuer Aufgang ("rise"), oberen Meridiandurchgang/Kulmination ("transit"), Untergang ("set") und unteren Meridiandurchgang ("anti_transit"). Sucht jeweils das naechste Event nach "datetime". B…
-
POST
/v1/eclipsesAuthSonnen- und Mondfinsternisse im Window, optional mit Beobachter-Standort.
Liefert alle Sonnen- und Mondfinsternisse zwischen "start" und "end". Globaler Modus (default): jede Sonnenfinsternis kommt mit Bodenpunkt der groessten Bedeckung (greatest_eclipse_geo) und Magnitude; jede Mondfinsternis mit Umbral- und Pen…
-
POST
/v1/harmonicsAuthHarmonic-Chart: alle Laengen mit n multipliziert mod 360.
Klassisches Harmonic-Chart nach Addey: jede ekliptikale Laenge wird mit dem Faktor n multipliziert und mod 360° gerechnet. longitude_speed wird linear mit n skaliert. Latitude und Distance bleiben unveraendert (sind nicht Teil der harmonisc…
-
POST
/v1/draconicAuthDraconic-Chart: Laengen relativ zum Mondknoten rotiert.
Im Draconic-Zodiac wird der Mondknoten zur Bezugsachse: alle Laengen werden so rotiert, dass der Knoten auf 0° Widder liegt. Formel: draconic_longitude = (longitude - node_longitude + 360) mod 360. longitude_speed wird relativ zum Knoten au…
-
POST
/v1/void-of-courseAuthMond void-of-course-Phasen im Window.
Findet alle Mond-VOC-Phasen im Zeitraum: vom letzten exakten ptolemaeischen Aspekt (Konjunktion 0°, Sextil 60°, Quadrat 90°, Trigon 120°, Opposition 180°) zu einem klassischen Planeten bis zum naechsten Mond-Sign-Ingress. Klassische Definit…
-
POST
/v1/planetary-hoursAuthKlassische Planetenstunden (chaldaeisch) fuer Tag+Nacht.
Liefert die 24 Planetenstunden des "Plan-Tags", der den angegebenen Zeitpunkt enthaelt — von Sonnenaufgang bis Sonnenaufgang. 12 Tagesstunden zwischen Sunrise und Sunset, 12 Nachtstunden zwischen Sunset und naechstem Sunrise. Tagesherrscher…
-
POST
/v1/patternsAuthAspekt-Pattern-Erkennung (Grand Trine, T-Square, Yod, Stellium etc.).
Erkennt acht klassische Aspekt-Patterns in einer Konstellation: stellium (3+ Bodies im selben Sign), grand_trine (3 Bodies im Trigon), t_square (Opposition + Apex im Quadrat), yod (Sextil-Basis + Apex im Quincunx), grand_cross (4 Bodies, 2 …
-
POST
/v1/heliacalAuthHeliakaler Aufgang/Untergang von Fixsternen oder Planeten.
Liefert pro Anfrage drei Schluesselzeitpunkte: optimum_utc (optimale Beobachtbarkeit), event_utc (klassisches heliakales Datum), end_utc (Sichtbarkeitsende). Sieben Event-Typen: heliacal_rising (Morgen-Erstsichtbarkeit nach Sonnen-Konjunkti…
-
POST
/v1/fixed-starsAuthFixsterne: Positionen und Konjunktionen mit Radix-Punkten.
Liefert ekliptikale Positionen von Fixsternen zu einem Zeitpunkt. Optional: wenn "natal" oder "points" mitgegeben werden, werden Aspekte (Default: nur Konjunktion, Orbis 1°) zu diesen Punkten berechnet. Standardliste: 22 astrologisch bedeut…
-
POST
/v1/midpointsAuthHalbsummen-Analyse nach Ebertin. Liste, aktivierte Halbsummen und Wurzelbaum.
Berechnet alle Halbsummen fuer eine Positionsliste (fuer n Punkte entstehen n*(n-1)/2 Halbsummen) und identifiziert, welche dritten Punkte mit 8.-Harmonie-Aspekten (0°, 45°, 90°, 135°, 180°) in engem Orb (Default 1.5°) auf diesen Halbsummen…
-
GET
/v1/housesAuthHausspitzen und Achsen (AC, MC, ARMC, Vertex, ...) fuer einen Moment und Ort.
Berechnet die 12 Hausspitzen sowie acht Achsen-Werte nach dem gewaehlten Haeusersystem (Default: Koch). Alle Werte in Dezimalgrad, Bereich 0..360.
-
POST
/v1/dignitiesAuthKlassische hellenistische Wuerden (Domizil, Exaltation, Triplizitaet, Term, Face, Detriment, Fall) und Almuten.
Berechnet pro Body alle klassischen Wuerden eines Punktes im Tierkreis nach Doroth/Ptolemaios. Wuerden-Score nach Lilly: domicile 5, exaltation 4, triplicity 3, term 2, face 1. Eingabe entweder ueber `datetime` (Service rechnet die 7 klassi…
-
POST
/v1/profectionsAuthKlassische Whole-Sign-Profektionen (Annual / Monthly / Daily) mit Time-Lord.
Profektionen sind ein hellenistisches Zeit-Herrschaftssystem: pro Lebensjahr aktiviert sich ein Sign (beginnend mit dem Asc-Sign im 0. Lebensjahr), zykliert mod 12. Innerhalb des Jahres aktiviert sich pro 1/12 (~30.44 Tage) ein weiteres Sig…
-
POST
/v1/firdariaAuthPersisch-arabisches Firdaria-System (Abu Ma'shar) — Haupt- und Subperioden ueber 75-Jahres-Lebensspanne.
Firdaria ist ein hellenistisch-persisches Time-Lord-System: die Lebensspanne von 75 Jahren wird auf 9 Hauptperioden verteilt (7 klassische Planeten + Nord-Knoten 3 J + Sued-Knoten 2 J), die Reihenfolge ist sect-abhaengig (day = Sonnen-Reihe…
-
POST
/v1/zodiacal-releasingAuthHellenistisches Zodiacal Releasing nach Vettius Valens (L1..L4 ab Lot of Spirit/Fortune).
Zodiacal Releasing (ZR) ist ein hellenistisches Time-Lord-System aus Vettius Valens (Anthologiae IV). 12 Sign-Periodenlaengen: Aries 15, Taurus 8, Gemini 20, Cancer 25, Leo 19, Virgo 20, Libra 8, Scorpio 15, Sagittarius 12, Capricorn 27, Aq…
Partnerschaft 1
Keine Treffer.