Arabic Parts API
The Arabic Parts, or Hellenistic Lots, are calculated points derived by arithmetic on the chart rather than read directly off the sky. This endpoint computes the Lot of Fortune, Spirit, Eros and the rest from formulas on the Ascendant and two planets, handling the day-birth and night-birth reversal that real Lot practice demands.
Arabic Parts API
From the birth date, time, UTC offset, and coordinates the endpoint first establishes the Ascendant and the relevant planetary longitudes, then applies each Lot's formula — characteristically the Ascendant plus one planet minus another — to produce a derived zodiacal point. It computes the full slate of classical Lots: Fortune, Spirit, Eros and the others handed down in the Hellenistic tradition. Crucially the calculation is sect-aware: for a daytime birth the Lot of Fortune uses one ordering of Sun and Moon, and for a night birth that ordering reverses, with Spirit mirroring it — so the same planetary positions yield different Lots depending on whether the Sun is above or below the horizon. The response returns each Lot under data.parts with its computed longitude, ready to be placed back into the chart by sign and house. These points are not bodies but sensitive degrees, and the endpoint treats them as such, giving you the location without inventing motion or aspects it does not have.
POST/v1/arabic-parts
curl -X POST https://api.astroway.info/v1/arabic-parts \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52
}'{
"ok": true,
"data": {
"parts": [
{
"name": "Fortune",
"longitude": 98.7,
"sign": "Cancer"
},
{
"name": "Spirit",
"longitude": 222.1,
"sign": "Scorpio"
}
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Use this endpoint when a Hellenistic or traditional reading needs the Lots as first-class chart factors — a classical-technique interpreter, a report that discusses Fortune and Spirit as topical significators, or a chart renderer that wants to draw the Lots alongside the planets. Because the sect reversal is handled for you, you avoid the single most common error in Lot computation by hand, and night charts come out correct without special-casing in your own code. Pair it with the natal-chart call: take the Lot longitudes returned here and assign them to houses using the cusps from your chart, so Fortune lands in its proper place. The output is purely positional, which means you can layer your own interpretive treatment of each Lot — what Fortune signifies, what Eros governs — on top of reliable, sect-correct degrees.
Notes
Lot formulas follow the Hellenistic tradition transmitted through sources such as Sahl ibn Bishr and al-Bīrūnī, with the day/night sect handling aligned to the modern reconstruction by Robert Hand and Project Hindsight. Positions feeding the formulas come from the Swiss Ephemeris (Astrodienst) WASM engine in the tropical zodiac, matching the natal endpoints.
Try the Arabic Parts API
Grab a key and make your first call in under a minute.