Morphemeris DocsBeta

Ayanamsha

GET /v1/ayanamsha — Get sidereal ayanamsha values for any of 47 systems.

Ayanamsha

Compute the ayanamsha (sidereal offset) for a given moment. The ayanamsha is the angular difference between the tropical and sidereal zodiacs.

Text
GET  /v1/ayanamsha
POST /v1/ayanamsha

Credit cost: 1

Parameters

ParameterTypeRequiredDefaultDescription
datetimestringOne of datetime or jdISO 8601 UTC datetime
jdnumberOne of datetime or jdJulian Day in UT1
systemstringNo"lahiri"Ayanamsha name or Swiss Ephemeris number, or "all" for every available system

Response

data is always an array: one entry for a single system, one per available system for system=all.

Single system

JSON
{
  "data": [
    { "system": "lahiri", "name": "Lahiri", "id": 1, "value": 24.1764 }
  ],
  "meta": { "..." }
}

All systems (system=all)

JSON
{
  "data": [
    { "system": "fagan_bradley", "name": "Fagan-Bradley", "id": 0, "value": 24.9912 },
    { "system": "lahiri", "name": "Lahiri", "id": 1, "value": 24.1764 },
    { "system": "deluce", "name": "De Luce", "id": 2, "value": 23.4201 }
  ],
  "meta": { "..." }
}
FieldTypeDescription
systemstringThe name the system and sidereal parameters accept, so it can be sent straight back
namestringDisplay name
idnumberSwiss Ephemeris number, 0 to 46
valuenumberAyanamsha value in degrees, signed on (−180°, 180°]. Negative before the system's zero year (around 285 CE for Lahiri); the J2000 ayanamsha is −1.39° in 1900

Examples

Bash
curl "https://api.morphemeris.com/v1/ayanamsha?datetime=2024-03-20T12:00:00Z&system=lahiri" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"
javascript
const res = await fetch(
  "https://api.morphemeris.com/v1/ayanamsha?datetime=2024-03-20T12:00:00Z&system=lahiri",
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const data = await res.json();
Python
import requests

res = requests.get(
    "https://api.morphemeris.com/v1/ayanamsha",
    params={"datetime": "2024-03-20T12:00:00Z", "system": "lahiri"},
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

See Ayanamshas for the full list of 47 systems, the 12 star-anchored ones included.