Open data
The sky as JSON, free to reuse
Everything this site says about the sky is computed once and published here as data. Use it in an app, a newsletter, a classroom or a model. The licence is CC BY 4.0: do what you like, say where it came from.
| File | What is in it |
|---|---|
| /data/today.json Today | The sky at 00:00 UTC today: every body with longitude, sign and speed, the Moon, the retrogrades, the exact aspects and events of the day. Rebuilt every morning. |
| /data/horoscopes/today.json Today's horoscopes | The twelve readings of the day with the facts each was written from. Older days at /data/horoscopes/YYYY-MM-DD.json. |
| /data/phases.json Lunar phases | 297 new moons, quarters and full moons 2025 to 2030, exact to the minute, with sign, degree, distance and eclipse flag. |
| /data/eclipses.json Eclipses | 28 solar and lunar eclipses with type, contact times, magnitude, degree, node and the point of greatest eclipse. |
| /data/retrogrades.json Retrogrades | 62 retrograde periods of Mercury to Pluto and Chiron with station times, degrees, signs and shadow periods. |
| /data/stations.json Stations | 120 individual stations (retrograde and direct) with time and degree. |
| /data/ingresses.json Ingresses | 313 sign changes of the Sun, planets, node, Chiron and Lilith, to the minute. |
| /data/moon-ingresses.json Moon ingresses | Every sign change of the Moon, about thirteen a month. |
| /data/seasons.json Equinoxes and solstices | The four cardinal ingresses of the Sun each year. |
| /data/void-of-course.json Void of course Moon | 962 void-of-course periods by the classical definition. |
| /data/aspects-calendar.json Aspects of the slow planets | 185 exact aspects between Mars, Jupiter, Saturn, Uranus, Neptune and Pluto. |
| /data/aspects/2026.json All exact aspects per year | 6739 exact aspects between the Sun, Moon and planets, one file per year: /data/aspects/YYYY.json. |
| /data/daily/2026.json Daily positions per year | Longitude, speed, sign and degree of every body at 00:00 UTC for every day, one file per year: /data/daily/YYYY.json. |
| /data/signs.json Signs | The twelve signs with element, mode, rulers and the exact Sun entry and exit times per year. |
| /data/meta.json Meta | Build date, coverage and the list of bodies. |
Conventions
All times are UTC in ISO 8601, rounded to the minute ("2026-08-12T17:46Z"). Longitudes are tropical ecliptic longitudes in degrees from 0° Aries; sign indexes run from 0 for Aries to 11 for Pisces. Positions are geocentric and apparent, computed with the Swiss Ephemeris 2.10 on the DE431 files, the same source professional astrology software uses, and spot-checked against an independent library and published eclipse and equinox times. Body keys are lowercase English names; the node is the true node, Lilith the mean apogee.
Using it
curl -s https://horoscope.observer/data/phases.json | jq '.items[] | select(.phase=="full moon" and .eclipse!=null)'Files are served with open CORS headers and cached for an hour; the yearly files change only when the dataset is rebuilt. If you build something with it, we would like to hear about it: hello@horoscope.observer.
Attribution
"Sky data from Horoscope Observer (horoscope.observer), CC BY 4.0" is enough. For machine readers there is /llms.txt with the same list and the same terms. The daily horoscope texts carry the same licence; the videos and fonts on the site belong to their makers and are not covered.