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

applyingobject[] required

Applying aspects (Moon approaching)

aspectsobject[] required

All current Moon aspects

countinteger required

Total aspect count

metadataobject required

Calculation metadata

separatingobject[] required

Separating aspects (Moon departing)

successboolean

Calculation success status

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.