ACG

ACG Declination Parallel Lines (Go Engine)

Compute declination parallel and contra-parallel latitude bands.

A NOVEL feature — no other ACG tool maps declination parallels geographically. Returns horizontal GeoJSON lines where two bodies share (parallel) or oppose (contra-parallel) declination.

Current endpoint contract uses a fixed 1.5° orb (DefaultDeclinationOrb). No max_orb query parameter is accepted on this route.

post/acg/declination-lines

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/acg/declination-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

Successful Response

object required

Changes

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