Skip to content

Sonnen- & Mondrückkehr

Berechnen Sie Sonnenrückkehr-(Geburtstaghoroskop) und Mondrückkehr-Horoskope. Rückkehr-Horoskope zeigen die Planetenpositionen zum genauen Zeitpunkt, zu dem ein Planet zu seiner natalen Position zurückkehrt, und bieten Prognoseinblicke für das kommende Jahr oder den kommenden Monat.


Sonnenrückkehr

Ein Sonnenrückkehr-Horoskop wird für den genauen Moment berechnet, in dem die Sonne jedes Jahr zu ihrem natalen Grad zurückkehrt – was in der Nähe des Geburtstags geschieht. Es wird verwendet, um Themen für das kommende Jahr vorherzusagen.

Erforderliches Modul

Erfordert das Modul solar-return:calc.

bash
curl -X POST "https://api.astroapi.cloud/api/calc/solar-return" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDateTime": "1990-06-15T14:30",
    "birthLocation": {
      "longitude": -0.1278,
      "latitude": 51.5074,
      "timezone": "Europe/London"
    },
    "returnYear": 2024,
    "houseSystem": "placidus",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

Parameter

ParameterTypErforderlichBeschreibung
birthDateTimestringJaGeburtsdatum und -uhrzeit im Format YYYY-MM-DDTHH:mm
birthLocationobjectJaGeburtsort (siehe Ortsobjekt unten)
returnYearnumberNeinJahr der Sonnenrückkehr (Standard: aktuelles Jahr)
houseSystemstringNeinHäusersystem (Standard: "placidus")
languagestringNeinSprachcode für Textinhalte (Standard: "en")
includeTextbooleanNeinInterpretationstext einschließen (Standard: false)
includeReadableEntitiesbooleanNeinLesbare Entitätstitel einschließen (Standard: false)
pointsarrayNeinEinzubeziehende Himmelspunkte
orbsobjectNeinBenutzerdefinierte Orb-Werte pro Aspekttyp

Ortsobjekt

json
{
    "longitude": -0.1278,
    "latitude": 51.5074,
    "timezone": "Europe/London"
}

Antwort

json
{
    "data": {
        "returnYear": 2024,
        "returnDate": "2024-06-15T08:42:17Z",
        "aspects": [
            {
                "point1": "sun",
                "point2": "moon",
                "aspect": "trine",
                "orb": 1.8,
                "applying": false
            }
        ],
        "points": {
            "sun": {
                "longitude": 84.71,
                "latitude": 0.0,
                "sign": "gemini",
                "house": 10,
                "retrograde": false
            },
            "moon": {
                "longitude": 324.15,
                "latitude": -2.3,
                "sign": "aquarius",
                "house": 6,
                "retrograde": false
            }
        },
        "houses": {
            "1": { "cusp": 195.4, "sign": "libra" },
            "10": { "cusp": 84.5, "sign": "gemini" }
        },
        "charts": {
            "solarReturn": {
                "title": "Solar Return Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "biWheel": {
                "title": "Solar Return / Natal Bi-wheel",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "natal": {
                "title": "Natal Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            }
        }
    }
}

Antwortfelder

FeldTypBeschreibung
returnYearnumberDas Jahr dieser Sonnenrückkehr
returnDatestringGenaue UTC-Zeit der Sonnenrückkehr
aspectsarrayAspekte innerhalb des Sonnenrückkehr-Horoskops
pointsobjectPlanetenpositionen im Sonnenrückkehr-Horoskop
housesobjectHauskuppen des Sonnenrückkehr-Horoskops
charts.solarReturnobjectBild-URL des Sonnenrückkehr-Horoskops
charts.biWheelobjectDoppel-Rad mit Sonnenrückkehr über dem Geburtshoroskop
charts.natalobjectBild-URL des Geburtshoroskops

Mondrückkehr

Ein Mondrückkehr-Horoskop wird für den genauen Moment berechnet, in dem der Mond jeden Monat zu seinem natalen Grad zurückkehrt (ungefähr alle 27,3 Tage). Es wird verwendet, um Themen für den kommenden Monat vorherzusagen.

Erforderliches Modul

Erfordert das Modul lunar-return:calc.

bash
curl -X POST "https://api.astroapi.cloud/api/calc/lunar-return" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDateTime": "1990-06-15T14:30",
    "birthLocation": {
      "longitude": -0.1278,
      "latitude": 51.5074,
      "timezone": "Europe/London"
    },
    "returnDate": "2024-06-01",
    "houseSystem": "placidus",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

Parameter

ParameterTypErforderlichBeschreibung
birthDateTimestringJaGeburtsdatum und -uhrzeit im Format YYYY-MM-DDTHH:mm
birthLocationobjectJaGeburtsort (Längengrad, Breitengrad, Zeitzone)
returnDatestringNeinStartdatum (YYYY-MM-DD), ab dem die nächste Mondrückkehr gesucht wird (Standard: jetzt)
houseSystemstringNeinHäusersystem (Standard: "placidus")
languagestringNeinSprachcode für Textinhalte (Standard: "en")
includeTextbooleanNeinInterpretationstext einschließen (Standard: false)
includeReadableEntitiesbooleanNeinLesbare Entitätstitel einschließen (Standard: false)
pointsarrayNeinEinzubeziehende Himmelspunkte
orbsobjectNeinBenutzerdefinierte Orb-Werte pro Aspekttyp

Antwort

json
{
    "data": {
        "returnDate": "2024-06-12T03:18:44Z",
        "aspects": [
            {
                "point1": "moon",
                "point2": "venus",
                "aspect": "sextile",
                "orb": 0.9,
                "applying": true
            }
        ],
        "points": {
            "moon": {
                "longitude": 245.2,
                "latitude": -3.1,
                "sign": "sagittarius",
                "house": 4,
                "retrograde": false
            }
        },
        "houses": {
            "1": { "cusp": 130.8, "sign": "leo" },
            "4": { "cusp": 240.5, "sign": "sagittarius" }
        },
        "charts": {
            "lunarReturn": {
                "title": "Lunar Return Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "biWheel": {
                "title": "Lunar Return / Natal Bi-wheel",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "natal": {
                "title": "Natal Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            }
        }
    }
}

Antwortfelder

FeldTypBeschreibung
returnDatestringGenaue UTC-Zeit der Mondrückkehr
aspectsarrayAspekte innerhalb des Mondrückkehr-Horoskops
pointsobjectPlanetenpositionen im Mondrückkehr-Horoskop
housesobjectHauskuppen des Mondrückkehr-Horoskops
charts.lunarReturnobjectBild-URL des Mondrückkehr-Horoskops
charts.biWheelobjectDoppel-Rad mit Mondrückkehr über dem Geburtshoroskop
charts.natalobjectBild-URL des Geburtshoroskops

Häusersysteme

Beide Endpunkte unterstützen dieselben Häusersysteme wie Geburtshoroskop-Berechnungen:

WertName
placidusPlacidus (Standard)
kochKoch
equalGleiche Häuser
wholeGanzzodiak
campanusCampanus
regiomontanusRegiomontanus
porphyryPorphyry

Standort für Rückkehr-Horoskope

Viele Astrologen verwenden den Ort, an dem sich die Person zum Zeitpunkt der Rückkehr tatsächlich befindet, anstatt des Geburtsortes. Übergeben Sie den aktuellen Wohn- oder Reiseort in birthLocation, wenn Sie standortbezogene Rückkehr-Horoskope wünschen.

AstroAPI Documentation