ephemeris

Calculate Hermetic lots for datetime and location

Calculate Hermetic lots (Fortune Suite + optional/legacy) for a given datetime and location. Returns normalized lot positions with traditional source references, formulas, and keywords. Includes sect determination (diurnal/nocturnal) and house placements. Follows standalone pattern: direct Julian Day calculation without chart context. Supports format=json|llm via query params.

post/ephemeris/hermetic-lots

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/ephemeris/hermetic-lots
  • 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

Query parameters

output_modestring nullable

Deprecated: use preset+format. Accepts full|simple|llm.

formatstring

Headers

authorizationstring nullable
X-API-Keystring nullable
X-OpenEphemeris-API-Keystring nullable
apikeystring nullable

Request body

include_legacyboolean

Include legacy Hermetic lots previously in canonical catalog

include_optionalboolean

Include optional catalog lots beyond Fortune Suite defaults

latitudenumber double required

Observer latitude in decimal degrees

longitudenumber double required

Observer longitude in decimal degrees

Example request

{
  "date_time": {
    "iso": "1985-06-15T14:30:00Z"
  },
  "include_legacy": false,
  "include_optional": false,
  "latitude": 40.7128,
  "longitude": -74.006
}

Response

Successful Response

metadataobject required

Calculation metadata, sect determination, and settings

successboolean

Calculation success status

Changes

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