---
title: "Get current Moon aspects"
method: GET
path: "/ephemeris/moon/aspects"
tags: ["lunar"]
---

# Get current Moon aspects

`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`

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:**
```bash
GET /ephemeris/moon/aspects?datetime=2025-12-11T12:00:00Z&include_minor=false
```

## Query parameters

- `datetime` string, 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_mode` string: Zodiac mode: 'tropical' or 'sidereal'
- `include_minor` boolean: Include minor aspects (semi-sextile, quincunx)
- `format` string: Response format: json | llm.

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable
- `X-OpenEphemeris-API-Key` string, nullable
- `apikey` string, nullable

## Response `200`

Successful Response

- MoonAspectsResponse: Comprehensive snapshot of all aspects currently being formed by the Moon, separated into applying (approaching) and separating (departing) phases.
  - `applying` object[], required: Applying aspects (Moon approaching)
  - `aspects` object[], required: All current Moon aspects
  - `count` integer, required: Total aspect count
  - `metadata` object, required: Calculation metadata
  - `separating` object[], required: Separating aspects (Moon departing)
  - `success` boolean: Calculation success status

## Other responses

- `400`: Bad Request
- `422`: Unprocessable Entity - Invalid input format
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openephemeris/apis/open-ephemeris-api.md) · [All operations](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/revisions/d195a769cb89?raw)