ACG

Hermetic Lines

Calculates Astrocartography (ACG) geometry exclusively for the seven classical Hermetic Lots (Lot of Fortune, Spirit, Eros, Necessity, Courage, Victory, and Nemesis).

Astrological & Mathematical Geometry

Hermetic Lots are sensitive mathematical points derived from the natal Ascendant and two planetary positions (e.g., Day Fortune = Ascendant + Moon − Sun). Unlike planets, their ecliptic longitude shifts with the observer's natal birthplace, so natal.birthplace_lat and natal.birthplace_lon are required fields for this endpoint.

The engine converts each lot's ecliptic longitude to equatorial coordinates (Right Ascension and Declination) using the standard ecliptic-to-equatorial transformation, then runs those coordinates through the same angular line generators used for all ACG bodies.

Line Types Returned

All four standard angular line types are returned for each lot:

  • MC — Meridian where the lot culminates (2-point vertical meridian)
  • IC — Anti-culmination meridian, 180° opposite the MC (2-point vertical meridian)
  • AC — Horizon curve where the lot's equivalent point rises (181-point sinusoidal arc)
  • DC — Horizon curve where the lot's equivalent point sets (181-point sinusoidal arc)

Use the options.line_types field to restrict output to a subset (e.g., ["MC", "IC"]).

Sect Awareness

Sect (day/night chart) is determined from the Sun's actual altitude at the natal birthplace and time. The day and night formulas are applied accordingly — e.g., Fortune uses ASC + Moon − Sun for day charts and ASC + Sun − Moon for night charts.

post/acg/hermetic-lines

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/acg/hermetic-lines
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Request body

bodiesstring[]

Explicit body name selection. Supported: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, Chiron, Pholus, Ceres, Pallas, Juno, Vesta, MeanNode, SouthNode, TrueNode, TrueSouthNode, MeanLilith, OscuLilith, Vertex, and the seven Hermetic lots Fortune, Spirit, Eros, Necessity, Courage, Victory and Nemesis. The eight Uranian (Hamburg School) hypothetical points (Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulkanus, Poseidon) are accepted too, but only when named here: they are opt-in and never appear in a group's default roster. Fortune and Spirit are Hermetic lots and resolve only under a lot-bearing roster: group: "hermetic" or group: "all" (POST /acg/hermetic-lines pins that group itself, so it needs no group). Naming a lot under any other group is rejected with 422 rather than silently returning the default roster; on /acg/hits, where hermetic/all are Scale-tier, a lot named by a caller below that tier is rejected the same way. Aliases: NorthNode/Rahu/Node -> MeanNode; TrueNorthNode/TrueRahu -> TrueNode; Ketu -> SouthNode; Vulcanus -> Vulkanus. The extended catalog is accepted too, by name and only when named: the sb441 main-belt asteroids (Hygiea, Eunomia, Psyche, Europa (asteroid), Cybele, Sylvia, Thisbe, Camilla, Iris, Davida, Euphrosyne, Interamnia), the trans-Neptunian objects (Eris, Sedna, Makemake, Haumea, Quaoar, Orcus, Ixion, Varuna, Chaos, Gonggong, Salacia), the extra centaurs (Asbolus, Hylonome, Nessus, Chariklo) and about forty further asteroids (Eros (asteroid), Sappho, Lilith (asteroid), Fortuna, Pandora, Diana, Hekate and more) - GET /catalogs/bodies lists them all. The asteroid Eros is Eros (asteroid): plain Eros is the Hermetic lot. Each extended body named adds 1 credit to the request (capped at +20); the standard roster, the Uranian set and the lots are covered by the base price. Extended bodies are never in a group's default roster.

epochstring required

ISO-8601 datetime of the birth or event. Either put the zone on the value itself as a 'Z' or ±HH:MM suffix ("1987-07-15T09:01:00-05:00"), or send the naive local wall-clock time ("1987-07-15T09:01:00") and name its zone in the sibling timezone field. A zone-less clock time with no timezone is rejected with 400 ambiguous_datetime and is NEVER read as UTC. A date-only value resolves to 12:00 UTC.

formatstring

Response format. llm returns compact rows + schema in metadata; only honored by /acg/hits.

groupstring nullable

Body group selector. standard (default) = planets + asteroids; hermetic = Hermetic Lot lines (Fortune, Spirit, etc.); all = both; hd = the Human Design 13 (Sun, Earth, Moon, Mercury–Pluto, Mean Node, South Node) — pair with options.include_hd_gate for gate-labelled lines. The Hermetic lots are a Scale-tier feature: on the Developer-tier endpoints that accept this selector (/acg/hits, /acg/power-lines, /acg/ccg) a below-Scale caller has hermetic/all downgraded to the standard roster, and naming a lot in bodies is rejected with 422 rather than silently answered with the full roster. Hermetic lots require natal birthplace data.

jdnumber double

Julian Day (alternative to epoch)

query_latnumber nullable

Latitude of the query point

query_lonnumber nullable

Longitude of the query point

radius_degnumber nullable

Proximity radius in degrees

Example request

{
  "epoch": "1990-06-15T14:30:00Z",
  "natal": {
    "birthplace_lat": 34.05,
    "birthplace_lon": -118.24
  },
  "options": {
    "asteroid_groups": [
      "centaur",
      "muse"
    ]
  }
}

Response

FeatureCollection response (features is always an array; may be empty).

object required

Changes

No recorded changes to this operation across all 1 revision of this API.