Synastry Context Endpoint #

`POST /api/v5/context/synastry` #

📘 View Complete Example

Provides formatted astrological context for AI interpretations of relationship (synastry) charts. This endpoint analyzes compatibility, chemistry, and dynamics between two subjects, delivering a structured summary that serves as the foundation for an external AI to generate human-readable relationship insights.

Request Body #

first_subject (object, required): The first partner (Inner Wheel).

{
  "name": "Partner 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 second partner (Outer Wheel).

{
  "name": "Partner 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"
}

Computation options: flags such as include_house_comparison, include_relationship_score, active_points, active_aspects, distribution_method, custom_distribution_weights (identical to /api/v5/chart-data/synastry). Rendering options like theme, language, split_chart, transparent_background, show_house_position_comparison, show_cusp_position_comparison, show_degree_indicators, custom_title are not accepted here.

Complete Request Example #

{
  "first_subject": {
    "name": "Partner 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": "Partner 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” on success.
context (string): The generated AI text interpretation of the relationship.
chart_data (object): The complete calculated synastry chart data.

Complete Response Example #

{
  "status": "OK",
  "context": "Synastry Analysis between Partner A and Partner B...\nPartner A's Sun is conjunct Partner B's Moon...",
  "chart_data": {
    "first_subject": { ... },
    "second_subject": { ... },
    "aspects_list": [ ... ]
    // ... full synastry data
  }
}