get

/api/v1/horoscope/monthly

Get monthly horoscope

Overview

Returns a monthly horoscope for the specified zodiac sign, including weekly breakdown, key dates, and moon phases.

Parameters

Name	Type	In	Required	Description
`sign`	string	query	Yes	Zodiac sign Allowed: `AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces`
`year`	string	query	Yes	Year
`month`	string	query	Yes	Month (1-12)
`perspective`	string	query	No	Astrological perspective (sun, moon, or rising) Allowed: `sunmoonrising`

Response

200 — Monthly horoscope

sign string required

Enum:

AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

year number required

Year

month number required

Month (1-12)

signContext object required

element string required: Enum:
FireEarthAirWater
modality string required: Enum:
CardinalFixedMutable
keywords array required: array of string

weeklyBreakdown array required

Weekly breakdown of the month

array of object

weekNumber number required

Week number within the month (1-4)

startDate string required

Start date of the week

endDate string required

End date of the week

ingresses array required

Planet ingresses during this week

array of object

planet string required: Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
sign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
date string required

keyDates array required

Key dates during the month

array of object

date string required: ISO date of the key event
event string required: Name of the event
eventType string required: Type of event; Enum:
moonPhaseingress
planet string: Planet involved (for ingress events); Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
sign string: Sign involved (for ingress events); Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

moonPhases array required

Moon phases during the month

array of object

phase string required: Moon phase name
date string required: ISO date of the moon phase

Example Request

cURL

curl "https://api.almuten.io/api/v1/horoscope/monthly" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "sign": "Aries",
  "year": 2026,
  "month": 3,
  "signContext": {
    "element": "Fire",
    "modality": "Cardinal",
    "keywords": [
      ""
    ]
  },
  "weeklyBreakdown": [
    {
      "weekNumber": 1,
      "startDate": "2026-03-01",
      "endDate": "2026-03-07",
      "ingresses": [
        {
          "planet": null,
          "sign": null,
          "date": null
        }
      ]
    }
  ],
  "keyDates": [
    {
      "date": "2026-03-14",
      "event": "Full Moon",
      "eventType": "moonPhase",
      "planet": "Sun",
      "sign": "Aries"
    }
  ],
  "moonPhases": [
    {
      "phase": "New Moon",
      "date": "2026-03-01"
    }
  ]
}