Skip to content

Deklinationen ​

Ein Horoskop ist eine Projektion auf die Ekliptik, und diese Projektion wirft eine Achse weg. Deklination ist das, was übrig bleibt, wenn dieselben Körper vom Himmelsäquator aus gemessen werden — die zweite Tabelle einer gedruckten Ephemeride und die Koordinate, die in keinem Aspektraster vorkommt.

Auf dieser Achse leben zwei Dinge, und keines davon ist in einem Tierkreishoroskop sichtbar:

  • Parallelen und Kontraparallelen. Zwei Körper auf derselben Deklination bilden eine Parallele, die wie eine Konjunktion wirkt. Derselbe Abstand vom Äquator auf gegenüberliegenden Seiten ist eine Kontraparallele, die wie eine Opposition wirkt. Beide können zwischen Körpern auftreten, die in der Länge überhaupt keinen Aspekt bilden.
  • Out of Bounds. Ein Körper jenseits der maximalen Deklination der Sonne selbst. Der Mond ist das einige Tage im Monat rund um einen großen Mondwendepunkt; Merkur, Venus, Mars und Pluto in Abständen. Es ist eine reale, viel diskutierte Bedingung, und kaum eine Endanwender-Software meldet sie.

Erforderliches Modul

Beide Endpunkte erfordern das Modul declination:calc. Es ist in jedem Tarif enthalten und wird nicht separat verkauft.

Deklinationen für einen Moment ​

bash
curl -X POST "https://api.astroapi.cloud/api/calc/declination" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    },
    "orb": 1
  }'

Parameter ​

ParameterTypErforderlichBeschreibung
dateTimestringJaYYYY-MM-DDTHH:mm, lokale Uhrzeit an location
locationobjectJalatitude, longitude und eine IANA-timezone
pointsarrayNeinZu berechnende Punkte. Standard sind die zehn Körper, beide Knoten und beide Liliths
orbnumberNeinOrbis für Parallelen und Kontraparallelen, 0–3 Grad. Standard 1
moonCenterstringNeintopocentric (Standard) oder geocentric

Ein Orbis hier ist nicht ein Orbis dort

Ein Deklinationsorbis ist weit enger als ein Längenorbis. Ein Grad ist die Konvention und der Standardwert; jenseits von zwei Grad ist fast alles zu irgendetwas parallel.

Antwort ​

json
{
  "data": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "declination": 23.32,
        "declinationDms": [23, 19, 12],
        "rightAscension": 84.1,
        "latitude": 0,
        "speedDeclination": 0.04,
        "outOfBounds": false,
        "hemisphere": "north"
      },
      "moon": {
        "pointId": "moon",
        "declination": -18.44,
        "declinationDms": [18, 26, 24],
        "rightAscension": 312.7,
        "latitude": -4.61,
        "speedDeclination": -3.1,
        "outOfBounds": false,
        "hemisphere": "south"
      }
    },
    "aspects": [
      {
        "pointA": "venus",
        "pointB": "mars",
        "aspect": "parallel",
        "orb": 0.31,
        "applying": true,
        "declinationA": 21.08,
        "declinationB": 21.39
      }
    ],
    "extremes": {
      "northernmost": "sun",
      "southernmost": "moon",
      "outOfBoundsCount": 0
    },
    "obliquity": 23.4405
  }
}

declinationDms ist der Betrag als [Grad, Minuten, Sekunden]; die Seite steht in hemisphere und im Vorzeichen von declination. speedDeclination ist Grad pro Tag, und negativ bedeutet südwärts — daran erkennen Sie, ob eine Parallele zu- oder abläuft, dieselbe Frage, die applying für einen Längenaspekt beantwortet.

Die Out-of-Bounds-Grenze ​

obliquity ist die wahre Schiefe der Ekliptik am angefragten Datum — die maximale Deklination der Sonne selbst und damit die Grenze, gegen die outOfBounds beurteilt wurde. Sie wird zurückgegeben, damit ein Client das Band zeichnen kann, ohne eine eigene Grenze zu erfinden.

Der konventionelle Wert ist 23°26'. Der tatsächliche bewegt sich: Nutation verschiebt ihn um bis zu neun Bogensekunden, und das genügt, um einen Grenzfall in die eine oder andere Richtung zu entscheiden. Ein Vergleich mit der zurückgegebenen obliquity und ein Vergleich mit einem fest verdrahteten 23.4367 sind sich über einen Körper genau auf der Linie uneins.

Die Sonne ist nie out of bounds

Per Definition — die Bedingung lautet „jenseits der Sonne". Ein Körper genau auf der Grenze ist nicht out of bounds; er muss darüber hinaus sein.

Deklination über einen Zeitraum ​

Die andere Hälfte, und der Grund, warum dies ein eigener Endpunkt ist statt eines Feldes an einem Radix: Ein Deklinationsdiagramm ist eine Reihe über die Zeit, und die Daten, an denen ein Körper die Out-of-Bounds-Grenze überschreitet, sind das, was ein Astrologe tatsächlich aufschreibt.

bash
curl -X POST "https://api.astroapi.cloud/api/calc/declination/series" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2025-01-01",
    "endDate": "2025-12-31",
    "stepDays": 2,
    "points": ["sun", "moon", "mercury", "venus", "mars", "pluto"]
  }'

Parameter ​

ParameterTypErforderlichBeschreibung
startDatestringJaYYYY-MM-DD oder ISO 8601
endDatestringJaYYYY-MM-DD oder ISO 8601
stepDaysnumberNeinTage zwischen Reihenpunkten, 0,25–30. Standard 1
pointsarrayNeinZu zeichnende Punkte. Standardwerte wie oben

Antwort ​

json
{
  "data": {
    "startDate": "2025-01-01T00:00:00.000Z",
    "endDate": "2025-12-31T23:59:00.000Z",
    "stepDays": 2,
    "points": ["sun", "moon", "mercury", "venus", "mars", "pluto"],
    "series": {
      "moon": [
        ["2025-01-01T00:00:00.000Z", -14.02],
        ["2025-01-03T00:00:00.000Z", 8.71]
      ]
    },
    "crossings": [
      {
        "pointId": "moon",
        "date": "2025-03-06T07:41:12.000Z",
        "direction": "out",
        "declination": 23.4392
      },
      {
        "pointId": "moon",
        "date": "2025-03-10T02:18:55.000Z",
        "direction": "in",
        "declination": 23.4392
      }
    ]
  }
}

Die Überschreitungen werden nicht mit stepDays abgetastet ​

Ein Ausflug des Mondes über die Grenze dauert ein paar Tage. Eine mit Wochenschritt gezeichnete Reihe würde einfach darüber hinwegschreiten — deshalb werden die Überschreitungen auf einem feineren Raster gesucht, als die Reihe zurückgegeben wird, und jede wird anschließend gegen die Ephemeride auf die Sekunde genau verfeinert.

Die praktische Folge: Ein weiter stepDays kostet Sie die Form der Kurve, nie ein Überschreitungsdatum. Fordern Sie die Auflösung an, die das Diagramm braucht, und nicht mehr.

Die Reihengrenze ​

Eine Reihe ist auf 400 Punkte begrenzt. Ein Jahr mit Tagesschritt sind 365; ein Jahrzehnt mit Tagesschritt sind 3653 und kommt als 400 mit dem Rat zurück, den Schritt zu vergrößern:

json
{
  "error": "That range at a 1-day step is 3654 points; the limit is 400. Widen stepDays or shorten the range."
}

Dies ist so oder so eine Anfrage. Dieselbe Tabelle aus 400 Einzelaufrufen aufzubauen kostet 400 Anfragen Ihres Monatskontingents; der Reihen-Endpunkt berechnet sie in einem einzigen Durchgang und zählt als eine.

Deklination in einem Radix ​

Ab API-Version 2026-09-10 trägt jeder Punkt einer Radix-Antwort ebenfalls declination und outOfBounds, sodass ein Rad einen Out-of-Bounds-Körper ohne einen zweiten Aufruf markieren kann:

bash
curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "X-Api-Version: 2026-09-10" \
  -H "Content-Type: application/json" \
  -d '{ "dateTime": "1990-06-15T14:30", "location": { "latitude": 52.37, "longitude": 4.89, "timezone": "Europe/Amsterdam" } }'

Ein Aufrufer auf einer älteren Version behält die Antwortform, die er immer erhalten hat. Siehe API-Versionierung dazu, wie man eine Version festlegt.

Die Radix-Antwort trägt nur diese beiden Felder. Parallelen, Kontraparallelen, Rektaszension, Deklinationsgeschwindigkeit und die Reihe liegen alle auf den Endpunkten oben.

Was dies nicht ist ​

Hier gibt es keine 3D-Ansicht, und das ist Absicht. Das richtige Bild der Deklination ist eine Linie gegen eine Achse; eine Himmelskugel macht es hübscher, ohne es klarer zu machen.

AstroAPI Documentation