POST/v1/aspects

Aspects API

Sign-based drishti including special Mars/Jupiter/Saturn aspects.

Get free API key Try in playground Full schema in docs

About the engine

Part of the Vedic engine

The Vedic engine ships sidereal birth charts (Lahiri ayanamsa default), 16 varga divisions, three dasha systems, varshphal (annual horoscopes), and the daily panchang + muhurta windows. Plus the full strength stack (shad / bhav / chandra / tara bala, ashtakavarga, sarvashtakavarga), five doshas, and 25 classical yogas. Built on Swiss Ephemeris with first-class dosha-cancellation logic.

Request

Try it from the command line

curl -X POST 'https://api.astronode.dev/v1/aspects' \
  -H 'Authorization: Bearer aie_test_REPLACE_WITH_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "date": "1993-07-04",
  "time": "09:27:11",
  "tz_offset_minutes": 330,
  "lat": 31.7473,
  "lng": 77.7754
}'

Paste and run - this is the exact payload our live playground sends to this endpoint, so it is valid against the current schema. Every AstroNode endpoint needs a bearer token from your dashboard. Test keys (aie_test_*) work on the free tier - 1,000 requests / month, no card.

Request schema

Fields POST /v1/aspects accepts

Request body fields for POST /v1/aspects
Field	Type	Notes
`date`required	`string`	pattern ^\d{4}-\d{2}-\d{2}$ e.g. `1993-07-04`
`time`required	`string`	pattern ^\d{2}:\d{2}(:\d{2})?$ e.g. `09:27:11`
`tz_offset_minutes`required	`integer`	Offset from UTC in minutes (e.g., 330 for IST) -840..840 e.g. `330`
`lat`required	`number`	-90..90 e.g. `31.7473`
`lng`required	`number`	-180..180 e.g. `77.7754`

Generated from the same OpenAPI 3.1 document the API validates against, so this table cannot drift from the endpoint without the build failing.

Response

What you get back

Every AstroNode response uses the same envelope: request_id, data (the endpoint-specific payload), interpretation (optional narrative block), and meta (engine version + computed_at timestamp). This endpoint documents 200, 400, 401, 429.

Fields inside data

Response data fields for POST /v1/aspects
Field	Type	Notes
`by_planet`required	`object[]`	-
`by_planet[].planet`required	`string`	-
`by_planet[].aspects`required	`integer[]`	-
`by_house`required	`object[]`	-
`by_house[].house`required	`integer`	1..12
`by_house[].aspected_by`required	`string[]`	-

Engine highlights

What the Vedic engine ships

Sidereal Lahiri ayanamsa (configurable: Raman, Krishnamurti, Fagan-Bradley)
16 varga divisions including D1, D9 navamsa, D10 dasamsa
Three dasha systems: Vimshottari, Yogini, Char (Jaimini); dasha-at-date lookup
Varshphal: year-chart, muntha, mudda-dasha, Tajika yogas, sahams, harsha + panchavargeeya bala
Mangal / Kaal Sarp / Sade Sati / Pitra / Papa Samyam doshas with cancellation reasons
Strength stack: shad bala + bhav bala + chandra/tara bala + ashtakavarga/sarvashtakavarga
Daily panchang + 5 muhurta windows + Tamil Gowri Nalla Neram
Utility lookups: planet positions, house cusps, drishti aspects, upagrahas, sudarshana chakra, chandrashtama, transit-event scan

Related endpoints

Other Vedic endpoints

POST/v1/charts/birth

Sidereal birth chart - planets, houses, ascendant, nakshatras.

POST/v1/charts/varga

Divisional chart (D9 navamsa, D10 dasamsa, …) or all 16 in one call.

POST/v1/dasha/vimshottari

Mahadasha → antardasha → pratyantar tree.

POST/v1/dasha/yogini

Yogini dasha (8-yogini, 36-year cycle).

POST/v1/dasha/char

Char dasha (Jaimini sign-based).

POST/v1/dasha/lookup

Active dasha for a person at a given date.

POST/v1/varshphal/year-chart

Tajika solar-return chart for the Nth year of life.

POST/v1/varshphal/muntha

Muntha sign + house for the year.

POST/v1/varshphal/mudda-dasha

Vimshottari-style sub-periods within the annual chart.

POST/v1/varshphal/yoga

Tajika yogas active in the annual chart (Ithasala / Ikabala / …).

POST/v1/varshphal/saham

Tajika sahams (Arabic parts). Omit `saham` for all 16.

POST/v1/varshphal/month-chart

Per-month sub-chart within the annual cycle (12 windows per year).

POST/v1/varshphal/harsha-bala

Tajika Harsha bala - planetary joys for the year.

POST/v1/varshphal/panchavargeeya-bala

5-source planet-strength matrix for the year (Tajika).

POST/v1/dosha/mangal

Mangal dosha presence + cancellation reasoning.

POST/v1/dosha/kaal-sarp

Kaal Sarp dosha detection (Rahu–Ketu axis enclosure).

POST/v1/dosha/sade-sati

Saturn 7.5-year cycle over the natal Moon, current phase.

POST/v1/dosha/pitra

Ancestral-karma dosha - afflictions to Sun, Jupiter, 9th.

POST/v1/strength/bala

Shadbala - six-fold planetary strength matrix.

POST/v1/strength/bhav-bala

12-house bala - bhavadhipati + bhava-drik + bhava-yogi.

POST/v1/strength/chandra-bala

Moon-strength tally per sign - used for muhurta + dasha quality.

POST/v1/strength/tara-bala

9-tara nakshatra-based strength tally per nakshatra of the day.

POST/v1/ashtakavarga

Per-planet bindu table across all 12 signs.

POST/v1/sarvashtakavarga

Combined bindu across all 7 planets - single 12-cell table.

POST/v1/yogas

25 classical yogas detected with present/absent + reasons.

POST/v1/panchang

Tithi, nakshatra, yoga, karana, sunrise/sunset.

POST/v1/muhurta/choghadiya

8 day + 8 night Choghadiya windows with quality.

POST/v1/muhurta/hora

24 planetary-hour periods for a single day at a location.

POST/v1/muhurta/auspicious

Abhijit + amrit kaal + other auspicious windows.

POST/v1/muhurta/inauspicious

Rahu kaal, Yamaganda, Gulika to avoid.

POST/v1/gowri-nalla-neram

Tamil-tradition auspicious-time table for the day.

POST/v1/horoscope/nakshatra

Daily reading scoped to one of the 27 nakshatras (+ optional pada).

POST/v1/planets

Sidereal longitude, latitude, retrograde flag for each planet.

POST/v1/houses

12 house cusps - whole-sign by default.

POST/v1/birth-details

Sign + nakshatra + ascendant + panchang for a birth moment.

POST/v1/planet-nature

Functional benefic / malefic / yoga-karaka classification per Lagna.

POST/v1/relationships/planets

Panchadha Maitri - natural + temporary + combined friendship table.

POST/v1/sudarshana-chakra

Triple-axis view of the chart - lagna + Moon + Sun simultaneously.

POST/v1/chandrashtama-periods

Windows when transit Moon is 8th from natal Moon.

POST/v1/upagraha-positions

Sub-planets (Gulika, Mandi, Dhuma, …) - non-luminary calculated points.

POST/v1/transits/events

Sign-changes, retrograde / combust / exalt windows over a range.

GET/v1/ayanamsa

Available ayanamsa (sidereal-zero) systems with descriptions.

Ready to call POST /v1/aspects?

Free tier covers 1,000 requests / month. Razorpay-billed, GST-compliant invoices when you upgrade.

Get free API key Try in playground

Informational, not predictive. Not medical, legal, or financial advice.