Western astrology

POST/api/astrologyPro

Generate a complete Western astrology chart. Returns planets, signs, houses, aspects, angles, and special points for both the Personality (birth) and Design moments.

Request

Uses the same shared parameters as all Human Design endpoints: birthDate, birthTime, birthLocation, with optional latitude/longitude overrides.

thd-api

Response

✓ doneapplication/json

{
"success": true,
"meta": {
  "version": "1.0.0",
  "timestamp": "2026-03-15T12:00:00.000Z",
  "endpoint": "astrology"
},
"data": {
  "birthInfo": { "date": "1990-05-15", "time": "14:30", "location": "New York, NY" },
  "personality": {
    "chart": {
      "sunSign": { "id": "taurus", "value": "Taurus" },
      "moonSign": { "id": "scorpio", "value": "Scorpio" },
      "ascendant": { "id": "virgo", "value": "Virgo" },
      "dominantElement": { "id": "earth", "value": "Earth" },
      "dominantQuality": { "id": "fixed", "value": "Fixed" }
    },
    "planets": {
      "Sun": {
        "name": "Sun",
        "longitude": 54.32,
        "sign": "Taurus",
        "positionInSign": "24°19'",
        "positionFormatted": "24°19' Taurus",
        "quality": "Fixed",
        "element": "Earth",
        "house": 9,
        "isRetrograde": false
      }
    },
    "angles": {
      "ascendant": { "longitude": 162.5, "sign": "Virgo", "gate": 46, "line": 2 },
      "midheaven": { "longitude": 72.1, "sign": "Gemini", "gate": 35, "line": 4 },
      "descendant": { "longitude": 342.5, "sign": "Pisces" },
      "imumCoeli": { "longitude": 252.1, "sign": "Sagittarius" }
    },
    "houses": [
      { "house": 1, "name": "First House", "cuspLongitude": 162.5, "sign": "Virgo" }
    ],
    "aspects": {
      "major": [
        {
          "planet1": "Sun",
          "planet2": "Moon",
          "aspect": "Opposition",
          "angle": 180,
          "orb": 2.3,
          "nature": "challenging"
        }
      ],
      "minor": [],
      "count": 15
    },
    "points": {
      "northNode": { "..." : "..." },
      "chiron": { "..." : "..." },
      "blackMoonLilith": { "..." : "..." },
      "partOfFortune": { "..." : "..." }
    },
    "asteroids": {
      "ceres": { "..." : "..." },
      "pallas": { "..." : "..." },
      "juno": { "..." : "..." },
      "vesta": { "..." : "..." }
    },
    "analysis": {
      "elements": { "Fire": 2, "Earth": 4, "Air": 3, "Water": 3 },
      "qualities": { "Cardinal": 3, "Fixed": 5, "Mutable": 4 }
    }
  },
  "design": {
    "chart": { "..." : "..." },
    "planets": { "..." : "..." },
    "angles": { "..." : "..." },
    "houses": [ "..." ],
    "aspects": { "..." : "..." }
  },
  "crossAspects": {
    "major": [
      {
        "personalityPlanet": "Sun",
        "designPlanet": "Moon",
        "aspect": "Trine",
        "angle": 120,
        "orb": 1.5,
        "isSamePlanet": false
      }
    ],
    "summary": {
      "totalMajor": 8,
      "totalMinor": 12,
      "samePlanetCount": 3
    }
  },
  "tooltips": {}
}
}

Response structure

The response contains three main sections:

Section	Description
`personality`	Full Western astrology for the birth (conscious) moment — planets, houses, aspects, angles
`design`	Full Western astrology for the Design (unconscious) moment, ~88° Sun offset before birth
`crossAspects`	Aspects between Personality and Design planets — shows conscious/unconscious dynamics

Dual chart system

This endpoint returns two complete astrology charts: one for the birth moment (Personality) and one for the Design moment. The crossAspects section reveals the dynamics between them.

Tooltip variant

POST /api/astrology?include=tooltips — Returns the same structure with the tooltips field populated with descriptions for all signs, planets, houses, aspects, elements, and qualities. The legacy URL /api/v1/astrology-tooltip is still supported.

Render a wheel image

To render a natal wheel image, use the Astrology wheel rendering API (GET /api/astrology/wheel.svg or .png). Alternatively, add ?include=wheel to this endpoint to embed the SVG inline (adds 1 Chart request to the call).