Morphemeris DocsWork with Arabic Parts/Lots
Compute and interpret Arabic Parts (Lots) in a natal chart.
Work with Arabic Parts/Lots
Use the /v1/lots endpoint to compute the 7 Hermetic lots for any chart. The API automatically handles day/night formula reversal based on the Sun's position relative to the horizon.
Compute all lots for a birth chart
curl "https://api.morphemeris.com/v1/lots?\
datetime=1990-06-15T18:30:00Z\
&lat=38.4496&lon=-78.8689" \
-H "Authorization: Bearer morphemeris_live_YOUR_KEY"The response tells you whether it's a day or night chart, and gives each lot's longitude, sign, degree, and house placement.
Read the Part of Fortune
The Part of Fortune is the most commonly used lot. Its house placement indicates where material wellbeing manifests:
const res = await fetch(
"https://api.morphemeris.com/v1/lots?" + new URLSearchParams({
datetime: "1990-06-15T18:30:00Z",
lat: "38.4496", lon: "-78.8689",
lots: "fortune",
}),
{ headers: { Authorization: `Bearer ${apiKey}` } }
);
const { data } = await res.json();
const fortune = data.lots[0];
console.log(`Day chart: ${data.is_day_chart}`);
console.log(`Part of Fortune: ${fortune.sign} ${fortune.sign_degree.toFixed(1)}° (house ${fortune.house})`);
console.log(`Formula reversed: ${fortune.formula.reversed}`);Combine lots with a natal chart
Lots don't include aspect data on their own. To see how lots relate to natal planets, compute both and compare:
import requests
headers = {"Authorization": "Bearer morphemeris_live_YOUR_KEY"}
params = {
"datetime": "1990-06-15T18:30:00Z",
"lat": 38.4496, "lon": -78.8689,
}
# Get the natal chart
natal = requests.get(
"https://api.morphemeris.com/v1/natal-chart",
params=params, headers=headers,
).json()["data"]
# Get the lots
lots = requests.get(
"https://api.morphemeris.com/v1/lots",
params=params, headers=headers,
).json()["data"]
# Check which natal planets share a house with the Part of Fortune
fortune = next(l for l in lots["lots"] if l["name"] == "fortune")
for body in natal["bodies"]:
if body.get("house") == fortune["house"]:
print(f"{body['name']} is in the same house as the Part of Fortune (house {fortune['house']})")Use lots in a batch request
Lots pair well with other chart data. Use /v1/batch to get everything in one call:
curl -X POST "https://api.morphemeris.com/v1/batch" \
-H "Authorization: Bearer morphemeris_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"requests": [
{ "endpoint": "/v1/natal-chart", "params": { "datetime": "1990-06-15T18:30:00Z", "lat": 38.4496, "lon": -78.8689 } },
{ "endpoint": "/v1/lots", "params": { "datetime": "1990-06-15T18:30:00Z", "lat": 38.4496, "lon": -78.8689 } }
]
}'Tips
- Lots cost 1 credit. Use the
lotsparameter to request only the ones you need. - Location (
lat/lon) is required because lots need the Ascendant, which depends on the local horizon. - The
formulafield in each lot shows exactly which bodies were used and whether the formula was reversed — useful for verifying calculations or explaining the result to users. - See Arabic Parts/Lots for background on how lots work and what each one represents.