Transits API
The Transits API returns 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 consume your Chart requests meter based on the time range and granularity:
| Granularity | Chart requests per day | Example |
|---|---|---|
daily | 1 | 30-day range = 30 chart requests |
hourly | 3 | 7-day range = 21 chart requests |
minute | 10 | 1-day range = 10 chart requests |
Responses include X-Quota-Used and X-Quota-Remaining headers (with X-Quota-Meter: chart) to track remaining Chart requests. See Rate limits.
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 |