Endpoints
Ungrouped Endpoints 1
zodiac 2
moon 2
eclipses 1
sun 2
health 1
seasons 1
What is the Astronomy and Time API?
Accurate astronomical calculations — moon phases, sunrise/sunset, twilight, seasons, zodiac signs, and eclipse calendars for any date and location. No external API dependencies.
Astronomy and Time API is available on the JoJ API marketplace. Subscribe with a single JoJ API key, call it through one gateway, and pay from one wallet — no separate account or contract with the provider.
Astronomy and Time API endpoints
- GET
/getApiInfo
Get basic API information and list of all available endpoints.
- GET
/zodiacgetZodiacByDate
Get the zodiac sign for a specific date using precise astronomical calculation.
- GET
/zodiac/todaygetZodiacToday
Get today's zodiac sign based on the sun's astronomical ecliptic longitude.
- GET
/moon/todaygetMoonPhaseToday
Get the current moon phase with illumination percentage and next new/full moon dates.
- GET
/moongetMoonPhaseByDate
Get the moon phase for a specific date. Returns phase name, illumination percentage, and next new/full moon dates.
- GET
/eclipses/{year}getEclipses
Get solar and lunar eclipse calendar for a specified year (1900-2100).
- GET
/sun/todaygetSunDataToday
Get today's sunrise, sunset, twilight times and solar noon for a location.
- GET
/sungetSunDataByDate
Get sunrise, sunset, twilight for a specific date and location.
- GET
/healthhealthCheck
Simple health check endpoint — returns status and server timestamp.
- GET
/seasons/{year}getSeasons
Get equinox and solstice dates for a specified year (1900-2100).
Frequently asked questions about Astronomy and Time API
What can this API calculate?
Moon phase and illumination for any date, sunrise/sunset and civil, nautical and astronomical twilight for any GPS coordinates, equinoxes and solstices, the zodiac sign for a date, and eclipse calendars.
How do I get sunrise and sunset for my location?
Call GET /sun/today?lat=X&lon=Y for today, or GET /sun?lat=X&lon=Y&date=YYYY-MM-DD for any date. It returns sunrise, sunset, solar noon, day length and all three twilight phases.
Do you rely on any third-party services?
No. All results are computed locally from astronomical algorithms (JPL ephemeris–based), so responses are deterministic, dependency-free and returned in milliseconds.