For developers

Machine-readable sky data.

The computed dates behind this site's calendars — retrograde windows, sign ingresses, moon phases, eclipses, and today's sky — are published as versioned JSON. The files are static, cached at the edge, and open to any origin. There is no key, no signup, and no rate ceiling beyond ordinary CDN behavior, and none of it involves anyone's birth data: these endpoints describe the shared sky, andchart calculation stays on the device.

Quick start

const sky = await fetch('https://zodiacs.org/api/v1/sky/today.json')
  .then((response) => response.json());

console.log(sky.date, sky.moon.phase);
for (const body of sky.bodies) {
  console.log(body.body, body.sign, body.degree.toFixed(1) + '°', body.retrograde ? 'Rx' : '');
}

Or from a terminal: curl -s https://zodiacs.org/api/v1/sky/today.json

Endpoints

/api/v1/index.json
Every published endpoint, with descriptions and update cadence.
/api/v1/sky/today.json
Today's planetary positions, moon phase and illumination, active retrogrades with shadow boundaries, next full and new moon, and the day's exact sky events. Refreshed daily at 00:00 UTC.
/api/v1/retrogrades/{2026–2030}.json
Retrograde windows for the year, station to station, with pre- and post-shadow boundaries.
/api/v1/ingresses/{2026–2030}.json
Every planetary sign ingress in the year, with the exact instant and whether the planet entered moving retrograde.
/api/v1/moon-phases/{2026–2030}.json
Full and new moon instants for the year, each with its zodiac sign and degree.
/api/v1/eclipses/{2026–2030}.json
Solar and lunar eclipses peaking in the year: type, kind, exact peak, sign, and obscuration.

The contract

Positions are apparent geocentric tropical longitudes from the same engine the calculators use, tested against NASA JPL Horizons reference data; every payload names its schema (for examplezodiacs.sky-api.today.v1) and carries its generation time. Within v1, fields are added, never renamed or removed. A breaking change would ship under /api/v2/ and v1 would keep working. Year files cover 2026–2030 today and grow as the underlying data is extended; readindex.json rather than assuming which years exist. All instants are UTC, in ISO 8601.

License and attribution

The data is free to use underCC BY 4.0. Credit "Zodiacs.org" with a link tohttps://zodiacs.org wherever the data is shown.

Widgets and feeds

If you would rather embed a finished surface than consume JSON, theembeddable widgets render tonight's moon, today's sky, and a mini birth chart inside a sandboxed iframe. Dated editorial is available as RSS:daily horoscopes andthe daily sky. AI agents can start from llms.txt.