What the Western astrology API includes
Cosmic Ephemeris calculates apparent geocentric ecliptic longitude for the Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, and Pluto. Each returned body includes its selected-zodiac longitude, sign position, an apparent one-day motion value, and a retrograde flag.
- Default zodiac
- Tropical
- Position frame
- Apparent geocentric longitude
- Public date window
- 1800-01-01 through 2200-12-31
Birth charts
Planet positions, signs, chart angles, houses, aspects, nodes, and calculation metadata.
Equal and whole-sign houses
Ascendant, Midheaven, and the selected supported house system for chart rendering.
Natal aspects
Ten documented aspect types using fixed, symmetric longitude-separation orbs.
Synastry geometry
Two complete charts and their cross-chart aspects, without compatibility scoring.
Natal-to-transit aspects
Compare a natal chart with one caller-supplied transit date and time.
Davison relationship charts Current
A physical chart at the uniform-TT time midpoint and arithmetic location midpoint of two births; separate from symbolic composite geometry.
Moon phases and calendars Current
Instant phase geometry and illumination, bounded primary-phase events and opt-in iCalendar export; no notification service.
Structured signals Current
Deterministic transit fields for downstream editorial logic—not generated horoscope prose.
Solar and lunar returns Current
Next Sun or Moon longitude return after a specified instant, with its physical chart and bounded search metadata.
True solar-arc directions Current
A declared day-for-year solar arc applied to natal planets and angles, with synthetic Equal/Whole Sign houses.
Mean and osculating nodes Current
Separate mean and geometric DE440 osculating north/south pairs, each with its declared coordinate frame.
What can you build with it?
The endpoints are designed for server-side product backends. A client application can turn the returned data into a chart wheel, accessible table, natal report, synastry comparison, or calendar that evaluates selected transit instants.
- Natal chart pages and saved chart profiles
- Custom SVG or Canvas chart renderers
- Relationship and synastry interfaces based on raw cross-aspects
- Transit views for dates and times chosen by the caller
- Bounded calendars of sign ingresses, stations, and exact major aspects
- Rule-based editorial systems that preserve their own interpretive voice
See the Cosmic Ephemeris use-case guide for architecture and privacy considerations before collecting birth information.
Current calculation boundaries
Cosmic Ephemeris returns calculation data, not predictive certainty or professional advice. Your application owns its interpretations, editorial claims, and treatment of user data.
- Placidus, Porphyry, Meridian, Campanus, Regiomontanus, Alcabitius, Koch, Morinus, Topocentric, Sripati, Vehlow, Horizon/Azimuth, Krusinski-Pisa-Goelzer, Sunshine, Sunshine alternative, Savard-A, Pullen SD, Pullen SR, Carter Poli-Equatorial, APC, Equal MC, and Natural are current opt-in methods with no fallback on the Houses and natal-SVG endpoints
- Gauquelin is an opt-in Houses-only supported returning 36 clockwise semiarc sectors; it is not a twelve-house natal-SVG system and never falls back
- Secondary-progressed planets are supported; no progressed angles/houses. The separate Davison calculation uses an uncorrected TT/arithmetic physical midpoint; corrected-MC and spherical variants are not offered. Composite calculations retain shortest-arc midpoints and synthetic Equal/Whole Sign houses.
- Return supported supports Sun/Moon only, Equal/Whole Sign houses and fixed search windows; it does not accept arbitrary event-search controls.
- The separate planetary-events calculation searches sign ingresses, tropical stations and five exact major aspects for at most 31 days. House-ingresses searches transit crossings of fixed Equal or Whole Sign reference-chart cusps. The aspect-windows calculation adds configurable exact-hit-anchored orb intervals, applying/separating labels, retrograde repeat numbering and optional iCalendar text. None supplies interpretation; planetary-events and aspect-windows do not calculate houses. The Moon-phase calculation separately searches four primary lunar phases
- Legacy/core natal, transit, and synastry aspect lists do not expose applying/separating flags or user-configurable orbs. Natal analysis and natal SVG separately support declared aspect profiles or custom orb tables, while aspect windows return applying/separating labels. No route supplies dignity scoring or prose interpretations.
- No topocentric planet or point positions, right ascension, declination, altitude/azimuth, or distance
- The corrected chart
truenode uses the geometric osculating model. Chartmean/southremain mean nodes; the separate lunar-node calculation supplies both north/south pairs.
See supported Western calculations for original light/dark natal wheels, midpoint composites and secondary-progressed planets. The progression convention is one TT day per fixed 365.2421904-day year; natal angles/houses remain separate context. Composite antipodes reject rather than choosing an arbitrary midpoint. Read Calculation methodology and limitations before comparing output with another ephemeris or astrology application.
Start with the documented contract
- Collect an explicit date, local time, IANA timezone, latitude, and longitude.
- Send the request from your server with an API key in the Authorization header.
- Validate the response and render the calculation in your own product interface.