get

/api/v1/positions/ephemeris

Get ephemeris for date range

Overview

Returns planetary positions for each day in the specified date range.

Parameters

Name	Type	In	Required	Description
`startDate`	string	query	Yes	Start date in ISO format (YYYY-MM-DD)
`endDate`	string	query	Yes	End date in ISO format (YYYY-MM-DD)
`timezone`	string	query	No	IANA timezone name (e.g., America/New_York). Used with date-only values to resolve local time.
`bodies`	string	query	No	Comma-separated list of celestial bodies to include

Response

200 — Ephemeris data

startDate string required

endDate string required

ephemeris array required

array of object

date string required

positions array required

array of object

body string required

The celestial body

Enum:

SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex

position object required

longitude number required: Ecliptic longitude in degrees (0-360)
sign string required: Zodiac sign; Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
degree number required: Degree within the sign (0-30)
minute number required: Arc minutes within the degree
isRetrograde boolean required: Whether the body appears to be moving backward

Example Request

cURL

curl "https://api.almuten.io/api/v1/positions/ephemeris" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "startDate": "",
  "endDate": "",
  "ephemeris": [
    {
      "date": "",
      "positions": [
        {
          "body": null,
          "position": null
        }
      ]
    }
  ]
}