Computes the elemental distribution of planets across Fire, Earth, Air, and Water. Returns both raw counts and weighted scores where Sun, Moon, and Ascendant carry double weight (reflecting their outsized influence on personality). Each element includes the list of planets placed in it.
A missing element (zero planets) is astrologically significant — it often indicates an area the native must consciously develop. The response flags any missing elements explicitly.
Authentication
Method
Example
Header (recommended)
X-Api-Key: am_live_xxxxxxxxxxxx
Bearer
Authorization: Bearer am_live_xxxxxxxxxxxx
Query
?api_key=am_live_xxxxxxxxxxxx
Request body
Field
Type
Required
Description
year
integer
Yes
Birth year (1800–2400).
month
integer
Yes
Birth month (1–12).
day
integer
Yes
Birth day.
hour
integer
Yes
Birth hour (0–23).
minute
integer
Yes
Birth minute (0–59).
second
integer
No
Default 0.
latitude
number
Yes
Decimal degrees (−90 to 90).
longitude
number
Yes
Decimal degrees (−180 to 180).
timezone
string
Yes
IANA timezone.
house_system
string
No
Default placidus. 25 systems supported. See house systems.
Names of bodies in this element (includes "Ascendant" if applicable).
Other fields
Field
Type
Description
dominant
string
Element with highest weighted score.
weakest
string
Element with lowest weighted score.
missing_elements
array
Elements with zero planets. Empty array if all represented.
total_points
integer
Total unweighted body count.
total_weighted
integer
Total weighted score.
Weighting system
Body
Weight
Rationale
Sun
2
Core identity, life force.
Moon
2
Emotional nature, instinctive reactions.
Ascendant
2
Physical appearance, how others perceive you.
All other planets
1
Standard weight.
South Node and Part of Fortune are excluded from the count (South Node is always opposite North Node; Part of Fortune is a calculated lot, not a body).