Now Subject Endpoint #

POST /api/v5/now/subject #

📘 View Complete Example

This endpoint generates an astrological subject for the current moment (UTC). It is essentially a “real-time” astrology calculator. It automatically fetches the current time and sets the location to Greenwich (UTC reference) to provide a universal “now” perspective.

This is useful for:

• Checking current planetary transits.
• Displaying a “sky now” feature.
• Getting the current astrological atmosphere.

Request Body #

The request body allows you to configure the calculation parameters. Since the time and location are fixed to “now” and “Greenwich”, you only provide configuration options.

• name (string, optional): A custom name for the subject (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 Sky",
  "zodiac_type": "Tropical",
  "houses_system_identifier": "P"
}

Response Body #

Returns the calculated subject for the current moment.

• status (string): “OK”.
• subject (object): The calculated astrological subject.

Complete Response Example #

{
  "status": "OK",
  "subject": {
    "name": "Current Sky",
    "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": {
      "name": "Sun",
      "sign": "Sco",
      "position": 4.5,
      "abs_pos": 214.5,
      "emoji": "♏",
      "house": "9th House"
    },
    "moon": {
      "name": "Moon",
      "sign": "Ari",
      "position": 12.0,
      "abs_pos": 12.0,
      "emoji": "♈",
      "house": "2nd House"
    }
    // ... other planets and houses
  }
}