ACG

ACG Line Proximity Hits (Go Engine)

Find ACG lines closest to a geographic location.

Supports two modes:

  1. Proximity mode (recommended): Provide query_lat and query_lon in the request body to find lines near any arbitrary point. Optionally set radius_deg (default: 3.0, max: 90). Returns features sorted by distance (closest first) with min_distance_deg and min_distance_km in each feature's properties.

  2. Birthplace fallback: If query_lat/query_lon are omitted but natal.birthplace_lat/natal.birthplace_lon are present, those coordinates are used as the query location.

  3. Unfiltered mode (backward-compatible): If neither query location nor natal birthplace is provided, all computed features are returned unfiltered.

New request fields (all optional):

  • query_lat (float): Latitude of the query point (-90 to 90)
  • query_lon (float): Longitude of the query point (-180 to 180)
  • radius_deg (float): Proximity radius in degrees (1° ≈ 111 km). Default: 3.0
post/acg/hits

Request

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