POST · TRANSIT WESTERN

Aspects

Endpoint POST https://starsapi.com/api/v3/transit/western/aspects

Computes orb-based aspects (major + minor) between all transiting planets at a given moment. Each aspect includes the exact angle, actual angle, orb deviation, maximum allowed orb (planet-weighted), strength percentage, and whether the aspect is applying or separating. Aspects are grouped by source planet and sorted by strength.

For timed transit-to-transit aspects over a date range (with entry/exact/exit dates), use transit-aspects.

Authentication

Required. See Authentication methods.

Request body

FieldTypeRequiredDescription
latitudenumberYesObserver latitude.
longitudenumberYesObserver longitude.
timezonestringYesIANA timezone.
yearsecondintegerNoDefaults to now.
node_typestringNomean (default) or true.

Response shape

Keyed by source planet. Each aspect entry:

FieldTypeDescription
planetstringThe other planet in the aspect.
aspectstringAspect name: Conjunction, Sextile, Square, Trine, Opposition, Semi-sextile, Semi-square, Sesquiquadrate, Quincunx.
symbolstringUnicode glyph (e.g. ☌, □, △, ☍).
typestringmajor or minor.
naturestringharmonious, tense, variable, mild, or adjustment.
exact_angleintegerThe exact angle for this aspect type (0, 60, 90, 120, 180, etc.).
actual_anglenumberThe actual angular distance between the two planets.
orbnumberDeviation from exact (degrees).
max_orbnumberMaximum orb allowed (planet-weighted).
strength_pctnumberAspect strength as a percentage (100 = exact).
applyingbooleantrue if the aspect is tightening.

Supported aspects

AspectAngleBase orbTypeNature
Conjunctionmajorvariable
Sextile60°majorharmonious
Square90°majortense
Trine120°majorharmonious
Opposition180°majortense
Semi-sextile30°minormild
Semi-square45°minortense
Sesquiquadrate135°minortense
Quincunx150°minoradjustment

Orbs are weighted by planet: luminaries (Sun/Moon) get 1.2×, inner planets 1.0×, outers 0.7–0.9×.

See also