Compute Aspects Between Planets

Aspects reveal how planets interact — whether they support each other, create tension, or generate creative friction. The /v1/aspects endpoint computes these relationships for any set of bodies at any moment.

Basic aspect computation

Get the major aspects between all planets right now:

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();

for (const aspect of data.aspects) {
  console.log(`${aspect.body_a} ${aspect.aspect} ${aspect.body_b} (orb: ${aspect.orb.toFixed(2)}°)`);
}

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"},
)
for aspect in res.json()["data"]["aspects"]:
    print(f"{aspect['body_a']} {aspect['aspect']} {aspect['body_b']} (orb: {aspect['orb']:.2f}°)")

Adding minor aspects

The default returns the 7 major aspects. To include quintiles and other minor aspects:

Bash

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

Tracking applying aspects

Applying aspects (bodies moving toward exactitude) are traditionally considered stronger than separating aspects. Add applying=true to include this information:

Bash

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

Each aspect in the response will include an "applying": true or "applying": false field.

Including parallels

Declination parallels are a separate aspect system based on how far north or south of the celestial equator each body is. They're considered equivalent in strength to conjunctions (parallel) and oppositions (contraparallel):

Bash

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

Using a custom orb

Override the default orbs with a single value for all aspects:

Bash

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

Monitoring aspects over time with batch

Track how aspects evolve over a week by combining with the batch endpoint:

JSON

{
  "requests": [
    { "endpoint": "/v1/aspects", "params": { "datetime": "2024-03-18T12:00:00Z", "applying": true } },
    { "endpoint": "/v1/aspects", "params": { "datetime": "2024-03-19T12:00:00Z", "applying": true } },
    { "endpoint": "/v1/aspects", "params": { "datetime": "2024-03-20T12:00:00Z", "applying": true } },
    { "endpoint": "/v1/aspects", "params": { "datetime": "2024-03-21T12:00:00Z", "applying": true } },
    { "endpoint": "/v1/aspects", "params": { "datetime": "2024-03-22T12:00:00Z", "applying": true } }
  ]
}

This costs 5 credits (1 per sub-request) and returns all aspects for each day in a single API call.

Tips

For natal chart analysis, use /v1/natal-chart instead — it includes aspects alongside positions, houses, and dignities for 2 credits.
The /v1/aspects endpoint is ideal for transit analysis (checking current aspects) or when you only need aspects without the full chart.
See Concepts: Aspects for background on aspect types, orbs, and interpretation.

Compute Aspects Between Planets

On this page