Endpoints

10

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/zodiac

    getZodiacByDate

    Get the zodiac sign for a specific date using precise astronomical calculation.

  • GET/zodiac/today

    getZodiacToday

    Get today's zodiac sign based on the sun's astronomical ecliptic longitude.

  • GET/moon/today

    getMoonPhaseToday

    Get the current moon phase with illumination percentage and next new/full moon dates.

  • GET/moon

    getMoonPhaseByDate

    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/today

    getSunDataToday

    Get today's sunrise, sunset, twilight times and solar noon for a location.

  • GET/sun

    getSunDataByDate

    Get sunrise, sunset, twilight for a specific date and location.

  • GET/health

    healthCheck

    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.