get

/api/v1/horoscope/weekly

Get weekly horoscope

Overview

Returns structured weekly horoscope data with daily snapshots.

Parameters

Name	Type	In	Required	Description
`sign`	string	query	Yes	Zodiac sign Allowed: `AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces`
`perspective`	string	query	No	Astrological perspective (sun, moon, or rising) Allowed: `sunmoonrising`
`date`	string	query	No	Date in ISO format (YYYY-MM-DD) or datetime (YYYY-MM-DDTHH:MM:SSZ or with offset). Defaults to today.
`timezone`	string	query	No	IANA timezone name (e.g., America/New_York). Used with date-only values to resolve local time.

Response

200 — Weekly horoscope

sign string required

Enum:

AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

weekStart string required

weekEnd string required

perspective string

Enum:

sunmoonrising

signContext object required

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

rulerCondition object required

ruler string required: Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
startSign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
endSign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
signChanged boolean required

moonPhaseAtStart string required

Enum:

New MoonWaxing CrescentFirst QuarterWaxing GibbousFull MoonWaning GibbousLast QuarterWaning Crescent

moonPhaseAtEnd string required

Enum:

New MoonWaxing CrescentFirst QuarterWaxing GibbousFull MoonWaning GibbousLast QuarterWaning Crescent

dailySnapshots array required

array of object

date string required

transits array required

array of object

planet string required: Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
planetSign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
aspectType string required: Enum:
conjunctionsextilesquaretrineoppositionquincunxsemiSextilesemiSquaresesquiquadratequintilebiquintile
aspectNature string required: Enum:
harmoniouschallengingneutral
orb number required
isApplying boolean required

moonPhase string required

Enum:

New MoonWaxing CrescentFirst QuarterWaxing GibbousFull MoonWaning GibbousLast QuarterWaning Crescent

voidOfCourse boolean required

Example Request

cURL

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

Example Response

JSON

{
  "sign": "Aries",
  "weekStart": "",
  "weekEnd": "",
  "perspective": "sun",
  "signContext": {
    "element": "Fire",
    "modality": "Cardinal",
    "keywords": [
      ""
    ]
  },
  "rulerCondition": {
    "ruler": "Sun",
    "startSign": "Aries",
    "endSign": "Aries",
    "signChanged": true
  },
  "moonPhaseAtStart": "New Moon",
  "moonPhaseAtEnd": "New Moon",
  "dailySnapshots": [
    {
      "date": "",
      "transits": [
        {
          "planet": null,
          "planetSign": null,
          "aspectType": null,
          "aspectNature": null,
          "orb": null,
          "isApplying": null
        }
      ],
      "moonPhase": "New Moon",
      "voidOfCourse": true
    }
  ]
}