/v1/panchang/nakshatra-prediction

Daily prediction based on Tara Bala — computed from birth nakshatra vs today's Moon nakshatra, with health/work/relationships/finance/travel guidance.

What this tells you

Daily Nakshatra Prediction gives a personal daily reading from Tara Bala: the position of the day's Moon nakshatra counted from the birth nakshatra. The count falls into one of nine taras (Janma through Param-Mitra), and each tara carries a score, a label and guidance for health, work, relationships, finance and travel. The texts come from a fixed set of nine entries; what changes from day to day, and from person to person, is which tara applies.

Request

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

example request

curl "https://api.lifeastroapi.com/v1/panchang/nakshatra-prediction?date=2027-01-15&tz=Asia%2FKolkata&lat=28.6139&lon=77.209&birth_nak=3" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query parameters

Checked against the API: a parameter is marked required when the request fails without it.

Name	Required	Example	Description
`date`	yes	`2027-01-15`	Date (YYYY-MM-DD).
`tz`	yes	`Asia/Kolkata`	Timezone: IANA name (Asia/Kolkata) or UTC offset (+05:30).
`lat`	yes	`28.6139`	Latitude in decimal degrees.
`lon`	yes	`77.209`	Longitude in decimal degrees.
`birth_nak`	yes	`3`

Response (200 OK)

The real response to the example request above, generated from the API itself. Long arrays are trimmed to their first two items. Field names are stable across versions.

200 response

{
  "date": "2027-01-15",
  "tz": "Asia/Kolkata",
  "birth_nakshatra": {
    "index": 3,
    "name": "Rohini",
    "ruling_planet": "Moon",
    "deity": "Brahma"
  },
  "today_nakshatra": {
    "index": 26,
    "name": "Revati",
    "ruling_planet": "Mercury",
    "deity": "Pushan"
  },
  "tara": {
    "position": 6,
    "name": "Sadhana",
    "score": 10,
    "auspiciousness": "favorable"
  },
  "prediction": {
    "overall": "Sadhana tara — accomplishment and focused effort. Goals are within reach.",
    "health": "Positive energy for disciplined practices like yoga and meditation.",
    "work": "Excellent for focused work, learning, and achieving targets.",
    "relationships": "Mature and purposeful interactions. Good for mentoring and teaching.",
    "finance": "Good for long-term planning and disciplined savings.",
    "travel": "Travel for educational or spiritual purposes is well-starred.",
    "guidance": "Apply sustained effort. This tara rewards discipline and sincerity."
  },
  "today_panchang": {
    "tithi": "Saptami",
    "yoga": "Shiva",
    "vara": "Friday"
  }
}

Field reference

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

Field	Type	Meaning
date	string (YYYY-MM-DD)	The requested date. Today's nakshatra is taken at local sunrise of this date. example: `"2027-01-15"`
tz	string	Echo of the tz you sent. example: `"Asia/Kolkata"`
birth_nakshatra.index	integer (0–26)	Echo of the `birth_nak` parameter: 0 = Ashwini … 26 = Revati. example: `3`
birth_nakshatra.name / ruling_planet / deity	string	Name, lord and deity of the birth nakshatra. English only; the Purva/Uttara nakshatras use short forms such as "P.Phalguni". example: `"Rohini" / "Moon" / "Brahma"`
today_nakshatra.index	integer (0–26)	Moon's nakshatra at local sunrise of `date`. example: `26`
today_nakshatra.name / ruling_planet / deity	string	Name, lord and deity of today's nakshatra. English only, same short forms as above. example: `"Revati" / "Mercury" / "Pushan"`
tara.position	integer (1–9)	Count from the birth nakshatra to today's nakshatra (inclusive), reduced to 1–9. The 9-position cycle repeats 3 times across the 27 nakshatras. example: `6` Jyotish: 1 = Janma, 2 = Sampat, 3 = Vipat, 4 = Kshema, 5 = Pratyak, 6 = Sadhana, 7 = Vadha, 8 = Mitra, 9 = Param-Mitra. This is the classical Tara Bala system from Muhurta Chintamani.
tara.name	string	Tara name for the position: Janma, Sampat, Vipat, Kshema, Pratyak, Sadhana, Vadha, Mitra or Param-Mitra. example: `"Sadhana"`
tara.score	integer (0 \| 5 \| 10)	10 for Sampat, Kshema, Sadhana, Mitra and Param-Mitra; 5 for Janma; 0 for Vipat, Pratyak and Vadha. Same scale as `score` in /v1/muhurta/tara-bala. example: `10`
tara.auspiciousness	string	Label for the tara: very_favorable (Param-Mitra), favorable (Sampat, Kshema, Sadhana, Mitra), neutral (Janma), caution (Pratyak) or avoid (Vipat, Vadha). example: `"favorable"`
prediction.overall / health / work / relationships / finance / travel / guidance	string	Guidance text for each life area. English only. The text is fixed per tara, so everyone with the same tara today gets the same text. example: `"Sadhana tara — accomplishment and focused effort. Goals are within reach."`
today_panchang.tithi / yoga / vara	string	Tithi, yoga and weekday at local sunrise, for context. example: `"Saptami" / "Shiva" / "Friday"`

Usage tips

How to use it

Get birth_nak once, use daily
`birth_nak` (required, 0–26) is the Moon's nakshatra at birth. Call /v1/chart/planets once with the birth details and take `nakshatra_idx` of the Moon (0 = Ashwini … 26 = Revati). Store it, then call this endpoint every day with `birth_nak`, `date`, `tz`, `lat` and `lon` — you do not need the birth chart again.
Highlight Vadha days
When `tara.name` is "Vadha" (position 7), warn users prominently — it is the most inauspicious tara. When it is "Param-Mitra" (position 9), celebrate it.
Cache per (date, birth_nak, place)
Today's nakshatra is taken at sunrise, so the response is fixed for the whole date; the `time` parameter does not change it. Cache for 24 hours.

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://lifeastroapi.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 1,500 free credits. Sign up.