get

/api/v1/horoscope/personalized

Get personalized horoscope

Overview

Returns a personalized horoscope based on birth data and current transit positions against the natal chart.

Parameters

Name	Type	In	Required	Description
`birthDate`	string	query	Yes	Birth date in YYYY-MM-DD format
`birthTime`	string	query	No	Birth time in HH:MM format (24h)
`latitude`	string	query	Yes	Birth location latitude
`longitude`	string	query	Yes	Birth location longitude
`date`	string	query	No	Transit date in YYYY-MM-DD format (defaults to today)
`perspective`	string	query	No	Astrological perspective Allowed: `sunmoonrising`

Response

200 — Personalized horoscope

birthDate string required

Birth date used for the chart

date string required

Date the horoscope is for

sunSign string required

Enum:

AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

moonSign string

Natal Moon sign

Enum:

AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

ascendantSign string

Natal Ascendant sign

Enum:

AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

perspective string

Astrological perspective used

Enum:

sunmoonrising

activeTransits array required

Active transits affecting the natal chart

array of object

transitBody string required: The transiting planet; Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
transitSign string required: Sign of the transiting planet; Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
aspectType string required: Type of aspect formed; Enum:
conjunctionsextilesquaretrineoppositionquincunxsemiSextilesemiSquaresesquiquadratequintilebiquintile
aspectNature string required: Nature of the aspect; Enum:
harmoniouschallengingneutral
natalBody string required: The natal body being aspected; Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
significance string required: Significance level of the transit; Enum:
majormoderateminor
orb number required: Orb of the aspect in degrees

Example Request

cURL

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

Example Response

JSON

{
  "birthDate": "1990-06-15",
  "date": "2026-03-17",
  "sunSign": "Aries",
  "moonSign": "Aries",
  "ascendantSign": "Aries",
  "perspective": "sun",
  "activeTransits": [
    {
      "transitBody": "Saturn",
      "transitSign": "Pisces",
      "aspectType": "conjunction",
      "aspectNature": "neutral",
      "natalBody": "Sun",
      "significance": "major",
      "orb": 2.5
    }
  ]
}