Western Astrology

POST`/api/astrology`Pro

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

Legacy URL

Also available at /api/v1/astrology — the legacy URL is still fully supported.

Request

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

thd-api

Response

Response200

{
"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

Unlike standard astrology APIs, 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 these two charts.

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.