Synastry Chart Data Endpoint #

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

📘 View Complete Example

This endpoint calculates the synastry (relationship) data between two subjects. It returns the positions for both subjects and the inter-aspects between them.

Request Body #

first_subject (object, required): The “inner wheel” subject.

{
  "name": "Person A",
  "year": 1990,
  "month": 1,
  "day": 1,
  "hour": 12,
  "minute": 0,
  "city": "London",
  "nation": "GB",
  "longitude": -0.1278,
  "latitude": 51.5074,
  "timezone": "Europe/London"
}

second_subject (object, required): The “outer wheel” subject.

{
  "name": "Person B",
  "year": 1992,
  "month": 5,
  "day": 15,
  "hour": 18,
  "minute": 30,
  "city": "New York",
  "nation": "US",
  "longitude": -74.006,
  "latitude": 40.7128,
  "timezone": "America/New_York"
}

include_house_comparison (bool, optional): Include house overlay analysis (default: true).
include_relationship_score (bool, optional): Include compatibility score (default: true).
active_points, active_aspects (optional overrides).

Complete Request Example #

{
  "first_subject": {
    "name": "Person A",
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "city": "London",
    "nation": "GB",
    "lng": -0.1278,
    "lat": 51.5074,
    "tz_str": "Europe/London"
  },
  "second_subject": {
    "name": "Person B",
    "year": 1992,
    "month": 5,
    "day": 15,
    "hour": 18,
    "minute": 30,
    "city": "New York",
    "nation": "US",
    "lng": -74.006,
    "lat": 40.7128,
    "tz_str": "America/New_York"
  }
}

Response Body #

status (string): “OK”.
chart_data (object):
- first_subject: Full chart data for person A.
- second_subject: Full chart data for person B.
- aspects: List of inter-aspects (Person A planet vs Person B planet).
- relationship_score: (if requested) Compatibility analysis.
- house_comparison: (if requested) Where Person B’s planets fall in Person A’s houses.

Complete Response Example #

{
  "status": "OK",
  "chart_data": {
    "first_subject": { ... },
    "second_subject": { ... },
    "aspects": [
      {
        "p1_name": "Sun",
        "p2_name": "Moon",
        "aspect": "Trine",
        "orb": 2.1
      }
    ],
    "relationship_score": {
      "score_value": 15.5,
      "score_description": "Very high compatibility..."
    }
  }
}