ephemeris

Check aspects between two longitudes

Lightweight endpoint for calculating aspects between two celestial longitudes. Supports filtering by aspect type and custom orb limits.

post/ephemeris/aspect-check

Request

Base URL: https://api.openephemeris.com
URL: https://api.openephemeris.com/ephemeris/aspect-check
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

output_modestring nullable

Deprecated: use preset+format. Accepts full|simple|llm.

formatstring

Headers

authorizationstring nullable

X-API-Keystring nullable

X-OpenEphemeris-API-Keystring nullable

apikeystring nullable

Request body

aspect_typesstring[]

Filter aspects by type (omit for all types). Valid: conjunction, opposition, trine, square, sextile, quintile, semi_sextile, quincunx, semi_square, sesquiquadrate

longitude1number required

First point ecliptic longitude in degrees (0-360)

longitude2number required

Second point ecliptic longitude in degrees (0-360)

max_orbnumber

Maximum orb allowance in degrees (default: 6.0)

Example request

{
  "aspect_types": [
    "conjunction",
    "opposition",
    "square",
    "trine"
  ],
  "longitude1": 120,
  "longitude2": 180,
  "max_orb": 6
}

Response

Aspects calculated successfully

angular_separationnumber required

Angular separation between points in degrees (0-180)

successboolean

Calculation success status

Changes

No recorded changes to this operation across all 1 revision of this API.