Natal Chart Context Endpoint #

POST /api/v5/context/birth-chart #

📘 View Complete Example

Provides structured astrological context for AI interpretations of a full natal chart. This endpoint identifies and summarizes key chart dynamics—including house systems and aspects—providing the “astrological fuel” for an external AI (like GPT or Claude) to generate nuanced readings. It does not generate the final interpretation itself, but prepares the data for an LLM to do so.

Request Body #

• subject (object, required): The subject’s birth data (same structure as /api/v5/chart-data/birth-chart).

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

• Computation options: active_points, active_aspects, distribution_method, custom_distribution_weights (identical to the natal chart-data endpoint). Rendering options such as 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 #

{
  "subject": {
    "name": "Subject Name",
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "city": "London",
    "nation": "GB",
    "lng": -0.1278,
    "lat": 51.5074,
    "tz_str": "Europe/London"
  }
}

Response Body #

• status (string): “OK” on success.
• context (string): The generated AI text interpretation of the natal chart.
• chart_data (object): The complete calculated chart data.

Complete Response Example #

{
  "status": "OK",
  "context": "Natal Chart Analysis for Subject Name...\nThe Sun is in Capricorn...",
  "chart_data": {
    "subject": { ... },
    "houses_list": [ ... ],
    "aspects_list": [ ... ]
    // ... full chart data
  }
}