GET /v1/lots — The seven Hermetic lots with automatic day/night formula reversal.

Arabic Parts/Lots

Compute the seven Hermetic lots of Paulus Alexandrinus — Fortune, Spirit, Eros, Necessity, Courage, Victory, and Nemesis — with automatic day/night formula reversal based on the Sun's position relative to the horizon.

Text

GET  /v1/lots
POST /v1/lots

Credit cost: 1

Parameters

Parameter	Type	Required	Default	Description
`datetime`	string	One of `datetime` or `jd`	—	ISO 8601 UTC datetime
`jd`	number	One of `datetime` or `jd`	—	Julian Day in UT1
`lat`	number	Yes	—	Observer latitude (degrees)
`lon`	number	Yes	—	Observer longitude (degrees)
`bodies`	string	No	`"planets"`	Comma-separated body names
`system`	string	No	`"placidus"`	House system
`lots`	string	No	All 7	Comma-separated keywords matched against the lot names: `fortune`, `spirit`, `eros`, `necessity`, `courage`, `victory`, `nemesis`. A lot built on Fortune or Spirit brings that lot along
`sidereal`	string	No	—	Ayanamsha for sidereal mode

Available lots

fortune, spirit, eros, necessity, courage, victory, nemesis

All seven reverse at night. Five of them take Fortune or Spirit as a term, so they are evaluated in this order, and asking for one of those five brings the lot it is built on along: lots=eros returns Spirit and Eros.

Lot	Day formula	Night formula
Fortune	Asc + Moon - Sun	Asc + Sun - Moon
Spirit	Asc + Sun - Moon	Asc + Moon - Sun
Eros	Asc + Venus - Spirit	Asc + Spirit - Venus
Necessity	Asc + Fortune - Mercury	Asc + Mercury - Fortune
Courage	Asc + Fortune - Mars	Asc + Mars - Fortune
Victory	Asc + Jupiter - Spirit	Asc + Spirit - Jupiter
Nemesis	Asc + Fortune - Saturn	Asc + Saturn - Fortune

These are the seven lots of Paulus Alexandrinus (Introduction, ch. 23) and Vettius Valens, in the reconstruction used by Greenbaum and Brennan. The lots parameter of /v1/midpoints computes the same seven.

Response

JSON

{
  "data": {
    "is_day_chart": true,
    "lots": [
      {
        "name": "Part of Fortune",
        "longitude": 233.302,
        "sign": "scorpio",
        "sign_degree": 23.302,
        "house": 10,
        "formula": {
          "body_a": "moon",
          "body_b": "sun",
          "ascendant": 288.375,
          "reversed": false
        }
      },
      {
        "name": "Part of Spirit",
        "longitude": 343.448,
        "sign": "pisces",
        "sign_degree": 13.448,
        "house": 2,
        "formula": {
          "body_a": "sun",
          "body_b": "moon",
          "ascendant": 288.375,
          "reversed": false
        }
      },
      {
        "name": "Part of Eros",
        "longitude": 216.019,
        "sign": "scorpio",
        "sign_degree": 6.019,
        "house": 10,
        "formula": {
          "body_a": "venus",
          "body_b": "part_of_spirit",
          "ascendant": 288.375,
          "reversed": false
        }
      }
    ]
  },
  "meta": {
    "credits_used": 1,
    "..."
  }
}

Each lot includes:

name — The lot's full name (Part of Fortune); the lots parameter matches on the keyword (fortune)
longitude — Ecliptic longitude (0-360)
sign / sign_degree — Zodiac sign and degree within sign
house — House placement (1-12)
formula — The formula as applied: longitude = ascendant + body_a − body_b, with body_a and body_b already swapped when reversed is true (a night chart). An operand that is a lot rather than a body is named by its snake_case id (part_of_spirit), and that lot appears earlier in the same response

In sidereal mode the Ascendant and both bodies are sidereal, so each lot is the tropical lot minus the ayanamsha and its house is the same. The test suite recomputes every lot from /v1/positions and /v1/houses (and, for the five built on Fortune or Spirit, from the lot before it), and the sect from the Sun's altitude.

Examples

All lots for a birth chart

Bash

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"

javascript

const res = await fetch(
  "https://api.morphemeris.com/v1/lots?" + new URLSearchParams({
    datetime: "1990-06-15T18:30:00Z",
    lat: "38.4496", lon: "-78.8689",
  }),
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const { data } = await res.json();

Python

import requests

res = requests.get(
    "https://api.morphemeris.com/v1/lots",
    params={
        "datetime": "1990-06-15T18:30:00Z",
        "lat": 38.4496, "lon": -78.8689,
    },
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

Just the Part of Fortune

Bash

curl "https://api.morphemeris.com/v1/lots?\
datetime=1990-06-15T18:30:00Z\
&lat=38.4496&lon=-78.8689&lots=fortune" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

javascript

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 morphemeris_live_YOUR_KEY" } }
);
const { data } = await res.json();

Python

import requests

res = requests.get(
    "https://api.morphemeris.com/v1/lots",
    params={
        "datetime": "1990-06-15T18:30:00Z",
        "lat": 38.4496, "lon": -78.8689,
        "lots": "fortune",
    },
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

Tips

Day vs. night chart is determined by whether the Sun is above or below the horizon at the given time and location. The Ascendant is needed for this calculation, which is why lat and lon are required.
The Part of Fortune is the most commonly used lot. In a day chart, it represents where the lunar principle manifests most strongly; in a night chart, the formula reverses to maintain the same symbolic relationship.
Use the lots parameter to request only the lots you need, reducing response size.
For the full natal chart with lots included, you can use /v1/natal-chart for positions and aspects, then call /v1/lots separately for lot placements.

Arabic Parts/Lots

On this page