lunar
Get current Moon aspects
Returns all current Moon aspects to traditional planets with applying/separating classification.
Performance: 15-30ms
Aspect Classification:
- Applying: Moon approaching exact aspect (energies building)
- Separating: Moon departing from exact aspect (energies waning)
- Classification based on Moon vs planet speeds (Moon moves ~13°/day, faster than any planet)
Orb System: Fixed traditional orbs (no custom orbs in v1)
- Major aspects: Conjunction, Opposition, Square, Trine, Sextile
- Minor aspects: Semi-sextile, Quincunx (optional via include_minor parameter)
Planets Checked: Sun, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto
Use Cases:
- "What aspects is the Moon making right now?"
- Moon aspect tracking for timing decisions
- Lunar aspect calendars
- Real-time lunar energy awareness
Example:
GET /ephemeris/moon/aspects?datetime=2025-12-11T12:00:00Z&include_minor=false
get/ephemeris/moon/aspects
Request
- Base URL: https://api.openephemeris.com
- URL: https://api.openephemeris.com/ephemeris/moon/aspects
- Auth: one of:
- HTTP bearer
- API key in header X-OpenEphemeris-API-Key
- API key in header X-API-Key
- API key in header X-Service-Key
Query parameters
datetimestring required
ISO-8601 datetime, e.g. '2025-12-11T12:00:00Z'. A clock time must carry its own zone ('Z' or ±HH:MM); a zone-less clock time is rejected with 400 ambiguous_datetime. A date-only value resolves to 12:00 UTC.
zodiac_modestring
Zodiac mode: 'tropical' or 'sidereal'
include_minorboolean
Include minor aspects (semi-sextile, quincunx)
formatstring
Response format: json | llm.
Headers
authorizationstring nullable
X-API-Keystring nullable
X-OpenEphemeris-API-Keystring nullable
apikeystring nullable
Response
Successful Response
Example response
{
"applying": [
{
"applying": true,
"aspect_type": "square",
"orb": 2.3,
"planet": "Sun"
}
],
"aspects": [
{
"applying": true,
"aspect_type": "square",
"orb": 2.3,
"planet": "Sun"
}
],
"count": 1,
"metadata": {
"calculation_time_ms": 18.5
},
"separating": [],
"success": true
}Changes
No recorded changes to this operation across all 1 revision of this API.