GET /v1/lots — Compute Arabic Parts (Lots) with automatic day/night formula reversal.

Arabic Parts/Lots

Compute the 7 Hermetic lots (Parts of Fortune, Spirit, Love, Commerce, Passion, Increase, Fate) 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 lot names to compute
`sidereal`	string	No	—	Ayanamsha for sidereal mode

Available lots

fortune, spirit, love, commerce, passion, increase, fate

All 7 are the Hermetic lots with day/night reversal:

Lot	Day formula	Night formula
Fortune	Asc + Moon - Sun	Asc + Sun - Moon
Spirit	Asc + Sun - Moon	Asc + Moon - Sun
Love	Asc + Venus - Sun	Asc + Sun - Venus
Commerce	Asc + Mercury - Sun	Asc + Sun - Mercury
Passion	Asc + Mars - Sun	Asc + Sun - Mars
Increase	Asc + Jupiter - Sun	Asc + Sun - Jupiter
Fate	Asc + Saturn - Sun	Asc + Sun - Saturn

Response

JSON

{
  "data": {
    "is_day_chart": true,
    "lots": [
      {
        "name": "fortune",
        "longitude": 123.45,
        "sign": "leo",
        "sign_degree": 3.45,
        "house": 5,
        "formula": {
          "body_a": "moon",
          "body_b": "sun",
          "ascendant": 95.2,
          "reversed": false
        }
      }
    ]
  },
  "meta": {
    "credits_used": 1,
    "..."
  }
}

Each lot includes:

name — Lot name
longitude — Ecliptic longitude (0-360)
sign / sign_degree — Zodiac sign and degree within sign
house — House placement (1-12)
formula — The formula used, showing which bodies were body_a and body_b, the Ascendant longitude, and whether the formula was reversed for a night chart

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