Skip to content

Astrolinkers API

The Astrolinkers API turns birth-time data into structured astrological insight — Western and Vedic natal charts, per-skill talent profiles, template-based interpretations, pairwise compatibility, async PDF reports, and complete Vedic + Western calculation engines. The Western layer now covers natal factors, predictive techniques, relationship analysis, and deterministic product profiles for LLM grounding.

Everything below is JSON in / JSON out, REST + bearer auth, multi-tenant.

Core resources

Resource Purpose
Geolocation Resolve free-text birth places into grounded coordinates, IANA time zones, and display labels.
Charts Compute and store a natal chart. Western (tropical) or Vedic (sidereal Lahiri).
Talent profile Soft + hard skill scoring from the chart via a rule ontology.
Interpretations Template-driven statements plus LLM-ready Western and Vedic natal, relationship, forecast, and Muhurta prose with auditable grounding.
Reports Async PDF generation through a worker pipeline + signed download URL.
Compatibility Synastry (Western inter-aspects) + Ashtakoota (Vedic 8-kuta).
Feedback Per-statement accuracy ratings; feeds the rolling template-accuracy aggregate.
API keys Self-service issuance, listing, and revocation of opaque ak_live_… tokens.

Vedic calculation engine

A complete classical Vedic toolkit on top of the natal chart:

Resource Purpose
Divisional charts D1..D60 (Navamsa, Dashamsa, Shashtyamsa, etc.).
Bhava chakra & lagnas Raman / equal bhava cusps + Bhava / Hora / Ghatika lagnas.
Aspects (Drishti) Parashara aspect matrix + special drishti.
Dignity & functional nature 9-bucket strength + per-lagna benefic/malefic roles.
Vimshottari dasha Full MD/AD/PD chain + current-period lookup.
Period lords Ahargana / Abdadhipati / Masa / Vara / Hora.
Yogas Raja, Pancha Mahapurusha, Gajakesari, Kalsarpa, etc.
Ashtakavarga 7 Bhinnashtakavargas + Sarvashtakavarga (337 bindus).
Shadbala Naisargika + Dig + Uchcha + Drik balas (Virupa).
Panchanga 5 angas + muhurtas + kalams + chogadia.
Muhurta Activity taxonomy, candidate scoring, window search, and legacy chart-bound optimizer.
Jaimini karakas & arudha Canonical Jaimini karakas, arudha, aspects, Chara dasha, plus legacy helpers.
Relationships Kuta, dosha, highlights, and ranked topics for Vedic relationship analysis.
Risk, support & focus signals Structured caution/support signals and date-aware focus areas.
Vedic interpretations Natal, relationship, forecast, and Muhurta LLM prose grounded in deterministic Vedic features.
Vedic product UX Frontend-ready profile, daily weather, period, timeline, and relationship cards.
Rays & rectification 7-ray classification + Kunda-Siddhanta.
Progressions & influence Age-based progressions + Theo influence network.

See the Vedic overview for the full algorithm catalog.

Western calculation engine

Deterministic tropical Western calculations on top of the natal chart:

Resource Purpose
Western overview Full endpoint map and technique notes.
Core calculations Aspects, essential dignities, balance, patterns, lunar phase, retrogrades.
Predictive calculations Transits, secondary progressions, solar arc, returns, profections, zodiacal releasing.
Relationships Synastry matrix, overlays, composite, Davison, key contacts, score breakdown.
Product profiles Personality, career, relationship, stress, communication, leadership, money, decision-making.
Product UX Frontend-ready cards for profiles, daily weather, timelines, transits, and relationship highlights.

Getting started

  1. Authenticate — get a JWT, attach as Authorization: Bearer ….
  2. Pick a client — official SDKs for Python (pip install astrolinkers-sdk) and TypeScript (npm install @astrolinkers/sdk-ts); cURL / fetch / httpx / Go snippets for anything else.
  3. Make your first request — create a chart, fetch a talent profile.
  4. Handle errors and rate limits — uniform error envelope, 429 semantics.

Conventions

  • All timestamps are ISO 8601 with explicit timezone (+07:00, Z).
  • All IDs are UUIDv7 (sortable by creation time).
  • All numeric astrological values use decimal degrees, not deg/min/sec.
  • All collections are stable-ordered; pagination cursors are opaque strings.
  • All scope checks are deny-by-default; see Authentication.

Versioning

The API is versioned in the URL path (/v1/...). Breaking changes ship under a new version prefix and the previous version stays online for at least 6 months. Non-breaking additions (new fields, new endpoints) ship under the existing version with a note in the changelog.