get

/api/v1/horoscope/yearly

Get yearly horoscope

Overview

Returns a yearly horoscope for the specified zodiac sign, including quarterly breakdown, eclipses, and retrograde periods.

Parameters

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

Response

200 — Yearly horoscope

sign string required

Enum:

AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

year number required

Year

signContext object required

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

quarters array required

Quarterly breakdown of the year

array of object

quarter number required

Quarter number (1-4)

startDate string required

Start date of the quarter

endDate string required

End date of the quarter

ingresses array required

Planet ingresses during the quarter

array of object

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

eclipses array required

Eclipses during the year

array of object

date string required: ISO date of the eclipse
type string required: Type of eclipse
sign string required: Zodiac sign of the eclipse
isDirectImpact boolean required: Whether the eclipse directly impacts the queried sign

retrogrades array required

Retrograde periods during the year

array of object

body string required: The retrograde planet
startDate string required: Start date of retrograde
endDate string required: End date of retrograde
startSign string required: Sign where retrograde begins; Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

Example Request

cURL

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

Example Response

JSON

{
  "sign": "Aries",
  "year": 2026,
  "signContext": {
    "element": "Fire",
    "modality": "Cardinal",
    "keywords": [
      ""
    ]
  },
  "quarters": [
    {
      "quarter": 1,
      "startDate": "2026-01-01",
      "endDate": "2026-03-31",
      "ingresses": [
        {
          "planet": null,
          "sign": null,
          "date": null
        }
      ]
    }
  ],
  "eclipses": [
    {
      "date": "2026-03-03",
      "type": "lunar eclipse",
      "sign": "Virgo",
      "isDirectImpact": true
    }
  ],
  "retrogrades": [
    {
      "body": "Mercury",
      "startDate": "2026-04-01",
      "endDate": "2026-04-25",
      "startSign": "Aries"
    }
  ]
}