GET /v1/aspects — Compute aspects and parallels between celestial bodies at a given time.

Aspects

Compute the angular relationships (aspects) between celestial bodies at a given moment. Optionally includes declination parallels. Does not require a location — only ecliptic positions are needed.

Text

GET  /v1/aspects
POST /v1/aspects

Credit cost: 1

Parameters

Parameter	Type	Required	Default	Description
`datetime`	string	One of `datetime` or `jd`	—	ISO 8601 UTC datetime
`jd`	number	One of `datetime` or `jd`	—	Julian Day in UT1
`bodies`	string	No	`"planets"`	Comma-separated body names
`sidereal`	string	No	—	Ayanamsha for sidereal mode
`aspects`	string	No	Major 7	Comma-separated aspect types
`orb`	number	No	—	Global orb override in degrees
`applying`	boolean	No	`false`	Include applying/separating flag
`parallels`	boolean	No	`false`	Include declination parallels
`parallel_orb`	number	No	`1.0`	Orb for parallels in degrees

Available aspect types

Aspect	Angle	Default orb
`conjunction`	0°	8°
`opposition`	180°	8°
`trine`	120°	8°
`square`	90°	7°
`sextile`	60°	6°
`quincunx`	150°	2°
`semisextile`	30°	2°
`semisquare`	45°	2°
`sesquiquadrate`	135°	2°
`quintile`	72°	1°
`biquintile`	144°	1°
`septile`	51.43°	1°
`novile`	40°	1°
`decile`	36°	1°
`parallel`	—	1° (declination)

The default set includes the first 7 (major aspects). Use the aspects parameter to request specific types, e.g., aspects=conjunction,opposition,trine,square,quintile.

Response

JSON

{
  "data": {
    "aspects": [
      {
        "body_a": "sun",
        "body_b": "jupiter",
        "aspect": "trine",
        "angle": 120.0,
        "orb": 2.15,
        "applying": false
      },
      {
        "body_a": "moon",
        "body_b": "saturn",
        "aspect": "square",
        "angle": 90.0,
        "orb": 0.87,
        "applying": true
      }
    ],
    "parallels": [
      {
        "body_a": "venus",
        "body_b": "mars",
        "type": "parallel",
        "orb": 0.45
      }
    ]
  },
  "meta": { "..." }
}

Field	Type	Description
`aspects[].body_a`	string	First body in the aspect
`aspects[].body_b`	string	Second body in the aspect
`aspects[].aspect`	string	Aspect type name
`aspects[].angle`	number	Exact angle of the aspect
`aspects[].orb`	number	Distance from exactitude in degrees
`aspects[].applying`	boolean	Whether the aspect is applying (present when `applying=true`)
`parallels[].body_a`	string	First body
`parallels[].body_b`	string	Second body
`parallels[].type`	string	`"parallel"` or `"contraparallel"`
`parallels[].orb`	number	Declination difference in degrees

Examples

Current planetary aspects

Bash

curl "https://api.morphemeris.com/v1/aspects?datetime=2024-03-20T12:00:00Z" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

javascript

const res = await fetch(
  "https://api.morphemeris.com/v1/aspects?datetime=2024-03-20T12:00:00Z",
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const { data } = await res.json();

Python

import requests

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

With minor aspects and parallels

Bash

curl "https://api.morphemeris.com/v1/aspects?datetime=2024-03-20T12:00:00Z&aspects=conjunction,opposition,trine,square,sextile,quintile,biquintile&parallels=true&applying=true" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

Aspects

Aspects

Parameters

Available aspect types

Response

Examples

Current planetary aspects

With minor aspects and parallels

On this page