GET/v1/horoscope/monthly/{moon_sign}

Monthly horoscope

Returns this month's pre-generated monthly 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

The period this horoscope covers, on the India Standard Time calendar: YYYY-MM-DD (daily), YYYY-Www, the ISO week of that week's Monday (weekly), YYYY-MM (monthly) or YYYY (yearly).

data.horizon

string

Horizon: daily, weekly, monthly, or yearly

data.moon_sign

string

Normalised English Moon sign slug

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Daily horoscope
• Weekly horoscope
• Yearly horoscope

Request

GET·application/json

curl

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

TypeScript

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

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

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

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "content": {
      "body": "Your Aries Moon governs the head and brain; mental clarity strengthens through Bharani's fortunate opening. Mars in Ashw…",
      "love": "Venus in the third house, its vedha cancelled by Moon, sustains prosperity and social gains. Mars in the first house con…",
      "money": "Mercury in Krittika nakshatra within the second house generates financial gain and wealth accumulation despite combustio…",
      "career": "Jupiter in Mithuna at house three signals career setbacks and business obstacles; Saturn in the eleventh house further s…",
      "phases": [
        {
          "title": "Stable Transit, Sade Sati Ascending",
          "end_date": "2026-05-31",
          "narrative": "This entire month proceeds without slow planet sign shifts, offering structural stability. Rahu retrograde in Shatabhish…",
          "start_date": "2026-05-01",
          "phase_number": 1
        }
      ],
      "remedy": "Donate black blanket, footwear, or sesame to the needy.",
      "headline": "Rahu in the eleventh house brings desire fulfillment amid Sade Sati's rising pressure.",
      "narrative": "May 2026 arrives as a stable transit month with Rahu positioned favorably in your eleventh house of gains and aspiration…",
      "power_window": "From May 1–3, slow planets concentrate in favorable houses. Use these days for financial decisions, relationship initiat…",
      "caution_window": "From May 4–6, slow planets align in weakened positions. Proceed cautiously with major commitments, travel, or confrontat…",
      "closing_message": "Rahu's retrograde strength fuels May's hidden gains; honor Saturn's rising discipline with Saturday remedies and self-ca…"
    },
    "generated_at": "2026-05-02T09:46:44.674384+00:00",
    "period_key": "2026-05",
    "horizon": "monthly",
    "moon_sign": "aries"
  }
}