Moon Range

GET`/api/transits/moon`Pro

Get Moon gate/line positions over a date range, including zodiac sign, retrograde status, and lunar phase data.

Legacy URL supported

The previous endpoint path /api/transit/moon-range 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
`granularity`	string	No	"daily" (default) or "hourly" (default: `daily`)

thd-api

Response

Response200

{
"success": true,
"meta": {
  "endpoint": "transit/moon-range",
  "planet": "Moon",
  "startDate": "2026-03-01",
  "endDate": "2026-03-07",
  "granularity": "daily",
  "count": 7,
  "note": "Moon transits through all 64 gates in ~28 days, spending ~10-11 hours per gate"
},
"data": [
  {
    "datetime": "2026-03-01T12:00:00.000Z",
    "longitude": 145.32,
    "gate": 46,
    "line": 3,
    "color": 2,
    "tone": 4,
    "sign": "Leo",
    "isRetrograde": false,
    "moonPhase": {
      "phase": "Waxing Gibbous",
      "emoji": "🌔",
      "elongation": 135.2,
      "illumination": 82,
      "lunarDay": 11.5
    }
  }
]
}

Moon phase fields

Field	Description
`phase`	Phase name: New Moon, Waxing Crescent, First Quarter, Waxing Gibbous, Full Moon, Waning Gibbous, Last Quarter, Waning Crescent
`emoji`	Visual moon phase emoji
`elongation`	Angular distance between Sun and Moon (0–360°)
`illumination`	Percentage of Moon illuminated (0–100)
`lunarDay`	Days into the 29.53-day lunar cycle

Unit consumption

Daily: 1 unit per day in range
Hourly: 24 units per day in range
Maximum range: 366 days