POST /v1/chart · 1 credit
Natal chart (kundli)
Sidereal chart: ascendant, the nine grahas, twelve houses, yogas and the life-period (daśā) timeline. A modern Western block is added unless `western` is false. With `location`, also astrocartography lines at that place and the chart's own frame relocated there. Includes two classical sub-charts by default; ask for any of the others with `divisionals`.
Request (works as-is with a sandbox key):
curl -X POST https://www.astronest.ai/api/developer/v1/chart \
-H "Authorization: Bearer astro_sandbox_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"birthData":{"date":"1990-05-12","time":"14:35","timezone":"Asia/Kolkata","latitude":28.6139,"longitude":77.209}}'Response (sandbox sample, long lists shortened):
{
"requestId": "7d2e2084-f70d-4981-ab40-2e726d8fbbfc",
"engineVersion": "astro-nest-v1-public",
"timestamp": "2026-10-06T17:02:35.084Z",
"usage": {
"units_charged": 1,
"remaining_credits": 95
},
"disclaimer": "Symbolic interpretation only. Not medical, legal, financial, or psychological advice.",
"domain": "core_chart",
"computationId": "b029fba85c47c76de90d4e1dce1436149cb7471d09c93ceff7eeb6d26e494825",
"ascendant": {
"sign": "Virgo",
"degree": 0.4042,
"nakshatra": "Uttara Phalguni",
"pada": 2
},
"planets": [
{
"planet": "Sun",
"sign": "Aries",
"house": 8,
"degree": 27.6589,
"longitude": 27.6589,
"retrograde": false,
"nakshatra": "Krittika",
"pada": 1,
"dignity": "exalted",
"combust": null,
"combustion": null
},
{
"planet": "Moon",
"sign": "Scorpio",
"house": 3,
"degree": 25.6775,
"longitude": 235.6775,
"retrograde": false,
"nakshatra": "Jyeshtha",
"pada": 3,
"dignity": "debilitated",
"combust": false,
"combustion": null
},
{
"planet": "Mars",
"sign": "Aquarius",
"house": 6,
"degree": 22.2881,
"longitude": 322.2881,
"retrograde": false,
"nakshatra": "Purva Bhadrapada",
"pada": 1,
"dignity": "neutral",
"combust": false,
"combustion": null
},
"… 9 more"
],
"houses": [
{
"house": 1,
"sign": "Virgo",
"degree": 0,
"lord": "Mercury"
},
{
"house": 2,
"sign": "Libra",
"degree": 0,
"lord": "Venus"
},
{
"house": 3,
"sign": "Scorpio",
"degree": 0,
"lord": "Mars"
},
"… 9 more"
],
"aspects": [
{
"planet1": "Sun",
"planet2": "Mars",
"type": "sextile",
"orb": 5.37,
"applying": false
},
{
"planet1": "Sun",
"planet2": "Saturn",
"type": "trine",
"orb": 3.91,
"applying": true
},
{
"planet1": "Sun",
"planet2": "Neptune",
"type": "trine",
"orb": 6.99,
"applying": false
},
"… 26 more"
],
"yogas": [
{
"name": "ViparitaRajYoga",
"englishName": "Reversal Combination — unexpected rise",
"type": "viparita_raj_yoga",
"planets": [
"Mars",
"Sun"
],
"houses": [
6,
8
],
"strength": null,
"basis": "Sarala — Mars (8th lord) in the 6th; Vimala — Sun (12th lord) in the 8th",
"classicalSource": "BPHS Chapter 35"
},
{
"name": "MalavyaYoga",
"englishName": "Malavya Combination — beauty and refinement",
"type": "pancha_mahapurusha",
"planets": [
"Venus"
],
"houses": [
7
],
"strength": null,
"basis": "Venus in Pisces (7th house) — exalted/own sign in kendra",
"classicalSource": "BPHS Chapter 34"
},
{
"name": "BudhaAdityaYoga",
"englishName": "Sun-Mercury Combination — intelligence and communication",
"type": "special_yoga",
"planets": [
"Sun",
"Mercury"
],
"houses": [
8,
8
],
"strength": null,
"basis": "Mercury 12.6° from Sun in Aries — clear BudhaAditya",
"classicalSource": "BPHS Chapter 37"
},
"… 4 more"
],
"dasha": {
"current": {
"mahadasha": "Sun",
"mahadashaEnd": "2028-11-14T06:46:15.504Z",
"antardasha": "Mercury",
"antardashaEnd": "2027-07-10T04:54:50.304Z",
"pratyantardasha": "Mercury",
"pratyantardashaEnd": "2026-10-16T17:31:04.074Z"
},
"timeline": [
{
"planet": "Mercury",
"start": "1990-05-12T09:04:59.999Z",
"end": "1995-11-15T06:42:39.504Z",
"level": "mahadasha",
"antardashas": [
"{…}",
"{…}",
"{…}"
]
},
{
"planet": "Ketu",
"start": "1995-11-15T06:42:39.504Z",
"end": "2002-11-14T23:27:03.504Z",
"level": "mahadasha",
"antardashas": [
"{…}",
"{…}",
"{…}",
"… 6 more"
]
},
{
"planet": "Venus",
"start": "2002-11-14T23:27:03.504Z",
"end": "2022-11-14T19:51:03.504Z",
"level": "mahadasha",
"antardashas": [
"{…}",
"{…}",
"{…}",
"… 6 more"
]
},
"… 7 more"
]
},
"divisionals": [
{
"division": "D9",
"ascendant": {
"sign": "Capricorn",
"degree": 0.4042
},
"planets": [
{
"planet": "Sun",
"sign": "Sagittarius",
"house": 12,
"degree": 0.9922,
"longitude": 240.9922,
"retrograde": false,
"nakshatra": null,
"pada": null,
"dignity": null
},
{
"planet": "Moon",
"sign": "Aquarius",
"house": 2,
"degree": 2.3442,
"longitude": 302.3442,
"retrograde": false,
"nakshatra": null,
"pada": null,
"dignity": null
},
{
"planet": "Mars",
"sign": "Aries",
"house": 4,
"degree": 2.2881,
"longitude": 2.2881,
"retrograde": false,
"nakshatra": null,
"pada": null,
"dignity": null
},
"… 9 more"
]
},
{
"division": "D10",
"ascendant": {
"sign": "Taurus",
"degree": 0.4042
},
"planets": [
{
"planet": "Sun",
"sign": "Capricorn",
"house": 9,
"degree": 0.6589,
"longitude": 270.6589,
"retrograde": false,
"nakshatra": null,
"pada": null,
"dignity": null
},
{
"planet": "Moon",
"sign": "Pisces",
"house": 11,
"degree": 1.6775,
"longitude": 331.6775,
"retrograde": false,
"nakshatra": null,
"pada": null,
"dignity": null
},
{
"planet": "Mars",
"sign": "Virgo",
"house": 5,
"degree": 1.2881,
"longitude": 151.2881,
"retrograde": false,
"nakshatra": null,
"pada": null,
"dignity": null
},
"… 9 more"
]
}
],
"western": {
"tradition": "western",
"classical": false,
"notice": "Modern Western techniques, published alongside the Jyotisa engine and NOT part of it. These are not classical sastra, carry no corpus provenance, and are never used to reach a verdict on any AstroNest surface. Western natural-benefic/malefi…",
"aspectMesh": {
"source": "aspects",
"note": "The `aspects` array on this response is the five Ptolemaic majors (conjunction, opposition, trine, square, sextile) measured by DEGREE with orbs. That is a Western construction and is named here because it ships inside the Jyotisa payload. …"
},
"tropical": {
"ayanamsa": "lahiri",
"ayanamsaDegrees": 23.7224,
"note": "Tropical longitude = sidereal longitude + ayanamsa, at this chart’s epoch. The Jyotisa payload is SIDEREAL throughout; nothing here changes it.",
"positions": [
{
"planet": "Sun",
"longitude": 51.3813,
"sign": "Taurus",
"degree": 21.3813,
"retrograde": false
},
{
"planet": "Moon",
"longitude": 259.4,
"sign": "Sagittarius",
"degree": 19.4,
"retrograde": false
},
{
"planet": "Mars",
"longitude": 346.0105,
"sign": "Pisces",
"degree": 16.0105,
"retrograde": false
},
"… 9 more"
]
},
"outerPlanets": [
{
"planet": "Uranus",
"sign": "Sagittarius",
"house": 4,
"degree": 15.5317,
"signification": "sudden change, disruption, awakening, independence",
"note": "Generational by sign and read by house and aspect. Carries NO classical dignity — the absent dignity field is by design, not a gap."
},
{
"planet": "Neptune",
"sign": "Sagittarius",
"house": 4,
"degree": 20.671,
"signification": "dissolution, imagination, spirituality, illusion",
"note": "Generational by sign and read by house and aspect. Carries NO classical dignity — the absent dignity field is by design, not a gap."
},
{
"planet": "Pluto",
"sign": "Libra",
"house": 2,
"degree": 22.5287,
"signification": "transformation, power, regeneration through upheaval",
"note": "Generational by sign and read by house and aspect. Carries NO classical dignity — the absent dignity field is by design, not a gap."
}
],
"astrocartography": {
"notice": "Astrocartography lines are absolute earth positions, not bearings from where the native lives: “east of here” is a compass illusion. MC and IC lines are meridians and do not depend on observer latitude. ASC and DSC lines are curves whose lo…",
"computed": true,
"meridians": [
{
"planet": "Sun",
"angle": "MC",
"geoLongitude": 42.8282,
"meaning": "career and public standing"
},
{
"planet": "Sun",
"angle": "IC",
"geoLongitude": -137.1718,
"meaning": "home, roots and private life"
},
{
"planet": "Moon",
"angle": "MC",
"geoLongitude": -107.6554,
"meaning": "career and public standing"
},
"… 21 more"
],
"atLocation": null
}
}
}Every field: /v1/chart in the reference.
POST /v1/dasha · 1 credit
Life-period timeline (planetary periods)
The current periods include the running pratyantardaśā; send depth 'pratyantardasha' for the full timeline at that level.
Request (works as-is with a sandbox key):
curl -X POST https://www.astronest.ai/api/developer/v1/dasha \
-H "Authorization: Bearer astro_sandbox_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"birthData":{"date":"1990-05-12","time":"14:35","timezone":"Asia/Kolkata","latitude":28.6139,"longitude":77.209}}'Response (sandbox sample, long lists shortened):
{
"requestId": "ab5a2f7c-4066-4d2f-81e2-94cef982bc10",
"engineVersion": "astro-nest-v1-public",
"timestamp": "2026-10-06T17:02:35.576Z",
"usage": {
"units_charged": 1,
"remaining_credits": 94
},
"disclaimer": "Symbolic interpretation only. Not medical, legal, financial, or psychological advice.",
"domain": "dasha",
"computationId": "b029fba85c47c76de90d4e1dce1436149cb7471d09c93ceff7eeb6d26e494825",
"current": {
"mahadasha": "Sun",
"mahadashaEnd": "2028-11-14T06:46:15.504Z",
"antardasha": "Mercury",
"antardashaEnd": "2027-07-10T04:54:50.304Z",
"pratyantardasha": "Mercury",
"pratyantardashaEnd": "2026-10-16T17:31:04.074Z"
},
"timeline": [
{
"planet": "Mercury",
"start": "1990-05-12T09:04:59.999Z",
"end": "1995-11-15T06:42:39.504Z",
"level": "mahadasha",
"antardashas": [
{
"planet": "Rahu",
"start": "1990-05-12T09:04:59.999Z",
"end": "1990-11-30T06:51:12.504Z",
"level": "antardasha"
},
{
"planet": "Jupiter",
"start": "1990-11-30T06:51:12.504Z",
"end": "1993-03-07T04:02:43.704Z",
"level": "antardasha"
},
{
"planet": "Saturn",
"start": "1993-03-07T04:02:43.704Z",
"end": "1995-11-15T06:42:39.504Z",
"level": "antardasha"
}
]
},
{
"planet": "Ketu",
"start": "1995-11-15T06:42:39.504Z",
"end": "2002-11-14T23:27:03.504Z",
"level": "mahadasha",
"antardashas": [
{
"planet": "Ketu",
"start": "1995-11-15T06:42:39.504Z",
"end": "1996-04-12T10:05:14.904Z",
"level": "antardasha"
},
{
"planet": "Venus",
"start": "1996-04-12T10:05:14.904Z",
"end": "1997-06-12T12:52:38.904Z",
"level": "antardasha"
},
{
"planet": "Sun",
"start": "1997-06-12T12:52:38.904Z",
"end": "1997-10-18T08:54:52.104Z",
"level": "antardasha"
},
"… 6 more"
]
},
{
"planet": "Venus",
"start": "2002-11-14T23:27:03.504Z",
"end": "2022-11-14T19:51:03.504Z",
"level": "mahadasha",
"antardashas": [
{
"planet": "Venus",
"start": "2002-11-14T23:27:03.504Z",
"end": "2006-03-16T10:51:03.504Z",
"level": "antardasha"
},
{
"planet": "Sun",
"start": "2006-03-16T10:51:03.504Z",
"end": "2007-03-16T16:40:15.504Z",
"level": "antardasha"
},
{
"planet": "Moon",
"start": "2007-03-16T16:40:15.504Z",
"end": "2008-11-14T10:22:15.504Z",
"level": "antardasha"
},
"… 6 more"
]
},
"… 7 more"
]
}Every field: /v1/dasha in the reference.
Why AstroNest
Deterministic interpretation
Interpret, guidance, compatibility and guna milan call no language model: the same chart always gets the same reading. Only forecast and timing are voiced by a model, and they are marked as such.
Readings grounded in classical Vedic methodology
Interpretation applies classical rules, and each reading names the classical texts it is grounded in.
Nothing silently missing
Every reading declares each of its layers as present, computed_empty, not_covered or failed, so an absent field is never left to guesswork.
Pricing
Sandbox keys are free, with no time limit, and return the samples above. A live key starts with 100 free credits; after that you buy credit packs. Each endpoint's cost in credits is shown above. Pricing
Questions
- Which ayanamsa does the kundli use?
- Lahiri, the same on every call. The ephemeris endpoints let you choose the ayanāṁśa per request.
- What if the birth time is unknown?
- Omit the time. House-dependent detail is then reduced rather than guessed.
- Can I try it without paying?
- Yes. A sandbox key is free with no time limit and returns fixed sample responses. A live key starts with 100 free credits.
Readings are symbolic interpretation, not medical, legal, financial or psychological advice.
More from the API