Geboortehoroscopen

Bereken volledige geboortehoroscopen met planetaire posities, huiscuspen en aspecten.

Basisberekening

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"
    }
  }'

Parameters

Parameter	Type	Verplicht	Beschrijving
dateTime	string	Ja	Datum/tijd in YYYY-MM-DDTHH:mm formaat
location.latitude	number	Ja	Breedtegraad (-90 tot 90)
location.longitude	number	Ja	Lengtegraad (-180 tot 180)
location.timezone	string	Ja	IANA tijdzone-identifier
houseSystem	string	Nee	Huizensysteem (standaard: "placidus")
points	array	Nee	Hemellichamen om te berekenen (zie Beschikbare punten hieronder)
orbs	object	Nee	Aangepaste orb-waarden per aspecttype (bijv. { "conjunction": 8, "opposition": 6 })
language	string	Nee	Taalcode voor tekstinhoud (standaard: "en")
includeText	boolean	Nee	Interpretatietekst opnemen (standaard: false)
includeReadableEntities	boolean	Nee	Leesbare entiteitnamen opnemen (standaard: false)

Huizensystemen

• placidus - Placidus (standaard)
• koch - Koch
• equal - Gelijke Huizen
• whole - Heel Teken
• campanus - Campanus
• regiomontanus - Regiomontanus
• porphyry - Porphyrius

Response

{
  "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?..."
    }
  }
}

Huiscuspen

Elk cusp-object bevat longitude (ecliptische graden), longitudeDms (graden/minuten/seconden) en sign (dierenriemteken-ID). De eerste cusp (cusps[0]) is de Ascendant. De ascmc-array bevat de Ascendant, MC, ARMC en Vertex.

Beschikbare punten

Gebruik de points parameter om te kiezen welke hemellichamen berekend worden. Zonder deze parameter wordt de standaardset gebruikt.

Standaardpunten

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

Alle beschikbare punten

Punt-ID	Beschrijving
sun	Zon
moon	Maan
mercury	Mercurius
venus	Venus
mars	Mars
jupiter	Jupiter
saturn	Saturnus
uranus	Uranus
neptune	Neptunus
pluto	Pluto
meanNode	Gemiddelde Noordknoop
trueNode	Ware Noordknoop
meanApogee	Gemiddelde Zwarte Maan Lilith
osculatingApog	Ware Zwarte Maan Lilith
chiron	Chiron
pholus	Pholus
ceres	Ceres
pallas	Pallas
juno	Juno
vesta	Vesta
interpolatedLunarApogee	Geinterpoleerde Maanschijnpunt (Natural Apogee)
interpolatedLunarPerigee	Geinterpoleerde Maanperigeum (Priapus)
earth	Aarde

Voorbeeld: Alleen Zon en Mars berekenen

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"]
  }'

De response bevat sun en mars in het points object, en alle vier de hoeken in het angles object:

{
  "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": [ ... ]
  }
}

Hoeken

Alle vier de hoeken (ascendant, descendant, midheaven, imumCoeli) worden altijd meegeleverd in het angles object, ongeacht de points parameter. Hoeken worden afgeleid uit huisberekeningen, niet uit de efemeride, en hebben daarom een eenvoudigere structuur (geen snelheid of retrograde data). De ascmc-array in de houses response bevat ook altijd de ruwe hoeklengtes.

Maan & Zon

Bereken maanfase, illuminatie, opkomst-/ondergangstijden en zonpositiegegevens.

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"
    }
  }'

Parameters

Parameter	Type	Verplicht	Beschrijving
dateTime	string	Ja	Datum/tijd in YYYY-MM-DDTHH:mm formaat
location.latitude	number	Ja	Breedtegraad (-90 tot 90)
location.longitude	number	Ja	Lengtegraad (-180 tot 180)
location.timezone	string	Ja	IANA tijdzone-identifier

Vereiste module

Dit endpoint vereist de module:moon module.

Response

{
  "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
        }
      }
    }
  }
}

Berekeningsprecisie

AstroAPI leest rechtstreeks NASA's JPL DE442 efemeride voor sub-milliboogseconde planetaire posities. Zie de pagina Berekeningsprecisie voor alle details over onze gegevensbronnen en correcties.