By topic / Western Astrology API
Western
Western Astrology API: natal charts, transits, synastry and returns
Tropical charts with the house system of your choice: the natal chart with aspects and their orbs, today's transits to it, synastry between two people, progressions and solar arcs, and the solar and lunar returns. Each comes as JSON, and the chart wheels as images.
Ideas
What people build with it
A Western horoscope app
Dating-app compatibility
Yearly forecasts from returns and transits
Reference
The endpoints
- Western Natal ChartTropical natal chart: Sun, Moon and rising signs, ascendant and midheaven, planets with sign and house, the house cusps, and aspects with orb and meaning.POST/v1/western/western-natal-chart 1 credit
- Western Natal AspectsAspects between natal planets with orb, nature and meaning, split into major and minor.POST/v1/western/western-natal-aspects 1 credit
- Western Transit ChartNatal and current transit planet positions, transit-to-natal aspects with orb, intensity and meaning, and the major transits.POST/v1/western/western-transit-chart 1 credit
- Synastry Compatibility ScoreA synastry compatibility score with Sun and Moon compatibility, aspect counts and a verdict.POST/v1/western/synastry-compatibility 1 credit
- Synastry: EverythingCompatibility, all five domain readings ranked (career, finance, intimacy, spirituality, emotion) and the sun-sign match, in one call.POST/v1/western/synastry-full 10 credits
- Secondary ProgressionsDay-for-a-year progressed positions and angles at a target date, with progressed-to-natal aspects within an orb; the angle method used is stated.POST/v1/western/western-secondary-progressions 1 credit
- Solar Return ChartThe exact moment the Sun returns to its natal position in a year, with the return chart cast at the birth place or at return_place.POST/v1/western/western-solar-return 1 credit
- Western Natal WheelThe natal wheel as an SVG drawing with real house cusps and aspect lines, plus the cusp, planet and aspect data drawn.POST/v1/western/western-natal-wheel 1 credit
- Arabic LotsThe Arabic lots: Fortune, Spirit, Eros, Necessity, Courage, Victory, Nemesis, Basis, Exaltation, Father, Mother, Siblings, Children, Illness, Death, Commerce and Marriage, each with its day or night formula, sign, degree and house. A day chart is one with the Sun above the horizon; most lots reverse at night. Day and night formulas, each lot with its source or a note where the tradition varies. Any house system (Placidus is only the default). Tropical zodiac.POST/v1/western/arabic-lots 1 credit
- Draconic ChartThe draconic chart: every planet and angle measured from the North Node (true or mean) as 0 Aries, the natal house cusps turned the same way, the aspects inside the draconic chart and the draconic points that sit on natal points within an orb you choose.POST/v1/western/draconic-chart 1 credit
- Antiscia and Contra-antisciaThe mirror points of every planet and angle across the solstice axis (antiscia) and the equinox axis (contra-antiscia), and the contacts where one point lies on another's mirror within an orb you choose (one degree by default).POST/v1/western/antiscia 1 credit
- Planetary HoursThe 24 planetary hours for a date and place: the Chaldean order from the weekday's ruler, twelve unequal hours from sunrise to sunset and twelve from sunset to the next sunrise, each with its ruler, start, end and traditional use. Give a time to get the hour in effect.POST/v1/western/planetary-hours 1 credit
FAQ
Common questions
Which house systems are supported?
All of them. Placidus is only the default: send house_system as a one-letter code for Koch, Equal, Whole Sign, Campanus, Regiomontanus, Porphyry, Morinus, Topocentric or Alcabitius.
Is there sun-sign content too?
Yes. Daily and weekly sun-sign horoscopes are separate endpoints, and so are sun-sign and rising-sign matches.
Guides
Read next
Start building with the Western Astrology API
5,000 free trial credits. No card required.

