Vipin Kaushik × Astroclarity

Astroacharya

Vedic Jyotish compute engine. Swiss Ephemeris + BPHS canon. Sidereal Lahiri. All endpoints require an API key.

Service online · port 3150 · Lahiri ayanamsa Swagger UI →

Authentication required

Every endpoint below requires the X-API-Key header. Requests without a valid key return 401 UNAUTHORIZED.

# All compute requests curl https://astroacharya.tathya.dev/v1/panchanga?lat=28.6&lon=77.2&tz=5.5 -H "X-API-Key: <your-key>"

Set ASTROACHARYA_KEY in the service environment to enable the gate. When the variable is unset the service runs in open dev mode.

v1 endpoints
GET
/v1/panchanga
Pancha Anga for any date + location. Tithi, Nakshatra, Yoga, Karana, Vara, Lagna. Also /v1/panchanga/daily for full-day timeline.
panchanga
GET
/v1/transits
Current sidereal planet positions — sign, degree, house, nakshatra, retrograde status.
transits
GET
/v1/sky/today · /v1/sky/nakshatras · /v1/sky/stars · /v1/sky/lst
Sky data bundle for Astroclarity 3D canvas. Today's panchanga, planet positions, star catalog, local sidereal time.
sky
GET
/v1/ephemeris/trails · /v1/ephemeris/trails/{graha}
90-day orbital trails with adaptive sampling. Served from MongoDB cache, updated hourly.
ephemeris
GET
/v1/entities/{type} · /v1/entities/{type}/{slug}
Jyotish entity catalog — grahas, rashis, nakshatras, tithis, yogas, karanas, varas, concepts, bhavas, jataka_yogas. Render shapes for Astroclarity canvas.
entities
GET
/v1/grahas · /v1/grahas/{slug} · /v1/grahas/orbits
Navgraha index with BPHS attributes, render colors, orbit metadata for 3D visualization.
grahas
GET
/v1/nakshatras · /v1/nakshatras/{slug}
27 Nakshatras — star data, ayurveda, mantra, vastu, BPHS attributes and pada-level detail.
nakshatras
GET
/v1/bhavas · /v1/bhavas/{slug}
12 Bhavas — BPHS significations, karakas, quality groups, body/disease correspondences.
bhavas
GET
/v1/jataka_yogas · /v1/jataka_yogas/{slug}
Natal yoga catalog — Nabhasa, Graha, Chandra, Ravi, Raja, Dhana, Mahapurusha per BPHS Ch. 35–42, 75.
jataka_yogas
GET
/v1/texts · /v1/texts/{id}/chapters/{ch}/shlokas/{n}
Sanskrit source texts — BPHS, Phaladeepika, Jatakaparijata, and 12 others. Shloka-level access for @source citation resolution.
texts
GET
/v1/calendar/festivals · /v1/calendar/lunar · /v1/calendar/year
Hindu calendar — yearly festival dates, daily tithi + nakshatra progression, full year view.
calendar
GET
/v1/muhurta/daily
Auspicious and inauspicious timing windows — Abhijit, Rahu Kaal, Gulika, Yamaghantaka, Kala, Mrityu. Mundane only.
muhurta
GET
/v1/internal/festivals
Festival CRUD — list, create, update, delete. Internal only. Requires X-Internal-Token header in addition to the API key.
admin

Surface notes (2026-06-09 sweep)

▸ Every route now ships only under the /v1/ prefix. The legacy unprefixed double-mounts are gone.
▸ POST /v1/horoscope and GET /v1/chart/{division} are removed — the persistent kundli surface (POST /v1/clients/{id}/kundli → GET /v1/kundli/{id}/horoscope) is now the only path.
▸ The generic /v1/entities/{type} router now serves only rashis, concepts, upagrahas, and functional_planets. Grahas / nakshatras / bhavas / tithis / yogas / karanas / varas / jataka-yogas have their own typed routes.