Relocation API: astrocartography, parans, local space

Relocation astrology answers “where”, not “when”. AstroWay serves both the geometry (lines, crossings, azimuths, angles) and the meaning (which line governs what, and what it says) as separate calls, so you decide which layer you need.

Two layers

Geometry. One birth moment projected onto the whole planet: /v1/acg returns 67 lines (4 angles × 13 bodies, up to 361 points per line), /v1/parans returns over 400 points where two planets were angular at once, /v1/local-space returns each planet’s azimuth and altitude from the birthplace as great-circle paths.

Meaning. /v1/acg/by-category takes an area of life and returns the lines that govern it, ranked by weight and, when you pass a point, by proximity to it, with interpretation text attached. The text is curated, from a knowledge base rather than a language model: the same request returns the same words tomorrow.

Endpoints

Endpoint	Method	Credits	Purpose
/v1/acg/categories	GET	0	Taxonomy of 19 life areas: which lines govern what, weight 1-3, polarity
/v1/acg	POST	Tier 3	ACG lines for every body (alias /v1/astrocartography)
/v1/acg/by-category	POST	Tier 3	Lines for one life area, ranked, with interpretation
/v1/acg/line-report	POST	Tier 2	One line in full: geometry, every area, text
/v1/acg-zones	POST	Tier 3	Which lines run near a given point, and how far away
/v1/parans	POST	Tier 3	Crossings of two planets’ lines, with coordinates
/v1/local-space	POST	Tier 3	Azimuth, altitude and great-circle path per planet
/v1/local-space/influence-zone	POST	Tier 3	Cone polygon around one azimuth
/v1/relocation	POST	Tier 3	Relocated chart: same planets, recomputed houses and angles
/v1/geodetic	POST	Tier 1	Geodetic angles from coordinates alone, no birth time
/v1/solar-acg	POST	Tier 4	Astrocartography of a given year’s solar return

19 life areas

career · success · power · money · wealth · love · relationship · home · stability · retreat · health · vitality · communication · creativity · learning · spirituality · transformation · travel · adventure.

Each area names its planet-and-angle lines with a weight from 1 to 3 and a polarity. Challenging lines are returned alongside supportive ones: a tool that shows only the favourable ones misrepresents the technique. Want just one kind? Filter with polarity.

Example: rank cities for career

curl -X POST https://api.astroway.info/v1/acg/by-category \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3,
        "latitude": 50.45, "longitude": 30.52,
        "category": "career", "point": { "lat": 51.5074, "lng": -0.1278 },
        "radiusDeg": 8, "includeCoordinates": false, "language": "en" }'
# → lines[] with weight, polarity, distanceDeg, strength and interpretation

Run the same call once per candidate city and sort on strength: the line’s weight multiplied by proximity. includeCoordinates: false drops the geometry when all you need is the ranking.

Languages

language accepts any active code. The curated knowledge base covers all 40 planet-and-angle combinations in eleven languages (uk, en, de, es, fr, hi, it, ko, pl, pt and more); where a translation is missing the response falls back to en, then uk, and the language actually served is reported in each interpretation’s lang field.

Note

The taxonomy covers the ten traditional bodies. Chiron, Lilith and the nodes appear in /v1/acg geometry but are deliberately outside the life-area mapping: the technique as Jim Lewis defined it does not assign them angular rulership.

Technique pages with examples: Astrocartography · Interpretations · Parans · Local Space · Relocated Chart · Geodetic Chart · Solar Return Astrocartography