Moon Calendar

Calculate moon phase information, Void of Course periods, sign transits, and upcoming lunar aspects.

Day Detail

Get detailed moon information for a specific day:

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

Date Range

Get moon calendar overview for a date range (max 31 days):

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

Day Endpoint

Parameter	Type	Required	Description
dateTime	string	Yes	Date and time in YYYY-MM-DDTHH:mm format
location	object	Yes	Location with latitude, longitude, timezone
aspects	array	No	Aspects to consider for VOC calculation

Range Endpoint

Parameter	Type	Required	Description
startDate	string	Yes	Start date in YYYY-MM-DD format
endDate	string	Yes	End date in YYYY-MM-DD format (max 31 days)
location	object	Yes	Location with latitude, longitude, timezone
aspects	array	No	Aspects to consider for VOC calculation

Available Aspects

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

Day Response

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

Range Response

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

The Void of Course (VOC) Moon is the period when the Moon makes no more major aspects to planets before entering a new sign. This period is traditionally considered unfavorable for starting new ventures.

How VOC is Calculated

1. The Moon's current position and sign are determined
2. The exact time when the Moon enters the next sign is calculated
3. All aspects between the Moon and major planets are found until the sign change
4. The last aspect marks the start of the VOC period
5. The VOC period ends when the Moon enters the new sign

VOC Data Fields

Field	Description
isVoid	Whether the Moon is currently void of course
start	When the VOC period started (last aspect time)
end	When VOC ends (Moon enters new sign)
durationMinutes	Length of the VOC period in minutes
lastAspect	Details of the last aspect made
nextSign	The sign the Moon will enter next

Use Cases

• Electional Astrology: Avoid starting important activities during VOC Moon
• Moon Phase Planning: Track optimal times for activities based on lunar phases
• Astrological Calendars: Display moon sign transits and phases
• Ritual Timing: Plan activities aligned with lunar cycles