get

/api/v1/positions/draconic

Get draconic planetary positions

Overview

Returns positions of celestial bodies in draconic zodiac coordinates. The draconic zodiac is aligned with the Moon's nodes. In this system, the North Node is always at 0° Aries. It's calculated by subtracting the North Node's position from all planetary positions. The draconic chart is used in soul-level astrology and karmic interpretation.

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

Response

200 — Draconic planetary positions

date string required

northNodeTropical 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/draconic" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

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