get

/api/v1/positions/sidereal

Get sidereal planetary positions

Overview

Returns positions of celestial bodies in sidereal zodiac coordinates. Sidereal zodiac is based on the actual positions of constellations and is commonly used in Vedic/Jyotish astrology. **Available Ayanamsa Systems:** - `lahiri` (default): Chitrapaksha ayanamsa, most common in Indian astrology - `raman`: B.V. Raman's ayanamsa - `krishnamurti`: KP (Krishnamurti Paddhati) system - `faganBradley`: Western sidereal astrology

Parameters

Name	Type	In	Required	Description
`date`	string	query	No	Date in ISO format (YYYY-MM-DD) or datetime (YYYY-MM-DDTHH:MM:SSZ or with offset). Defaults to today.
`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 planetary positions

date string required

ayanamsa object required

system string required
value 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" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "date": "",
  "ayanamsa": {
    "system": "",
    "value": 0
  },
  "positions": [
    {
      "body": "",
      "position": {
        "longitude": 0,
        "sign": "Aries",
        "degree": 0,
        "minute": 0,
        "isRetrograde": true
      },
      "tropicalLongitude": 0
    }
  ]
}