get

/api/v1/fixed-stars/conjunctions

Find planet-star conjunctions

Overview

Returns all conjunctions between specified celestial bodies and fixed stars within a given orb.

Parameters

Name	Type	In	Required	Description
`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.
`bodies`	string	query	No	Comma-separated list of celestial bodies to include
`orb`	string	query	No	Maximum orb in degrees (default: 1)

Response

200 — Planet-star conjunctions

date string required

orb number required

conjunctions array required

array of object

star string required
body string required: Enum:
SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex
orb number required
starLongitude number required
bodyLongitude number required
sign string required

Example Request

cURL

curl "https://api.almuten.io/api/v1/fixed-stars/conjunctions" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "date": "",
  "orb": 0,
  "conjunctions": [
    {
      "star": "",
      "body": "Sun",
      "orb": 0,
      "starLongitude": 0,
      "bodyLongitude": 0,
      "sign": ""
    }
  ]
}