Skip to content

Maankalender

Bereken maanfase-informatie, Void of Course-perioden, tekenransits en aankomende maanaspecten.

Dagdetail

Haal gedetailleerde maaninformatie op voor een specifieke dag:

bash
curl -X POST "https://api.astroapi.cloud/api/calc/moon-calendar/day" \
  -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"
    },
    "aspects": ["conjunction", "sextile", "square", "trine", "opposition"]
  }'

Datumbereik

Haal een maankalenderoverzicht op voor een datumbereik (max 31 dagen):

bash
curl -X POST "https://api.astroapi.cloud/api/calc/moon-calendar/range" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2024-06-01",
    "endDate": "2024-06-30",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    },
    "aspects": ["conjunction", "sextile", "square", "trine", "opposition"]
  }'

Parameters

Dag-endpoint

ParameterTypeVerplichtBeschrijving
dateTimestringJaDatum en tijd in YYYY-MM-DDTHH:mm formaat
locationobjectJaLocatie met latitude, longitude, timezone
aspectsarrayNeeAspecten om mee te nemen voor VOC-berekening

Bereik-endpoint

ParameterTypeVerplichtBeschrijving
startDatestringJaStartdatum in YYYY-MM-DD formaat
endDatestringJaEinddatum in YYYY-MM-DD formaat (max 31 dagen)
locationobjectJaLocatie met latitude, longitude, timezone
aspectsarrayNeeAspecten om mee te nemen voor VOC-berekening

Beschikbare aspecten

  • conjunction - 0 graden
  • sextile - 60 graden
  • square - 90 graden
  • trine - 120 graden
  • opposition - 180 graden

Dagresponse

json
{
  "data": {
    "date": "2024-06-15",
    "moon": {
      "sign": "leo",
      "signEntry": "2024-06-15T08:23:00Z",
      "signExit": "2024-06-17T14:45:00Z",
      "phase": {
        "name": "Waxing Gibbous",
        "illumination": 0.72,
        "age": 9.3
      }
    },
    "voidOfCourse": {
      "isVoid": true,
      "start": "2024-06-15T18:45:00Z",
      "end": "2024-06-17T14:45:00Z",
      "durationMinutes": 2640,
      "lastAspect": {
        "planet": "mars",
        "aspect": "trine",
        "exactTime": "2024-06-15T18:45:00Z"
      },
      "nextSign": "virgo"
    },
    "upcomingAspects": [
      {
        "planet": "venus",
        "aspect": "sextile",
        "exactTime": "2024-06-15T14:30:00Z",
        "applying": true
      },
      {
        "planet": "mars",
        "aspect": "trine",
        "exactTime": "2024-06-15T18:45:00Z",
        "applying": true
      }
    ]
  }
}

Bereikresponse

json
{
  "data": {
    "startDate": "2024-06-01",
    "endDate": "2024-06-30",
    "phases": [
      {
        "type": "new_moon",
        "date": "2024-06-06T12:37:00Z",
        "sign": "gemini"
      },
      {
        "type": "first_quarter",
        "date": "2024-06-14T05:18:00Z",
        "sign": "virgo"
      },
      {
        "type": "full_moon",
        "date": "2024-06-22T01:08:00Z",
        "sign": "capricorn"
      },
      {
        "type": "last_quarter",
        "date": "2024-06-28T21:53:00Z",
        "sign": "aries"
      }
    ],
    "signTransits": [
      {
        "sign": "gemini",
        "entry": "2024-06-01T03:15:00Z",
        "exit": "2024-06-03T08:45:00Z"
      },
      {
        "sign": "cancer",
        "entry": "2024-06-03T08:45:00Z",
        "exit": "2024-06-05T15:20:00Z"
      }
    ],
    "voidPeriods": [
      {
        "start": "2024-06-02T15:30:00Z",
        "end": "2024-06-03T08:45:00Z",
        "durationMinutes": 1035,
        "lastAspect": {
          "planet": "saturn",
          "aspect": "square"
        },
        "fromSign": "gemini",
        "toSign": "cancer"
      }
    ]
  }
}

Void of Course Maan

De Void of Course (VOC) Maan is de periode waarin de Maan geen belangrijke aspecten meer maakt met planeten voordat deze een nieuw teken binnengaat. Deze periode wordt traditioneel als ongunstig beschouwd voor het starten van nieuwe ondernemingen.

Hoe VOC wordt berekend

  1. De huidige positie en het teken van de Maan worden bepaald
  2. Het exacte moment waarop de Maan het volgende teken binnengaat wordt berekend
  3. Alle aspecten tussen de Maan en grote planeten worden gevonden tot de tekenwissel
  4. Het laatste aspect markeert het begin van de VOC-periode
  5. De VOC-periode eindigt wanneer de Maan het nieuwe teken binnengaat

VOC-gegevensvelden

VeldBeschrijving
isVoidOf de Maan momenteel void of course is
startWanneer de VOC-periode begon (tijdstip laatste aspect)
endWanneer VOC eindigt (Maan gaat nieuw teken binnen)
durationMinutesDuur van de VOC-periode in minuten
lastAspectDetails van het laatst gemaakte aspect
nextSignHet teken waar de Maan als volgende in komt

Toepassingen

  • Verkiezingsastrologie: Vermijd het starten van belangrijke activiteiten tijdens VOC Maan
  • Maanfaseplanning: Volg optimale tijdstippen voor activiteiten op basis van maanfasen
  • Astrologische kalenders: Toon maantekentransits en -fasen
  • Rituele timing: Plan activiteiten afgestemd op maancycli

AstroAPI Documentation