get

/api/v1/positions/sidereal/ephemeris

Get sidereal ephemeris for date range

Overview

Returns sidereal 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
`ayanamsa`	string	query	No	Ayanamsa system to use for sidereal calculation Allowed: `lahiriramankrishnamurtifaganBradleyyukteshwarjnBhasinbvRamandjwhalKhulsassaniangalacticCenter0SaggalacticCenterMidMulahipparchosushashashitrueChitrapaksha` Default: `lahiri`
`customAyanamsha`	string	query	No	Custom ayanamsha offset in degrees. When provided, bypasses the named ayanamsa system.

Response

200 — Sidereal ephemeris data

startDate string required

endDate string required

ayanamsaSystem string required

ephemeris array required

array of object

date string required

ayanamsaValue number required

positions array required

array of object

body string required

position object required

longitude number required
sign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
degree number required
minute number required
isRetrograde boolean required

tropicalLongitude number required

Example Request

cURL

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

Example Response

JSON

{
  "startDate": "",
  "endDate": "",
  "ayanamsaSystem": "",
  "ephemeris": [
    {
      "date": "",
      "ayanamsaValue": 0,
      "positions": [
        {
          "body": null,
          "position": null,
          "tropicalLongitude": null
        }
      ]
    }
  ]
}