get

/api/v1/horoscope/dynamic

Get dynamic horoscope

Overview

Returns a dynamically generated horoscope based on real-time planetary transits, sign ruler position, and aspects.

Parameters

NameTypeInRequiredDescription
signstringqueryYes

Zodiac sign

Allowed:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
datestringqueryNo

Date in YYYY-MM-DD format (defaults to today)

Response

200 — Dynamic horoscope

sign string required
Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
date string required
Date the horoscope is for
signContext object required
element string required
Enum:
FireEarthAirWater
modality string required
Enum:
CardinalFixedMutable
keywords array required

array of string

transits array required
Transits involving the sign ruler

Transits involving the sign ruler

array of object

planet string required
The other planet in the aspect
Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
aspectType string required
Type of aspect
Enum:
conjunctionsextilesquaretrineoppositionquincunxsemiSextilesemiSquaresesquiquadratequintilebiquintile
aspectNature string required
Nature of the aspect
Enum:
harmoniouschallengingneutral
rulerPosition object required
Current position of the sign ruler

Current position of the sign ruler

ruler string required
Name of the ruling planet
Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
sign string required
Current sign of the ruler
Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

Example Request

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

Example Response

JSON
{
  "sign": "Aries",
  "date": "2026-03-17",
  "signContext": {
    "element": "Fire",
    "modality": "Cardinal",
    "keywords": [
      ""
    ]
  },
  "transits": [
    {
      "planet": "Jupiter",
      "aspectType": "trine",
      "aspectNature": "harmonious"
    }
  ],
  "rulerPosition": {
    "ruler": "Mars",
    "sign": "Gemini"
  }
}