Transit Periods

GET`/api/transits/periods`Pro

Get gate entry and exit events for all planets at minute precision. Uses hourly scanning with binary search refinement to find exact gate transition times.

Legacy URL supported

The previous endpoint path /api/transit-periods is still supported and will continue to work.

Request

Parameters

Parameter	Type	Required	Description
`startDate`	string	Yes	Start date in YYYY-MM-DD format
`endDate`	string	Yes	End date in YYYY-MM-DD format (max 366 days from start)

thd-api

Response

Response200

{
"success": true,
"meta": {
  "endpoint": "transit-periods",
  "startDate": "2026-03-01",
  "endDate": "2026-04-01",
  "periodCount": 245,
  "granularity": "minute",
  "planets": ["Sun", "Earth", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "NorthNode", "SouthNode"]
},
"data": [
  {
    "planet": "Sun",
    "gate": 22,
    "line": 4,
    "entered_at": "2026-03-01T00:00:00.000Z",
    "exited_at": "2026-03-06T14:23:00.000Z",
    "duration_hours": 134.38,
    "zodiac_sign": "Pisces",
    "retrograde_at_entry": false
  },
  {
    "planet": "Moon",
    "gate": 41,
    "line": 1,
    "entered_at": "2026-03-01T03:47:00.000Z",
    "exited_at": "2026-03-01T14:12:00.000Z",
    "duration_hours": 10.42,
    "zodiac_sign": "Aquarius",
    "retrograde_at_entry": false
  }
]
}

Field	Description
`planet`	Planet name (one of the 13 HD planets)
`gate`	HD gate number (1–64)
`line`	Line number (1–6)
`entered_at`	ISO timestamp when planet entered this gate (minute precision)
`exited_at`	ISO timestamp when planet exited, or `null` if still in gate at range end
`duration_hours`	Duration in hours
`zodiac_sign`	Zodiac sign at entry
`retrograde_at_entry`	Whether the planet was retrograde when entering the gate

How it works

Transit periods are computed in two phases: an hourly scan detects gate changes, then binary search narrows each transition to minute precision. This gives you exact gate entry/exit times without the cost of minute-by-minute polling.

Unit consumption

1 unit per request (flat rate, not granularity-based). Maximum range: 366 days.