POST · TRANSIT WESTERN

Planets

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

Returns tropical planet positions for 13 bodies (Sun through Chiron + North/South Node) with selectable house system, Western essential dignity (domicile, detriment, exaltation, fall), combustion, and a separate points block for Part of Fortune and Lilith (Mean Black Moon). Date/time defaults to now.

Authentication

Required. See Authentication methods.

Request body

FieldTypeRequiredDescription
latitudenumberYesObserver latitude, −90…90.
longitudenumberYesObserver longitude, −180…180.
timezonestringYesIANA timezone.
yearsecondintegerNoDefaults to now.
house_systemstringNoDefault placidus. Also: koch, equal, whole_sign, campanus, regiomontanus.
node_typestringNomean (default) or true.

Response shape

Planet fields

FieldTypeDescription
name, symbolstringPlanet name and Unicode glyph.
longitude, longitude_dmsnumber, stringTropical ecliptic longitude.
degree_in_signnumberDegree within sign (0–30).
daily_motionnumberDegrees/day. Negative = retrograde.
sign, sign_symbolstringTropical sign name and glyph.
sign_lordobjecttraditional and modern rulers.
sign_elementstringFire, Earth, Air, Water.
houseintegerHouse placement per selected system.
is_retrogradebooleanRetrograde flag.
is_combust, combust_distanceboolean, number|nullCombustion status and Sun distance.
dignitystring|nulldomicile, detriment, exaltation, fall, or neutral.
is_domicile, is_detriment, is_exaltation, is_fallbooleanIndividual dignity flags.

points

part_of_fortune (day/night sect-aware formula) and lilith (Mean Black Moon Lilith) with sign, house, and longitude.

Node naming

Nodes are keyed as north_node and south_node (not Rahu/Ketu).

Use cases

  • Transit dashboard — full planet table with dignity, house, and retrograde status.
  • Part of Fortune tracking — monitor the Lot of Fortune through houses and signs.
  • Lilith transit analysis — track Black Moon Lilith position.

Errors

HTTPCodeCause
400MISSING_FIELDlatitude, longitude, or timezone absent.
400INVALID_PARAMInvalid house_system or node_type.
400INVALID_TIMEZONENumeric or non-IANA timezone.
401AUTH_MISSING_KEYNo API key.
405METHOD_NOT_ALLOWEDNon-POST request.
500CALCULATION_ERROREphemeris calculation failed.

See also