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

Western yearly horoscope

Returns this year's pre-generated Western yearly horoscope for the given Sun sign.

Request parameters

sun_signrequired

string

Response fields

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

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

Reserved; product endpoints are not feature-gated by plan (quota differs by tier).

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Western daily horoscope
• Western monthly horoscope
• Western weekly horoscope

Request

GET·application/json

curl

curl -X GET "https://api.asterwise.com/v1/western/horoscope/yearly/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_yearly(sun_sign="aries")
    print(result)

TypeScript

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

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

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

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "content": {
      "body": "Saturn in Aries rules the head, skull, and adrenal system — expect this transit to make stress management a non-negotiab…",
      "love": "Neptune in early Aries alongside Saturn creates a paradox in love: longing for an ideal partner while being held to stri…",
      "money": "Jupiter in Cancer through the first half of 2026 favors investments tied to home, real estate, and family security — but…",
      "career": "Saturn's entry into Aries on February 14 makes 2026 a defining professional chapter — shortcuts are rejected and only ge…",
      "chapters": [
        {
          "title": "Saturn Enters Aries, Jupiter Holds Cancer",
          "end_date": "2026-03-31",
          "narrative": "The year opens with Jupiter in Cancer applying a quiet but insistent pressure to your Aries identity through a square —…",
          "start_date": "2026-01-01",
          "chapter_number": 1
        },
        {
          "title": "Jupiter Cancer Square Tests Aries Resolve",
          "end_date": "2026-06-30",
          "narrative": "With Jupiter still moving through Cancer and Saturn now settled in Aries, this chapter delivers the year's most challeng…",
          "start_date": "2026-04-01",
          "chapter_number": 2
        },
        "... and 2 more items"
      ],
      "headline": "Saturn enters your sign in 2026, demanding that Aries own its power with discipline and precision.",
      "narrative": "2026 is defined by two slow-planet storylines weaving through your year, Aries. Saturn formally enters your sign on Febr…",
      "year_theme": "Saturn's entry into Aries collides with Jupiter's nurturing Cancer transit, then Leo's bold expansion — 2026 is your yea…",
      "landmark_dates": [
        {
          "date": "2026-02-14",
          "event": "Saturn enters Aries, beginning a defining multi-year transit through your sun sign."
        },
        {
          "date": "2026-06-30",
          "event": "Jupiter enters Leo, igniting a fire-sign trine that supercharges Aries confidence and creativity."
        }
      ],
      "closing_message": "Saturn in Aries and Jupiter in Leo confirm it: 2026 is the year Aries stops preparing and starts becoming. Your moment i…",
      "auspicious_months": [
        "March",
        "June",
        "... and 1 more item"
      ]
    },
    "generated_at": "2026-05-24T18:04:19.978442+00:00",
    "period_key": "2026",
    "horizon": "yearly",
    "sun_sign": "aries",
    "zodiac_type": "western"
  }
}