get

/api/v1/horoscope/daily

Get daily horoscope

Overview

Returns structured daily horoscope data for the specified zodiac sign.

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 — Daily horoscope

sign string required

Enum:

AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

date string required

perspective string

Astrological perspective used (sun, moon, or rising)

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
sign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

moonContext object required

phase string required: Enum:
New MoonWaxing CrescentFirst QuarterWaxing GibbousFull MoonWaning GibbousLast QuarterWaning Crescent
illumination number required

voidOfCourseStatus object required

isVoidOfCourse boolean required
moonSign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
endsAt string

transits array required

Key transits affecting this sign (up to 3)

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

retrogrades array required

Currently retrograde planets

array of object

planet string required: Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
sign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
isTransitingSign boolean required

Example Request

cURL

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

Example Response

JSON

{
  "sign": "Aries",
  "date": "2025-11-26",
  "perspective": "sun",
  "signContext": {
    "element": "Fire",
    "modality": "Cardinal",
    "keywords": [
      ""
    ]
  },
  "rulerCondition": {
    "ruler": "Sun",
    "sign": "Aries"
  },
  "moonContext": {
    "phase": "New Moon",
    "illumination": 0
  },
  "voidOfCourseStatus": {
    "isVoidOfCourse": true,
    "moonSign": "Aries",
    "endsAt": ""
  },
  "transits": [
    {
      "planet": "Sun",
      "planetSign": "Aries",
      "aspectType": "conjunction",
      "aspectNature": "harmonious",
      "orb": 0,
      "isApplying": true
    }
  ],
  "retrogrades": [
    {
      "planet": "Sun",
      "sign": "Aries",
      "isTransitingSign": true
    }
  ]
}