Transits API
Track planetary movements through the Human Design gates over time. Transit endpoints provide real-time and historical gate activations for all 13 Human Design planets.
Endpoints
| Endpoint | Description |
|---|---|
| Moon Range | Moon gate/line positions over a date range with zodiac and phase data |
| All Planets | All 13 HD planets with configurable granularity (daily/hourly/minute) |
| Transit Charts | Full HD chart snapshots per time point |
| Transit Periods | Gate entry/exit events at minute precision |
| Retrograde Periods | Retrograde station dates computed via binary search |
All transit endpoints require the Advanced Chart API product.
Usage-based billing
Transit endpoints draw from your Chart requests meter based on the time range and granularity requested:
| Granularity | Chart requests per day | Example |
|---|---|---|
daily | 1 | 30-day range = 30 chart requests |
hourly | 24 | 7-day range = 168 chart requests |
minute | 1,440 | 1-day range = 1,440 chart requests |
Each response carries X-Quota-Used and X-Quota-Remaining headers (with X-Quota-Meter: chart) so you can track your remaining Chart requests. See the Rate Limits page.
Common parameters
Most transit endpoints share these query 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), hourly, or minute |