get

/api/v1/aspects/patterns

Detect aspect patterns in a chart

Overview

Detects geometric aspect patterns (Grand Trine, T-Square, Grand Cross, Yod, Kite, Mystic Rectangle, Stellium), classifies chart shape, and calculates hemispheric/quadrant emphasis when location is provided.

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
`latitude`	string	query	No	Latitude in decimal degrees (required for house-based analysis)
`longitude`	string	query	No	Longitude in decimal degrees (required for house-based analysis)

Response

200 — Aspect patterns, chart shape, and optional hemispheric analysis

date string required

patterns array required

array of object

type string required: Enum:
grandTrinetSquaregrandCrossyodkitemysticRectanglestellium
bodies array required: array of string
description string required

chartShape object required

shape string required: Enum:
bowlbucketbundlelocomotiveseesawsplashsplay
description string required
leadingPlanet string

hemisphericEmphasis object

north number required
south number required
east number required
west number required
dominant string required

quadrantEmphasis object

northeast number required
northwest number required
southeast number required
southwest number required
dominant string required

Example Request

cURL

curl "https://api.almuten.io/api/v1/aspects/patterns" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "date": "2025-07-15",
  "patterns": [
    {
      "type": "grandTrine",
      "bodies": [
        ""
      ],
      "description": ""
    }
  ],
  "chartShape": {
    "shape": "bowl",
    "description": "",
    "leadingPlanet": ""
  },
  "hemisphericEmphasis": {
    "north": 0,
    "south": 0,
    "east": 0,
    "west": 0,
    "dominant": ""
  },
  "quadrantEmphasis": {
    "northeast": 0,
    "northwest": 0,
    "southeast": 0,
    "southwest": 0,
    "dominant": ""
  }
}