Geburtshoroskope

Berechnen Sie vollständige Geburtshoroskope mit Planetenpositionen, Hauskuppen und Aspekten.

Grundlegende Berechnung

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Parameter

Parameter	Typ	Erforderlich	Beschreibung
dateTime	string	Ja	Datum/Uhrzeit im Format YYYY-MM-DDTHH:mm
location.latitude	number	Ja	Breitengrad (-90 bis 90)
location.longitude	number	Ja	Längengrad (-180 bis 180)
location.timezone	string	Ja	IANA-Zeitzonenkennung
houseSystem	string	Nein	Häusersystem (Standard: "placidus")
points	array	Nein	Zu berechnende Himmelspunkte (siehe Verfügbare Punkte unten)
orbs	object	Nein	Benutzerdefinierte Orbis-Werte pro Aspekttyp (z. B. { "conjunction": 8, "opposition": 6 })
language	string	Nein	Sprachcode für Textinhalte (Standard: "en")
includeText	boolean	Nein	Deutungstext einbeziehen (Standard: false)
includeReadableEntities	boolean	Nein	Lesbare Entitätstitel einbeziehen (Standard: false)

Häusersysteme

• placidus - Placidus (Standard)
• koch - Koch
• equal - Gleiche Häuser
• whole - Ganzzodiak
• campanus - Campanus
• regiomontanus - Regiomontanus
• porphyry - Porphyry

Antwort

{
  "data": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "longitude": 84.5,
        "sign": "gemini",
        "signTitle": "Gemini",
        "degreesInSign": 24.5,
        "degreesInSignDms": [24, 30, 0],
        "houseNumber": 10,
        "houseId": "house-10",
        "retrograde": false,
        "pointTitle": "Sun",
        "houseTitle": "10th House"
      },
      "moon": {
        "pointId": "moon",
        "longitude": 245.2,
        "sign": "sagittarius",
        "signTitle": "Sagittarius",
        "degreesInSign": 5.2,
        "degreesInSignDms": [5, 12, 0],
        "houseNumber": 4,
        "houseId": "house-4",
        "retrograde": false,
        "pointTitle": "Moon",
        "houseTitle": "4th House"
      }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", ... },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", ... },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", ... }
    },
    "houses": {
      "cusps": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 210.3, "longitudeDms": { "degrees": 210, "minutes": 18, "seconds": 0 }, "sign": "scorpio" }
      ],
      "ascmc": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 270.2, "longitudeDms": { "degrees": 270, "minutes": 12, "seconds": 0 }, "sign": "capricorn" }
      ]
    },
    "aspects": [
      {
        "pointA": "sun",
        "pointB": "moon",
        "aspect": "opposition",
        "angle": 160.7,
        "orb": 0.7,
        "applying": false,
        "pointATitle": "Sun",
        "pointBTitle": "Moon",
        "aspectTitle": "Opposition"
      }
    ],
    "chart": {
      "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..."
    }
  }
}

Hauskuppen

Jedes Kuppen-Objekt enthält longitude (ekliptikale Grade), longitudeDms (Grad/Minuten/Sekunden) und sign (Tierkreiszeichen-ID). Die erste Kuppe (cusps[0]) ist der Aszendent. Das ascmc-Array enthält den Aszendenten, MC, ARMC und Vertex.

Verfügbare Punkte

Verwenden Sie den Parameter points, um auszuwählen, welche Himmelspunkte berechnet werden sollen. Wenn er weggelassen wird, wird der Standardsatz verwendet.

Standardpunkte

sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, meanNode, trueNode, meanApogee, osculatingApog

Alle verfügbaren Punkte

Punkt-ID	Beschreibung
sun	Sonne
moon	Mond
mercury	Merkur
venus	Venus
mars	Mars
jupiter	Jupiter
saturn	Saturn
uranus	Uranus
neptune	Neptun
pluto	Pluto
meanNode	Mittlerer Mondknoten (Nord)
trueNode	Wahrer Mondknoten (Nord)
meanApogee	Mittlerer Schwarzer Mond Lilith
osculatingApog	Wahrer Schwarzer Mond Lilith
chiron	Chiron
pholus	Pholus
ceres	Ceres
pallas	Pallas
juno	Juno
vesta	Vesta
interpolatedLunarApogee	Interpoliertes Mondapogäum (Natürliches Apogäum)
interpolatedLunarPerigee	Interpoliertes Mondperigäum (Priapus)
earth	Erde

Beispiel: Nur Sonne und Mars berechnen

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "points": ["sun", "mars"]
  }'

Die Antwort enthält sun und mars im points-Objekt sowie alle vier Winkel im angles-Objekt:

{
  "data": {
    "points": {
      "sun": { "pointId": "sun", "longitude": 84.5, "sign": "gemini", ... },
      "mars": { "pointId": "mars", "longitude": 12.3, "sign": "aries", ... }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", ... },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", ... },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", ... }
    },
    "houses": { ... },
    "aspects": [ ... ]
  }
}

Winkel

Alle vier Winkel (ascendant, descendant, midheaven, imumCoeli) sind immer im angles-Objekt enthalten, unabhängig vom points-Parameter. Winkel werden aus Häuserberechnungen abgeleitet, nicht aus Ephemeriden, weshalb sie eine einfachere Struktur haben (keine Geschwindigkeits- oder Rückläufigkeitsdaten). Das ascmc-Array in der houses-Antwort enthält ebenfalls immer die rohen Winkel-Längengrade.

Mond & Sonne

Berechnen Sie Mondphase, Beleuchtung, Auf-/Untergangszeiten und Sonnenpositionsdaten.

POST /api/calc/moon-sun

curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    }
  }'

Parameter

Parameter	Typ	Erforderlich	Beschreibung
dateTime	string	Ja	Datum/Uhrzeit im Format YYYY-MM-DDTHH:mm
location.latitude	number	Ja	Breitengrad (-90 bis 90)
location.longitude	number	Ja	Längengrad (-180 bis 180)
location.timezone	string	Ja	IANA-Zeitzonenkennung

Erforderliches Modul

Dieser Endpunkt erfordert das Modul module:moon.

Antwort

{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

Berechnungsgenauigkeit

AstroAPI liest die JPL DE442-Ephemeride der NASA direkt aus, um planetare Positionen mit Sub-Millibogensekunden-Genauigkeit zu berechnen. Auf der Seite Berechnungsgenauigkeit finden Sie alle Details zu unseren Datenquellen und Korrekturen.