get

/api/v1/positions/sidereal/today

Get today's sidereal positions

Overview

Shorthand endpoint for current sidereal planetary positions.

Parameters

NameTypeInRequiredDescription
bodiesstringqueryNo

Comma-separated list of celestial bodies to include

ayanamsastringqueryNo

Ayanamsa system to use for sidereal calculation

Allowed:
lahiriramankrishnamurtifaganBradleyyukteshwarjnBhasinbvRamandjwhalKhulsassaniangalacticCenter0SaggalacticCenterMidMulahipparchosushashashitrueChitrapaksha

Default: lahiri

customAyanamshastringqueryNo

Custom ayanamsha offset in degrees. When provided, bypasses the named ayanamsa system.

Response

200 — Today's sidereal 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/today" \
  -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
    }
  ]
}