Astrology API by technique

Turn one birth moment into a complete, structured natal chart — planets, house cusps, aspects, and angular data — in a single POST. Tropical zodiac, thirteen house systems, Swiss Ephemeris precision, JSON out.

Compare two birth charts in one call and get the cross-aspect grid that drives every compatibility feature — who aspects whom, by what angle, with what orb, in which direction. Two charts in, the relationship between them out.

Snapshot the sky on any target date and lay it over a person's natal house frame in one POST. Transiting planets, the natal cusps they fall into, the aspect grid among the transiting bodies, plus parallels and antiscia — Swiss Ephemeris precision, JSON out.

Fuse two birth charts into one. The midpoint composite takes every planetary pair and the two sets of angles, finds the midpoint of each, and returns a single derived chart that models the relationship as its own entity. Two charts in, one composite out, JSON.

Move the natal chart forward symbolically: one ephemeris day of planetary motion stands for one year of life. Give a birth chart and a target date and get back the progressed chart — planets, houses, aspects — for that age. Swiss Ephemeris precision, JSON out.

Cast the chart for the exact instant the Sun comes back to its natal degree in a chosen year — the astrological birthday. Pass a natal chart and a year, get the solar return chart for that cycle. Tropical, Sun-to-natal-Sun, Swiss Ephemeris precision, JSON out.

Find the next moment the Moon comes home to its natal longitude on or after a chosen date — roughly every 27.3 days — and cast the chart for it at a location you pick. Pass natal data and a start date, get the lunar return chart. Swiss Ephemeris precision, JSON out.

Re-anchor the whole zodiac to the Moon's North Node. Slide 0° Aries onto the natal North Node and every planet is re-read in nodal — 'draconic' — longitude. Pass a birth chart, get planets, houses, and aspects expressed in the draconic frame. Swiss Ephemeris precision, JSON out.

Move the observer to the Sun. Instead of the usual Earth-centred sky, this returns the solar system as seen from the Sun — Earth becomes a body, the Moon and the Ascendant drop away, and every planet is given in heliocentric longitude. Pass a moment, get the heliocentric chart. Swiss Ephemeris precision, JSON out.

Keep the planets, move the map. A relocation chart holds every natal planetary longitude exactly as born but rebuilds the house framework — Ascendant, Midheaven, cusps — for a new place. Pass natal data and a target location, get both charts plus the angular delta. Swiss Ephemeris precision, JSON out.

Astrocartography takes a single birth moment and projects it onto the whole planet: instead of asking where the planets were in the sky, it asks where on Earth each planet was angular. The endpoint returns the line geometry you plot on a world map to see which longitudes activate which planetary energy.

Essential dignities measure how comfortably each planet sits in the sign and degree it occupies. This endpoint runs every body through the five-fold traditional scheme — rulership, exaltation, triplicity, term, and face — together with the two debilities, and returns both a per-planet breakdown and a single weighted total.

Beyond the moving planets, the older layer of astrology reads the fixed stars — Regulus, Spica, Algol, Aldebaran and their peers. This endpoint scans a natal chart for tight conjunctions to those major stars and returns each contact with its orb, so you can fold a star's reputed character into a reading.

The Arabic Parts, or Hellenistic Lots, are calculated points derived by arithmetic on the chart rather than read directly off the sky. This endpoint computes the Lot of Fortune, Spirit, Eros and the rest from formulas on the Ascendant and two planets, handling the day-birth and night-birth reversal that real Lot practice demands.

Cosmobiology reads a chart through midpoints: the degree exactly halfway between two planets, and any third planet that lands on it. This endpoint computes the midpoint structure of a chart, assembles the midpoint tree for each planet, and flags the symmetries that the 90° dial tradition treats as the chart's most active points.

Most aspect work happens along the ecliptic in longitude, but two bodies can also relate by declination — their distance north or south of the celestial equator. This endpoint works in that second dimension, finding parallels and contraparallels, the declination analogues of the conjunction and opposition, and noting when a body runs out of bounds.

Vimshottari is the 120-year planetary-period cycle that anchors Vedic timing. This endpoint reads the sidereal Moon's position at birth, locates the nakshatra it occupies, and from that single point unrolls the ordered chain of Mahadashas — the major life periods, each governed by one of the nine grahas — with the exact calendar dates that bound them.

Varga charts are the magnifying lenses of Jyotish: each one subdivides every sign into a chosen harmonic and re-maps the planets onto a finer grid that speaks to one domain of life. This endpoint takes a birth moment and a requested division — D1 through D60 — and returns where each planet falls in that varga.

Shadbala — literally 'six-fold strength' — is the classical way to quantify how much a planet can actually deliver on its promises in a chart. This endpoint computes each graha's total strength as the sum of its six constituent balas, returning a per-planet score in rupas so you can rank the planets by how strongly they are positioned to act.

This endpoint computes the Pythagorean Life Path number — the single digit that condenses a birth date into its core numerological signature. It is one calculation within a broader suite spanning four systems and roughly ten calculations each, and it runs as pure arithmetic with no ephemeris and no astrology involved.

This endpoint performs a seeded, reproducible draw from the 78-card Rider-Waite-Smith deck for the three-card spread. It returns the spread metadata, the integer seed that governed the shuffle, and the drawn cards with their positions, orientations and meanings — so any reading can be replayed exactly by passing the seed back.

This endpoint computes the Human Design bodygraph from a single birth event. It combines the natal Personality chart with the Design chart — taken roughly 88° of solar arc before birth, about three months earlier — and derives the mechanical elements of the bodygraph: Type, Strategy, Authority, Profile, Centers, Channels, Gates and the Incarnation Cross.

This endpoint generates a written daily horoscope for a zodiac sign on a given date by calling our LLM gateway. It returns the horoscope text, a disclaimer, the model that produced it, and the language of the output. Unlike the calculation endpoints it is generated guidance rather than a deterministic result.