Now Context Endpoint #

POST /api/v5/now/context #

📘 View Complete Example

Provides a real-time astrological context snapshot for AI interpretations of the current moment (UTC). This endpoint delivers a structured summary of the current planetary atmosphere, designed to be used by an external AI to generate “Daily Horoscopes” or live “Astrological Weather” updates.

Request Body #

• name (string, optional): A custom name for the context (e.g., “Today’s Vibe”). Default: “Now”.
• zodiac_type (string, optional): “Tropical” (default) or “Sidereal”.
• sidereal_mode (string, optional): Required if zodiac_type is “Sidereal”.
• houses_system_identifier (string, optional): House system code (default: “P”).

Complete Request Example #

{
  "name": "Current Atmosphere",
  "zodiac_type": "Tropical"
}

Response Body #

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

Complete Response Example #

{
  "status": "OK",
  "subject_context": "Current Atmosphere (Now): The Sun is in Scorpio...",
  "subject": {
    "name": "Current Atmosphere",
    "year": 2023,
    "month": 10,
    "day": 27,
    "hour": 14,
    "minute": 30,
    "city": "Greenwich",
    "nation": "GB",
    "lng": -0.0015,
    "lat": 51.4779,
    "tz_str": "Etc/UTC",
    "sun": { ... },
    "moon": { ... }
    // ... full subject data
  }
}