Transit periods

GET/api/transits/periodsPro

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

Request

Parameters

startDate reqstringStart date in YYYY-MM-DD format

endDate reqstringEnd date in YYYY-MM-DD format (max 366 days from start)

thd-api

Response

✓ doneapplication/json

{
"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

Computation

Transit periods are computed in two phases: an hourly scan detects gate changes, then binary search narrows each transition to minute precision. This provides exact transition times without minute-by-minute polling.

Chart requests

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