API-Referenz
Alle Endpunkte im Überblick
50 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 42
-
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. Default geozentrisch-…
-
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/aspect-eventsAuthExakte Aspekt-Zeitpunkte zwischen zwei bewegten Bodies im Window.
Beantwortet die Frage "WANN wird der Aspekt exakt" — im Gegensatz zu POST /v1/aspects, das einen Snapshot liefert ("welche Winkel gelten zu EINEM Zeitpunkt, mit welchem Orb"). Hier gibt es keinen Orb: gesucht ist genau der Moment, in dem er…
-
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/progressionsAuthProgressionen (sekundaer, tertiaer, minor) oder Solararc-Direktion. Snapshot oder Window.
Progressierte Positionen und Exakt-Kontakte mit Radix. "method": "secondary" (1 Tag = 1 Jahr), "tertiary" (1 Tag = 1 tropischer Monat — Mond-Feinzyklen), "minor" (1 tropischer Monat = 1 Jahr) oder "solar_arc" (alle Punkte um Sonnenbogen ver…
-
POST
/v1/returnsAuthWiederkehrhoroskope (Returns) fuer alle Koerper — inkl. Chiron, Asteroiden, Knoten und Demi-/Quartal-Returns.
Findet den/die naechsten Zeitpunkt/e, an denen der/die Transitkoerper die Radix-Laenge (plus optionalem target_angle) wieder erreichen. Optional wird fuer jedes Return ein komplettes Chart am Return-Ort berechnet (Planeten, Haeuser, Aspekte…
-
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/phenomenaAuthPlanetare Phaenomene + traditionelle Sonnennaehe-Klassifikation (Kazimi, verbrannt, unter den Strahlen).
Liefert pro Koerper Phasenwinkel, beleuchteten Anteil, Elongation, scheinbaren Durchmesser und Magnitude (swe_pheno) sowie die klassische Einordnung der Sonnennaehe (cazimi ≤ 0°17′, combust ≤ 8°30′, under_beams ≤ 17°, sonst free) und orient…
-
POST
/v1/local-spaceAuthLocal Space: Kompass-Azimut und Horizonthoehe aller Koerper von einem Ort aus (Lewis-Linien-Grundlage).
Liefert pro Koerper die Richtung am oertlichen Horizont: Kompass-Azimut (Nord = 0°, ueber Ost = 90°), 16-teilige Kompassrose, wahre und scheinbare Hoehe (mit Refraktion) sowie Sichtbarkeit. Rechengrundlage der Local-Space-Astrologie und der…
-
POST
/v1/nodes-apsidesAuthPlanetenknoten (auf-/absteigend) und Apsiden (Perihel/Aphel) als Profi-Deutungsfaktoren.
Liefert pro Koerper die Bahnknoten und Bahn-Extrempunkte mit Laenge, Zeichen, Breite und Distanz. "method": "mean" (glatt, fuer Mond..Neptun; Mond-mean entspricht exakt dem Mean Node) oder "osculating" (wahre Momentanbahn; Mond-osculating ≈…
-
POST
/v1/gauquelin-sectorsAuthDie 36 Gauquelin-Sektoren entlang des Tagesbogens (Forschungs-Klassiker, Mars-Effekt).
Sektor-Position 1..36.99 jedes Koerpers entlang seines taeglichen Laufs: Sektor 1 beginnt am Aufgang, die Kulmination liegt bei Sektor 10, der Untergang bei Sektor 19 — gezaehlt gegen die taegliche Bewegung. Grundlage von Michel Gauquelins …
-
POST
/v1/orbital-elementsAuthOskulierende Bahnelemente und Distanz-Extreme (inkl. Supermond-Indikator).
Kepler-Elemente jedes Koerpers (grosse Halbachse, Exzentrizitaet, Neigung, Knoten-/Perihelwinkel, Perioden, mittlere Bewegung, Perihel-Durchgang) plus aktuelle/minimale/maximale wahre Distanz. distance.fraction = 0 bedeutet Perigaeum/Perihe…
-
POST
/v1/vedicAuthVedische Module: Nakshatras, Vimshottari-Dashas und Vargas (Teilhoroskope) auf siderischem Fundament.
Siderische Positionen der Grahas (Sonne..Saturn + Rahu = mittlerer Knoten, Ketu = Rahu+180°) mit Nakshatra/Pada/Herrscher; Vimshottari-Mahadashas ab Geburt (120-Jahres-Zyklus, Balance der ersten Dasha, optional Antardashas) und Vargas nach …
-
POST
/v1/primary-directionsAuthKlassische Primärdirektionen (Placidus-Halbbogen, direkte Direktionen, Ptolemaeus/Naibod-Schluessel).
Die Koenigsdisziplin der traditionellen Prognose: Die taegliche Himmelsdrehung traegt Promissoren zu den natalen Plaetzen der Signifikatoren; der Drehbogen wird ueber den Zeitschluessel in Lebensjahre uebersetzt. Methode: Placidus-Proportio…
-
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" — …
-
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…
Ereignisse 2
-
POST
/v1/crossingsAuthExakte Zeitpunkte, zu denen ein Koerper eine ekliptikale Laenge ueberquert (Konstellationsscanner-Baustein).
"Wann steht Mars auf 15° Widder?" — findet alle Ueberquerungen der Ziel-Laengen im Zeitraum, inklusive Mehrfach-Treffern durch Rueckläufigkeit (direkt → retro → direkt). Bisection-Toleranz 1e-4°. Unterstuetzt die Beobachtungs-Optionen (zodi…
-
POST
/v1/occultationsAuthBedeckungen von Planeten und Fixsternen durch den Mond ("kleine Finsternisse").
Findet alle Mond-Bedeckungen der Ziele im Zeitraum — global mit Typ (total/partial), Anfangs-/Endzeit und zentralem Erdort; mit "location" zusaetzlich lokale Sichtbarkeit und oertliche Kontaktzeiten (Immersion/Emersion). Ziele: Planeten (me…
Kartografie 3
-
POST
/v1/acg-linesAuthAstrokartographie-Linien (MC/IC/AC/DC + Aspektlinien) als Weltkarten-Polylinien.
Berechnet fuer jeden Koerper die vier ACG-Linien des Geburtsmoments: MC/IC als Meridiane, AC/DC als Horizontkurven (H-Parametrisierung — Nahtstellen mathematisch exakt, an der Datumsgrenze gesplittet). Optional Aspektlinien (z. B. 120° zu A…
-
POST
/v1/acg-nearAuthACG-Linien nach Naehe zu einem Ort: welche Linien wie nah liegen (km).
Serverseitige Entsprechung der Ort→Linie-Distanz (bisher nur clientseitig, turf.js). Baut dieselben Linien wie /v1/acg-lines (Achsen MC/IC/AC/DC, optional Aspektlinien) und liefert je Linie die kleinste Grosskreis-Distanz in km zum angegebe…
-
POST
/v1/paransAuthParans (Paranatellonta): Breitengrade, auf denen zwei Koerper gleichzeitig auf zwei Achsen stehen.
Die Verstaerkungs-Breiten der Astrokartographie: Koerper A auf MC oder IC, Koerper B gleichzeitig auf AC oder DC — geschlossene Loesung tan(φ) = −cos(RA_A − RA_B)/tan(δ_B). Validitaet beruecksichtigt Auf-/Untergangsrichtung. AC×AC u. ae. si…
Partnerschaft 1
Keine Treffer.