Western monthly horoscope

Returns this month's pre-generated Western monthly horoscope for the given Sun sign.

Endpoint

GET /v1/western/horoscope/monthly/{sun_sign}

Request parameters

Field	Type	Required	Description
sun_sign	string	Yes

Example request

curl

curl -X GET "https://api.asterwise.com/v1/western/horoscope/monthly/aries" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import asterwise
from asterwise.api.western_api import WesternApi

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

with asterwise.ApiClient(configuration) as client:
    api = WesternApi(client)
    result = api.western_horoscope_monthly(sun_sign="aries")
    print(result)

TypeScript

import { createClient, createConfig, westernHoroscopeMonthly } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await westernHoroscopeMonthly({
  client,
  path: {
      "sun_sign": "aries"
  },
});

console.log(result.data);

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "content": {
      "body": "Saturn in Aries invites physical discipline: strength training, consistent movement, and deliberate rest matter now. Mer…",
      "love": "Mars sextile Venus ignites attraction and romantic momentum. Mercury conjunct Sun in Taurus fosters heartfelt, grounded…",
      "money": "Saturn in Aries demands fiscal discipline and honest budget review. Mercury conjunct Sun in Taurus illuminates financial…",
      "career": "Saturn in Aries sharpens your professional edge; refine strategies and strengthen expertise. Mercury conjunct Sun in Tau…",
      "phases": [
        {
          "title": "Saturn Aries Hardens Your Foundation",
          "end_date": "2026-05-10",
          "narrative": "Saturn in Aries anchors you with karmic responsibility. Early May asks you to examine where you lack structure or clarit…",
          "start_date": "2026-05-01",
          "phase_number": 1
        },
        {
          "title": "Mars Venus Sextile Ignites Attraction",
          "end_date": "2026-05-20",
          "narrative": "Mid-May ignites your romantic and creative energy. Mars sextile Venus opens pathways for partnership, artistic expressio…",
          "start_date": "2026-05-11",
          "phase_number": 2
        },
        "... and 1 more item"
      ],
      "headline": "Saturn in Aries tightens discipline as Mars kindles your native fire.",
      "narrative": "May arrives with Saturn firmly planted in Aries, your sign, demanding that you refine your approach and build lasting st…",
      "power_window": "May 16–20 amplifies your magnetism and decisiveness. Mars sextile Venus peaks during this window, empowering proposals,…",
      "caution_window": "May 3–7 calls for careful discernment. Saturn semisquare Mercury and Sun tests communication clarity. Mercury semisquare…",
      "closing_message": "Saturn shapes your May with clarity and grit. Mars and Venus light the path forward. Stand firm, speak truth, and let di…"
    },
    "generated_at": "2026-05-24T18:01:48.687796+00:00",
    "period_key": "2026-05",
    "horizon": "monthly",
    "sun_sign": "aries",
    "zodiac_type": "western"
  }
}

Response fields

Field	Type	Description
success	boolean	True if the request succeeded
message	string	Human-readable status message
data	object	Payload returned by Western horoscope GET endpoints.
data.content	object	Stored Western tropical horoscope prose; no remedy field.
data.content.headline	string
data.content.narrative	string
data.content.career	string
data.content.money	string
data.content.love	string
data.content.body	string
data.content.power_window	string | null	Favorable action window with tropical transit context
data.content.caution_window	string | null	Cautious or low-energy window with tropical transit context
data.content.closing_message	string | null	Shareable closing line for the period
data.content.phases	array[HoroscopePhase] | null	Monthly: phased breakdown
data.content.year_theme	string | null	Yearly: tropical theme for the year
data.content.chapters	array[WesternHoroscopeChapter] | null	Yearly: chapter breakdown
data.content.auspicious_months	array[string] | null	Yearly: auspicious month names
data.content.landmark_dates	array[WesternHoroscopeLandmarkDate] | null	Yearly: key dates
data.generated_at	string | null	ISO timestamp when the horoscope was generated (UTC)
data.period_key	string	Period identifier (date, week, month, or year key)
data.horizon	string	Horizon: daily, weekly, monthly, or yearly
data.sun_sign	string	Normalised English tropical Sun sign slug
data.zodiac_type	string	Always western for these endpoints

Errors

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

Related endpoints

• Western daily horoscope
• Western weekly horoscope
• Western yearly horoscope