Skip to content

Western astrology — overview

The /v1/western/* endpoints expose deterministic tropical Western calculations on top of a stored natal chart. Build a chart through POST /v1/charts with "system": "western" first, then call any of the routes below.

All endpoints require Authorization: Bearer <token>. Chart-level routes require the charts:read scope. Relationship reports require compatibility:read.

Western endpoints reject non-Western charts with 422.

Endpoints at a glance

Endpoint What it returns
GET /v1/western/charts/{id}/aspects Major/minor natal aspects, orb, applying/separating, strength.
GET /v1/western/charts/{id}/dignities Essential dignity: rulership, exaltation, detriment, fall, triplicity, term, face.
GET /v1/western/charts/{id}/balance Elements, modalities, hemispheres, quadrants, house emphasis.
GET /v1/western/charts/{id}/patterns Stelliums, grand trines, T-squares, yods, kites, grand crosses, bowl/bucket.
GET /v1/western/charts/{id}/summary Aggregated Western feature summary for UI and LLM grounding.
GET /v1/western/charts/{id}/houses Natal house signs, rulers, occupants, angularity, and topics.
GET /v1/western/charts/{id}/dispositors Rulership chains, final dispositors, and mutual reception loops.
GET /v1/western/charts/{id}/antiscia Antiscion and contra-antiscion points for core natal planets.
GET /v1/western/charts/{id}/lots Seven Hermetic Lots / Arabic Parts with day-night formulas.
GET /v1/western/charts/{id}/fixed-stars Fixed-star conjunctions to core planets and angles.
GET /v1/western/charts/{id}/transits Transit-to-natal contacts at a moment.
GET /v1/western/charts/{id}/transit-windows Daily-resolution transit windows over a bounded range.
GET /v1/western/charts/{id}/secondary-progressions Secondary progressed chart and progressed-to-natal contacts.
GET /v1/western/charts/{id}/solar-arc Solar arc directed positions and natal contacts.
GET /v1/western/charts/{id}/progressed-lunation Secondary progressed Sun-Moon phase cycle.
GET /v1/western/charts/{id}/solar-return Solar return chart for a year, optionally relocated, with natal house overlays.
GET /v1/western/charts/{id}/lunar-return Next lunar return chart after a moment, optionally relocated.
GET /v1/western/charts/{id}/profections Annual profection house, sign, and time lord.
GET /v1/western/charts/{id}/annual-forecast Deterministic annual forecast feature summary.
GET /v1/western/charts/{id}/monthly-forecast Deterministic monthly forecast feature summary.
GET /v1/western/charts/{id}/zodiacal-releasing Level-one zodiacal releasing from Fortune or Spirit.
GET /v1/western/charts/{id}/zodiacal-releasing/advanced Nested L1-L4 zodiacal releasing with peak and loosening markers.
POST /v1/western/relationships Full Western relationship report.
GET /v1/western/charts/{id}/product-profile Deterministic product feature vector.
GET /v1/western/charts/{id}/product-profile/{domain} One product domain profile.
GET /v1/western/charts/{id}/ux/profile-summary-cards Frontend-ready profile summary cards.
GET /v1/western/charts/{id}/ux/daily-personal-weather Frontend-ready daily weather cards.
GET /v1/western/charts/{id}/ux/next-important-transit Strongest upcoming transit card.
GET /v1/western/charts/{id}/ux/timeline-cards Timeline cards from strongest transit windows.
POST /v1/western/ux/relationship-highlights Frontend-ready relationship highlights.
POST /v1/western/ux/best-compatibility-topics Ranked compatibility topic cards.

Technique notes

  • Zodiac: tropical.
  • Supported chart systems: Western endpoints require chart.system == "western".
  • Angles: Ascendant and Midheaven are included where relevant.
  • Nodes: natal chart responses include rahu and ketu, but Western core calculations focus on Sun-Pluto plus Ascendant/Midheaven unless an endpoint says otherwise.
  • Return charts: solar/lunar returns can be cast for a relocated place by passing latitude and longitude. If omitted, the natal coordinates are used.
  • House systems: house-dependent endpoints accept house_system=placidus|whole_sign|equal. Overrides apply only to that response and do not mutate the stored chart.
  • Product profiles: these are deterministic feature vectors, not LLM prose and not a separate classical doctrine.
  • Errors: Western routes use stable machine-readable error codes such as chart_not_found, unsupported_astrology_system, invalid_date_range, invalid_return_location, and unsupported_house_system.

Typical flow

CHART_ID=$(curl -s -X POST https://api.astrolinkers.com/v1/charts \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "birth": {
      "moment": "1984-12-21T18:20:00+07:00",
      "latitude": 55.0084,
      "longitude": 82.9357
    },
    "system": "western",
    "house_system": "placidus",
    "ayanamsha": null
  }' | jq -r .id)

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/western/charts/$CHART_ID/summary" | jq .

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/western/charts/$CHART_ID/transits?at=2026-01-01T00:00:00Z" | jq .