// astrology api
Astrology API by technique
AstroWay endpoints grouped by astrological technique — each page ships a runnable request, a parameters table, and the real credit cost.
POST /v1/chart
Natal-Chart-API
Verwandeln Sie einen einzigen Geburtsmoment mit einem einzigen POST in ein vollständiges, strukturiertes Geburtshoroskop — Planeten, Häuserspitzen, Aspekte und Achsendaten. Tropischer Tierkreis, dreizehn Häusersysteme, Swiss-Ephemeris-Präzision, JSON als Ausgabe.
POST /v1/synastry
Synastrie-API
Vergleichen Sie zwei Geburtshoroskope in einem Aufruf und erhalten Sie das Kreuzaspektgitter, das jede Kompatibilitätsfunktion antreibt — wer wen aspektiert, in welchem Winkel, mit welchem Orb, in welcher Richtung. Zwei Horoskope hinein, die Beziehung zwischen ihnen heraus.
POST /v1/transits
Transit-Chart-API
Erfassen Sie den Himmel zu einem beliebigen Zieldatum und legen Sie ihn mit einem einzigen POST über das natale Häusergerüst einer Person. Transitierende Planeten, die natalen Häuserspitzen, in die sie fallen, das Aspektgitter unter den transitierenden Körpern, dazu Parallelen und Antiszien — Swiss-Ephemeris-Präzision, JSON als Ausgabe.
POST /v1/composite
Composite-Chart-API
Verschmelzen Sie zwei Geburtshoroskope zu einem. Das Mittelpunkt-Komposit nimmt jedes Planetenpaar und die beiden Achsensätze, findet den Mittelpunkt von jedem und gibt ein einziges abgeleitetes Horoskop zurück, das die Beziehung als eigene Entität modelliert. Zwei Horoskope hinein, ein Komposit heraus, JSON.
POST /v1/progressions
Secondary-Progressions-API
Bewegen Sie das Geburtshoroskop symbolisch vorwärts: Ein Ephemeridentag der Planetenbewegung steht für ein Lebensjahr. Geben Sie ein Geburtshoroskop und ein Zieldatum an und erhalten Sie das direkte Horoskop — Planeten, Häuser, Aspekte — für dieses Alter. Swiss-Ephemeris-Präzision, JSON als Ausgabe.
POST /v1/solar-return
Solar-Return-API
Berechnen Sie das Horoskop für den exakten Augenblick, in dem die Sonne in einem gewählten Jahr zu ihrem natalen Grad zurückkehrt — der astrologische Geburtstag. Übergeben Sie ein Geburtshoroskop und ein Jahr und erhalten Sie das Solarrückkehr-Horoskop für diesen Zyklus. Tropisch, Sonne-zu-natale-Sonne, Swiss-Ephemeris-Präzision, JSON als Ausgabe.
POST /v1/lunar-return
Lunar-Return-API
Finden Sie den nächsten Moment, in dem der Mond an oder nach einem gewählten Datum zu seiner natalen Länge heimkehrt — etwa alle 27,3 Tage — und berechnen Sie das Horoskop dafür an einem Ort Ihrer Wahl. Übergeben Sie natale Daten und ein Startdatum und erhalten Sie das Lunarrückkehr-Horoskop. Swiss-Ephemeris-Präzision, JSON als Ausgabe.
POST /v1/draconic
Draconic-Chart-API
Verankern Sie den gesamten Tierkreis neu am aufsteigenden Mondknoten. Schieben Sie 0° Aries auf den natalen aufsteigenden Mondknoten und jeder Planet wird in nodaler — „drakonischer“ — Länge neu gelesen. Übergeben Sie ein Geburtshoroskop und erhalten Sie Planeten, Häuser und Aspekte, ausgedrückt im drakonischen Bezugssystem. Swiss-Ephemeris-Präzision, JSON als Ausgabe.
POST /v1/heliocentric
Heliocentric-Chart-API
Verlegen Sie den Beobachter zur Sonne. Statt des üblichen erdzentrierten Himmels gibt dies das Sonnensystem zurück, wie es von der Sonne aus gesehen wird — die Erde wird zu einem Körper, Mond und Aszendent fallen weg, und jeder Planet wird in heliozentrischer Länge angegeben. Übergeben Sie einen Moment und erhalten Sie das heliozentrische Horoskop. Swiss-Ephemeris-Präzision, JSON als Ausgabe.
POST /v1/relocation
Relocation-Chart-API
Behalten Sie die Planeten, verschieben Sie die Karte. Ein Relokationshoroskop hält jede natale planetare Länge exakt wie zur Geburt, baut aber das Häusergerüst — Aszendent, Medium Coeli, Häuserspitzen — für einen neuen Ort neu auf. Übergeben Sie natale Daten und einen Zielort und erhalten Sie beide Horoskope plus das Achsen-Delta. Swiss-Ephemeris-Präzision, JSON als Ausgabe.
POST /v1/astrocartography
Astrocartography-API
Die Astrokartografie nimmt einen einzigen Geburtsmoment und projiziert ihn auf den gesamten Planeten: Statt zu fragen, wo die Planeten am Himmel standen, fragt sie, wo auf der Erde jeder Planet angulär war. Der Endpunkt gibt die Liniengeometrie zurück, die Sie auf einer Weltkarte einzeichnen, um zu sehen, welche Längengrade welche planetare Energie aktivieren.
POST /v1/essential-dignities
Essential-Dignities-API
Essentielle Würden messen, wie behaglich jeder Planet in dem Zeichen und Grad sitzt, das er einnimmt. Dieser Endpunkt prüft jeden Körper durch das fünfteilige traditionelle Schema — Herrschaft, Erhöhung, Triplizität, Term und Gesicht — zusammen mit den zwei Schwächen und gibt sowohl eine Aufschlüsselung pro Planet als auch eine einzige gewichtete Gesamtsumme zurück.
POST /v1/fixed-stars
Fixed-Stars-API
Jenseits der wandernden Planeten liest die ältere Schicht der Astrologie die Fixsterne — Regulus, Spica, Algol, Aldebaran und ihresgleichen. Dieser Endpunkt durchsucht ein Geburtshoroskop nach engen Konjunktionen zu diesen Hauptsternen und gibt jeden Kontakt mit seinem Orb zurück, sodass Sie den überlieferten Charakter eines Sterns in eine Deutung einflechten können.
POST /v1/arabic-parts
Arabic-Parts-API
Die arabischen Punkte, oder hellenistischen Lose, sind berechnete Punkte, die durch Arithmetik am Horoskop abgeleitet und nicht direkt am Himmel abgelesen werden. Dieser Endpunkt berechnet den Glückspunkt, den Geist-Punkt, den Eros-Punkt und die übrigen aus Formeln über dem Aszendenten und zwei Planeten und behandelt dabei die Umkehrung zwischen Tag- und Nachtgeburt, die die echte Los-Praxis verlangt.
POST /v1/midpoint-trees
Midpoint-Trees-API
Die Kosmobiologie liest ein Horoskop über Halbsummen: den Grad genau in der Mitte zwischen zwei Planeten und jeden dritten Planeten, der darauf landet. Dieser Endpunkt berechnet die Halbsummenstruktur eines Horoskops, stellt den Halbsummenbaum für jeden Planeten zusammen und kennzeichnet die Symmetrien, die die Tradition des 90°-Zifferblatts als die aktivsten Punkte des Horoskops behandelt.
POST /v1/parallel-aspects
Declination-Aspects-API
Die meiste Aspektarbeit findet entlang der Ekliptik in der Länge statt, aber zwei Körper können sich auch über die Deklination zueinander verhalten — ihren Abstand nördlich oder südlich des Himmelsäquators. Dieser Endpunkt arbeitet in dieser zweiten Dimension, findet Parallelen und Kontraparallelen, die Deklinations-Entsprechungen von Konjunktion und Opposition, und vermerkt, wenn ein Körper außerhalb der Grenzen (out of bounds) läuft.
POST /v1/vedic/dashas/vimshottari/maha
Vimshottari-Mahadasha-API
Vimshottari ist der 120-jährige Planetenperioden-Zyklus, der das vedische Timing verankert. Dieser Endpunkt liest die Position des siderischen Mondes bei der Geburt, lokalisiert das von ihm eingenommene Nakshatra und entrollt von diesem einen Punkt aus die geordnete Kette der Mahadashas — die großen Lebensperioden, jede von einem der neun Grahas regiert — mit den exakten Kalenderdaten, die sie begrenzen.
POST /v1/vedic-divisional
Divisional-Charts-API
Varga-Charts sind die Vergrößerungslinsen des Jyotish: Jede unterteilt jedes Zeichen in eine gewählte Harmonik und bildet die Planeten auf ein feineres Raster ab, das zu einem Lebensbereich spricht. Dieser Endpunkt nimmt einen Geburtsmoment und eine angeforderte Teilung — D1 bis D60 — und gibt zurück, wohin jeder Planet in dieser Varga fällt.
POST /v1/vedic/shadbala/full
Shadbala-API
Shadbala — wörtlich „sechsfache Stärke“ — ist die klassische Methode, um zu quantifizieren, wie viel ein Planet seine Versprechen in einem Horoskop tatsächlich einlösen kann. Dieser Endpunkt berechnet die Gesamtstärke jedes Grahas als Summe seiner sechs Bestandteils-Balas und gibt einen Wert pro Planet in Rupas zurück, sodass Sie die Planeten danach einordnen können, wie stark sie zum Handeln positioniert sind.
POST /v1/numerology/pythagorean/life-path
Numerologie-API
Dieser Endpunkt berechnet die pythagoreische Lebenszahl (Life Path) — die einzelne Ziffer, die ein Geburtsdatum auf seine numerologische Kernsignatur verdichtet. Sie ist eine Berechnung innerhalb einer breiteren Suite, die vier Systeme und jeweils rund zehn Berechnungen umfasst, und läuft als reine Arithmetik ohne Ephemeride und ohne jede Astrologie.
POST /v1/tarot/rider-waite/draw/three-card
Tarot-API
Dieser Endpunkt führt eine geseedete, reproduzierbare Ziehung aus dem 78-Karten-Rider-Waite-Smith-Deck für die Drei-Karten-Legung durch. Er gibt die Metadaten der Legung, den ganzzahligen Seed, der das Mischen steuerte, und die gezogenen Karten mit ihren Positionen, Ausrichtungen und Bedeutungen zurück — sodass jede Legung durch erneutes Übergeben des Seeds exakt wiederholt werden kann.
POST /v1/human-design
Human-Design-API
Dieser Endpunkt berechnet den Human-Design-Bodygraph aus einem einzigen Geburtsereignis. Er kombiniert das natale Personality-Chart mit dem Design-Chart — genommen etwa 88° Sonnenbogen vor der Geburt, etwa drei Monate früher — und leitet die mechanischen Elemente des Bodygraphs ab: Type, Strategy, Authority, Profile, Zentren, Kanäle, Tore und das Inkarnationskreuz.
POST /v1/horoscope/daily
AI-Horoscope-API
Dieser Endpunkt erzeugt ein geschriebenes Tageshoroskop für ein Sternzeichen an einem gegebenen Datum, indem er unser LLM-Gateway aufruft. Er gibt den Horoskoptext, einen Haftungsausschluss, das Modell, das ihn erzeugt hat, und die Sprache der Ausgabe zurück. Anders als die Berechnungsendpunkte ist dies erzeugte Orientierung und kein deterministisches Ergebnis.