Weekly horoscope

Returns this week's pre-generated weekly horoscope for the given Moon sign.

Endpoint

GET /v1/horoscope/weekly/{moon_sign}

Request parameters

Field	Type	Required	Description
moon_sign	string	Yes

Example request

curl

curl -X GET "https://api.asterwise.com/v1/horoscope/weekly/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_weekly(moon_sign="aries")
    print(result)

TypeScript

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

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

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

console.log(result.data);

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "content": {
      "body": "Aries rules your head and brain—focus on mental clarity and nervous system rest. Sun's affliction in your 2nd house comp…",
      "love": "Moon in Tula at quality 50 with Vedha to Mercury creates relationship happiness and partnership harmony—your strongest r…",
      "money": "Mercury's strong position in Vrishabha at quality 72 promises direct financial gain and wealth accumulation. Venus in th…",
      "career": "Mercury in Mrigashira nakshatra at quality score 72 supports financial and speech-based gains, yet Jupiter's affliction…",
      "remedy": "Perform Surya mantra japa on Sunday morning facing east.",
      "headline": "Mercury's financial gain faces Mars and Saturn's shadow this week.",
      "peak_day": "Friday, May 29th. Venus, the vara lord of Shukravar, channels prosperity and social ease through the Chal choghadiya win…",
      "narrative": "This week presents a sharp contrast between opportunity and caution. Mercury dominates your financial prospects, station…",
      "caution_day": "Sunday, May 31st. Chandra Ashtama activates as your Moon transits into the 8th house, triggering emotional obscurity, hi…",
      "weekly_mantra": "Mercury's speech wins gold, yet Mars warns silence on caution days."
    },
    "generated_at": "2026-05-25T18:35:03.515273+00:00",
    "period_key": "2026-W21",
    "horizon": "weekly",
    "moon_sign": "aries"
  }
}

Response fields

Field	Type	Description
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

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

• Daily horoscope
• Monthly horoscope
• Yearly horoscope