/v1/chart/planets

All 9 planets with longitude/sign/nakshatra/pada/house.

What this tells you

This is the foundation endpoint — every birth chart app starts here. It returns all 9 grahas with their sidereal positions, sign/nakshatra/pada placements, house from the ascendant, and speed. The ascendant is included in the same response so you have everything needed to draw a D1 (Rasi) chart.

Request

All requests require an Authorization header with your dv_live_* API key.

example request

curl "https://api.divyastroapi.com/v1/chart/planets?date=2026-04-19&time=06%3A30&tz=%2B05%3A30&lat=28.61&lon=77.21" \
  -H "Authorization: Bearer dv_live_0123456789abcdef0123456789abcdef"

Response (200 OK)

Successful requests return a JSON body. Field names are stable across versions.

200 response

{
  "ayanamsa": { "system": "lahiri", "value_deg": 24.1408 },
  "birth": {
    "date": "1990-01-15", "time": "14:30", "tz": "+05:30",
    "lat": 28.61, "lon": 77.21,
    "jd": 2447907.1736
  },
  "ascendant": {
    "longitude": 92.487, "sign": "Cancer", "sign_index": 4,
    "nakshatra": "Pushya", "pada": 1, "lord": "Moon"
  },
  "planets": [
    {
      "name": "Sun",      "abbr": "Su",
      "longitude": 272.018, "sign": "Capricorn", "sign_index": 10, "degree_in_sign": 2.018,
      "nakshatra": "Uttara Ashada", "nakshatra_index": 21, "pada": 2, "nakshatra_lord": "Sun",
      "house": 7, "retrograde": false, "combust": false, "speed_deg_per_day": 1.0167
    },
    { "name": "Moon",    "abbr": "Mo", "longitude":  53.772, "sign": "Taurus",    "sign_index":  2, "degree_in_sign": 23.772, "nakshatra": "Mrigashira",     "nakshatra_index":  5, "pada": 1, "nakshatra_lord": "Mars",    "house": 11, "retrograde": false, "combust": false, "speed_deg_per_day": 13.428 },
    { "name": "Mars",    "abbr": "Ma", "longitude": 213.214, "sign": "Scorpio",   "sign_index":  8, "degree_in_sign":  3.214, "nakshatra": "Anuradha",       "nakshatra_index": 17, "pada": 1, "nakshatra_lord": "Saturn",  "house":  5, "retrograde": false, "combust": false, "speed_deg_per_day": 0.547 },
    { "name": "Mercury", "abbr": "Me", "longitude": 264.183, "sign": "Sagittarius","sign_index":  9, "degree_in_sign": 24.183, "nakshatra": "Purva Ashada",   "nakshatra_index": 20, "pada": 4, "nakshatra_lord": "Venus",   "house":  6, "retrograde": true,  "combust": false, "speed_deg_per_day": -0.211 },
    { "name": "Jupiter", "abbr": "Ju", "longitude": 112.908, "sign": "Cancer",    "sign_index":  4, "degree_in_sign": 22.908, "nakshatra": "Ashlesha",       "nakshatra_index":  9, "pada": 1, "nakshatra_lord": "Mercury", "house":  1, "retrograde": true,  "combust": false, "speed_deg_per_day": -0.069 },
    { "name": "Venus",   "abbr": "Ve", "longitude": 243.619, "sign": "Sagittarius","sign_index":  9, "degree_in_sign":  3.619, "nakshatra": "Mula",           "nakshatra_index": 19, "pada": 1, "nakshatra_lord": "Ketu",    "house":  6, "retrograde": false, "combust": false, "speed_deg_per_day": 1.225 },
    { "name": "Saturn",  "abbr": "Sa", "longitude": 268.507, "sign": "Capricorn", "sign_index": 10, "degree_in_sign": 28.507, "nakshatra": "Dhanishtha",     "nakshatra_index": 23, "pada": 1, "nakshatra_lord": "Mars",    "house":  7, "retrograde": false, "combust": false, "speed_deg_per_day": 0.113 },
    { "name": "Rahu",    "abbr": "Ra", "longitude": 273.400, "sign": "Capricorn", "sign_index": 10, "degree_in_sign":  3.400, "nakshatra": "Uttara Ashada",  "nakshatra_index": 21, "pada": 2, "nakshatra_lord": "Sun",     "house":  7, "retrograde": true,  "combust": false, "speed_deg_per_day": -0.053 },
    { "name": "Ketu",    "abbr": "Ke", "longitude":  93.400, "sign": "Cancer",    "sign_index":  4, "degree_in_sign":  3.400, "nakshatra": "Pushya",         "nakshatra_index":  8, "pada": 1, "nakshatra_lord": "Saturn",  "house":  1, "retrograde": true,  "combust": false, "speed_deg_per_day": -0.053 }
  ]
}

Field reference

Every field in the response, with its type, a real example, and what it means.

Field	Type	Meaning
ayanamsa.system	string	Sidereal correction system used. Default is Lahiri (Chitrapaksha) — India's official sidereal zodiac. example: `"lahiri"`
ayanamsa.value_deg	number	Ayanamsa value in degrees at the birth moment. Subtracted from tropical longitudes to get sidereal. example: `24.1408`
birth.jd	number	Julian Day of the birth moment in UT. example: `2447907.1736`
ascendant.longitude	number	Sidereal longitude of the ascendant (0–360°). example: `92.487`
ascendant.sign	string	Ascendant rashi. 12 signs: Aries, Taurus, …, Pisces. example: `"Cancer"`
ascendant.nakshatra	string	Nakshatra occupied by the ascendant — important for nakshatra-based predictions. example: `"Pushya"`
planets[]	array of 9 objects	The 9 classical grahas. Always in this order. example: `[Sun, Moon, Mars, …, Ketu]`
planets[].name	string	Planet name. Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu (North Node), Ketu (South Node). example: `"Sun"`
planets[].abbr	string	2-letter abbreviation — safe for chart diagrams. example: `"Su"`
planets[].longitude	number	Sidereal longitude (0–360°). Use this for custom chart math. example: `272.018`
planets[].sign	string	Sign the planet occupies. example: `"Capricorn"`
planets[].sign_index	integer (1–12)	1=Aries, ..., 12=Pisces. example: `10`
planets[].degree_in_sign	number (0–30)	Degrees within the sign. Useful for rendering precise position. example: `2.018`
planets[].nakshatra	string	Nakshatra the planet is in. example: `"Uttara Ashada"`
planets[].pada	integer (1–4)	Pada within the nakshatra. example: `2`
planets[].nakshatra_lord	string	Lord of the nakshatra. For Moon, drives Vimshottari dasha start. example: `"Sun"`
planets[].house	integer (1–12)	Whole-sign house from the ascendant. example: `7`
planets[].retrograde	boolean	Whether the planet is in retrograde motion (speed < 0). example: `false`
planets[].combust	boolean	Whether the planet is combust (too close to the Sun — see /v1/chart/combustion). example: `false`
planets[].speed_deg_per_day	number	Daily motion in degrees. Negative = retrograde. example: `1.0167`

Usage tips

How to use it

Cache forever per user
Birth data doesn't change. Hash birth date/time/tz/lat/lon and cache the response indefinitely.
Rendering a chart
For a South Indian square chart, bucket planets by `house` (1–12). For a North Indian diamond, bucket by `sign_index` with the ascendant's sign at the top.
Retrograde symbol
Show a small "℞" next to planets where `retrograde === true`. Rahu and Ketu are always retrograde by definition.
Combust planets are weak
A combust planet has diminished effects — use `combust` to render faded in the chart or add a warning note.

Errors

Every error follows the same envelope. Use the error.code field (not the message) for conditional logic in your integration.

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "missing or invalid API key",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

402 Payment Required

{
  "error": {
    "code": "trial_exhausted",
    "message": "your free trial credits are exhausted — pick a plan to continue",
    "top_up_url": "https://divyastroapi.com/pricing",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

429 Too Many Requests

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded; retry after 12 seconds",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

Try it

Get a dv_live_* key from your dashboard and paste into the cURL snippet above. New accounts get 500 free credits. Sign up.