GET/v1/horoscope/yearly/{moon_sign}

Yearly horoscope

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

Request parameters

moon_signrequired

string

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

Payload returned by Vedic horoscope GET endpoints.

data.content

object

Stored horoscope prose; fields present depend on horizon (daily/weekly/monthly/yearly).

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.remedy

string

Programmatically injected Vedic remedy text

data.content.do

array[string] | null

Daily: actions to take

data.content.avoid

array[string] | null

Daily: actions to avoid

data.content.open_loop

string | null

Daily: forward-looking watch item

data.content.peak_day

string | null

Weekly: strongest day

data.content.caution_day

string | null

Weekly: day to approach carefully

data.content.weekly_mantra

string | null

Weekly: shareable mantra line

data.content.phases

array[HoroscopePhase] | null

Monthly: phased breakdown

data.content.power_window

string | null

Monthly: favorable date window

data.content.caution_window

string | null

Monthly: cautious date window

data.content.closing_message

string | null

Monthly or yearly: shareable closing line

data.content.year_theme

string | null

Yearly: karmic theme for the year

data.content.chapters

array[HoroscopeChapter] | null

Yearly: chapter breakdown

data.content.auspicious_months

array[string] | null

Yearly: top auspicious months by name

data.content.landmark_dates

array[HoroscopeLandmarkDate] | null

Yearly: key dates with tone

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.moon_sign

string

Normalised English Moon sign slug

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

• Daily horoscope
• Monthly horoscope
• Weekly horoscope

Request

GET·application/json

curl

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

Python

import asterwise
from asterwise.api.horoscope_api import HoroscopeApi

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

with asterwise.ApiClient(configuration) as client:
    api = HoroscopeApi(client)
    result = api.horoscope_yearly(moon_sign="aries")
    print(result)

TypeScript

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

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

const result = await horoscopeYearly({
  client,
  path: {
      "moon_sign": "aries"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "content": {
      "body": "Your Aries Moon rules the head and brain — stress headaches, mental fatigue, and anxiety are the primary physical vulner…",
      "love": "Venus transiting Ashlesha nakshatra in your 4th house brings warmth, friendship, and home-based comfort to relationships…",
      "money": "Rahu in Shatabhisha in your 11th house is your primary financial ally through most of 2026, supporting desire fulfillmen…",
      "career": "Saturn in Revati nakshatra transiting your 12th house suppresses direct career momentum for most of 2026, making behind-…",
      "remedy": "Recite Shani stotra in disciplined weekly rounds across 52 Saturdays.",
      "chapters": [
        {
          "theme": "Saturn in Revati nakshatra, transiting your 12th house, demands patient karmic consolidation over this extended chapter.",
          "title": "The Long Saturn Vigil",
          "end_date": "2026-10-31",
          "narrative": "This chapter spans the bulk of your year and carries the heaviest karmic load of 2026. Saturn in Revati nakshatra holds…",
          "start_date": "2026-01-01",
          "chapter_number": 1
        },
        {
          "theme": "Jupiter enters Leo in your 5th house, bringing a favorable karmic opening for creativity, children, and joy.",
          "title": "Jupiter Lights the Fifth Fire",
          "end_date": "2026-12-05",
          "narrative": "On 2026-10-31, Jupiter crosses into Leo and your 5th house — the dominant event that defines this short but luminous cha…",
          "start_date": "2026-10-31",
          "chapter_number": 2
        },
        "... and 1 more item"
      ],
      "headline": "Saturn's Sade Sati rising phase in Pisces (house 12) demands disciplined reckoning for Aries Moon in 2026.",
      "narrative": "2026 is a year of structured reckoning for your Aries Moon, shaped by three distinct chapters that each carry their own…",
      "year_theme": "Saturn's Sade Sati rising phase casts a karmic shadow over your 12th house, asking Aries Moon to shed what no longer ser…",
      "landmark_dates": [
        {
          "date": "2026-06-02",
          "tone": "mixed",
          "event": "Jupiter enters Cancer in your 4th house, shifting domestic and emotional themes significantly."
        },
        {
          "date": "2026-10-31",
          "tone": "favorable",
          "event": "Jupiter enters Leo in your 5th house, opening a favorable window for creativity and joy."
        },
        "... and 2 more items"
      ],
      "closing_message": "With Saturn's Sade Sati rising in Revati and Jupiter lighting your 5th house by October, 2026 rewards those who build qu…",
      "auspicious_months": [
        "November",
        "December",
        "... and 2 more items"
      ]
    },
    "generated_at": "2026-04-15T19:22:26.825285+00:00",
    "period_key": "2026",
    "horizon": "yearly",
    "moon_sign": "aries"
  }
}