Subject Context Endpoint #

POST /api/v5/context/subject #

📘 View Complete Example

Provides structured astrological context for AI-driven personality insights based on a subject’s birth data. This endpoint synthesizes key placements into a formatted summary designed to be used as a prompt foundation for Large Language Models (LLMs) to generate coherent, human-readable narratives.

Request Body #

• subject (object, required): The subject’s birth data.

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

Complete Request Example #

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

Response Body #

• status (string): “OK” on success.
• subject_context (string): The generated AI text interpretation.
• subject (object): The calculated subject data used for the interpretation.

Complete Response Example #

{
  "status": "OK",
  "subject_context": "Subject Name was born on ... The Sun is in Capricorn in the 10th House...",
  "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",
    "zodiac_type": "Tropical",
    "sun": { ... },
    "moon": { ... }
    // ... full subject data
  }
}