get

/api/v1/eclipses/seasons/nodal-cycle

Get nodal cycle position

Overview

Returns the current position within the ~18.6-year nodal cycle, including the North Node longitude, cycle phase (0-1), and estimated completion date.

Parameters

NameTypeInRequiredDescription
datestringqueryNo

Date in ISO format (YYYY-MM-DD) or datetime (YYYY-MM-DDTHH:MM:SSZ or with offset). Defaults to today.

timezonestringqueryNo

IANA timezone name (e.g., America/New_York). Used with date-only values to resolve local time.

Response

200 — Nodal cycle position data

date string required
ISO date for this calculation
northNodeLongitude number required
North Node's ecliptic longitude in degrees
cyclePosition number required
Phase of the nodal cycle (0-1)
nextFullCycleDate string required
Approximate ISO date when the nodal cycle completes one revolution

Example Request

cURL
curl "https://api.almuten.io/api/v1/eclipses/seasons/nodal-cycle" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON
{
  "date": "2025-06-15",
  "northNodeLongitude": 345.67,
  "cyclePosition": 0.4523,
  "nextFullCycleDate": "2043-12-15"
}