Composite Chart Data Endpoint #

`POST /api/v5/chart-data/composite` #

📘 View Complete Example

This endpoint calculates the composite chart for two subjects. A composite chart is a single chart derived from the midpoints of the two subjects’ planetary positions. It represents the “relationship itself” as a third entity.

Request Body #

first_subject (object, required): First partner.

{
  "name": "Partner A",
  "year": 1980,
  "month": 1,
  "day": 1,
  "hour": 12,
  "minute": 0,
  "city": "Rome",
  "nation": "IT",
  "longitude": 12.4964,
  "latitude": 41.9028,
  "timezone": "Europe/Rome"
}

second_subject (object, required): Second partner.

{
  "name": "Partner B",
  "year": 1982,
  "month": 3,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "Milan",
  "nation": "IT",
  "longitude": 9.19,
  "latitude": 45.4642,
  "timezone": "Europe/Rome"
}

active_points, active_aspects (optional overrides).

Complete Request Example #

{
  "first_subject": {
    "name": "Partner A",
    "year": 1980,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "city": "Rome",
    "nation": "IT",
    "lng": 12.4964,
    "lat": 41.9028,
    "tz_str": "Europe/Rome"
  },
  "second_subject": {
    "name": "Partner B",
    "year": 1982,
    "month": 3,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "city": "Milan",
    "nation": "IT",
    "lng": 9.19,
    "lat": 45.4642,
    "tz_str": "Europe/Rome"
  }
}

Response Body #

status (string): “OK”.
chart_data (object): The composite chart data.
- planets: Midpoint positions.
- houses: Calculated houses for the composite location/time.
- aspects: Aspects within the composite chart.

Complete Response Example #

{
  "status": "OK",
  "chart_data": {
    "planets": {
      "Sun": {
        "name": "Sun",
        "sign": "Aqu",
        "position": 15.0,
        "abs_pos": 315.0,
        "house": "10th House"
      },
      ...
    },
    "houses": [ ... ],
    "aspects": [ ... ]
  }
}