POST/v1/astro/nakshatra/prediction

Personal Nakshatra Prediction (Tarabala)

Returns a personalised daily prediction using Tarabala and Chandrabala for the day at the birth place (sunrise to next sunrise). The top-level tara is the one at sunrise; transit_nakshatras lists every nakshatra the Moon passes through that day with its tara. The tara names the round of nine: the first tara is Janma at count 1 (Moon in the birth nakshatra), Anujanma at 10 and Trijanma at 19. Tarabala measures the auspiciousness of the current day for an individual by assessing the relationship between their natal Moon nakshatra and the daily transit Moon nakshatra. Nine Taras from Janma (birth) to Ati-Mitra (great friend). Chandrabala measures the transit Moon's house from natal Moon. Also returns the transit nakshatra's quality type (Dhruva/Chara/ Ugra/Tikshna/Kshipra/Mridu/Mishra) with auspicious and inauspicious activities for today.

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

target_dateoptional

string (date) | null

Date for the prediction day; defaults to today

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.target_date

string

data.transit_moon

object

data.transit_moon.nakshatra

string

data.transit_moon.nakshatra_index

integer

data.transit_moon.rashi_index

integer

data.tarabala

object

data.tarabala.tara_number

integer

1-9: Janma, Sampat, Vipat, Kshema, Pratyak, Sadhana, Naidhana, Mitra, Ati-Mitra.

data.tarabala.count_from_birth

integer

1-27, counting the birth nakshatra as 1.

data.tarabala.cycle

integer | null

Round of nine the count falls in: 1, 2 or 3.

data.tarabala.cycle_name

string | null

Janma (counts 1-9), Anujanma (10-18) or Trijanma (19-27).

data.tarabala.name

string

Tara name; the first tara of rounds 2 and 3 is Anujanma and Trijanma.

data.tarabala.meaning

string

data.tarabala.is_favorable

boolean

data.tarabala.is_moon_in_birth_nakshatra

boolean | null

True only for count 1.

data.tarabala.interpretation

string

data.chandrabala

object

data.chandrabala.moon_house_from_natal

integer

data.chandrabala.is_favorable

boolean

data.chandrabala.favorable_houses

array[integer]

data.daily_score

object

data.daily_score.score

integer

data.daily_score.max_score

integer

data.daily_score.label

string

data.transit_nakshatra_quality

object

data.transit_nakshatra_quality.nakshatra

string

data.transit_nakshatra_quality.quality_type

string

data.transit_nakshatra_quality.english

string

data.transit_nakshatra_quality.auspicious_for

array[string]

data.transit_nakshatra_quality.inauspicious_for

array[string]

data.nakshatra_activities

object

data.nakshatra_activities.favorable

array[string]

data.nakshatra_activities.unfavorable

array[string]

data.birth_nakshatra

object

data.birth_nakshatra.name

string

data.birth_nakshatra.index

integer

data.natal_moon_sign_index

integer

data.transit_nakshatras

array[TransitNakshatraTara] | null

Every nakshatra the Moon passes through from sunrise to the next sunrise at the birth place, each with its tara.

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

Reserved; product endpoints are not feature-gated by plan (quota differs by tier).

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Gochar — Transit Analysis
• Muhurta — Auspicious Timing
• Planetary transits — Gochar
• Prashna (Horary Chart)
• Varshaphal — Solar Return Chart
• Varshaphal — Harsha Bala
• Varshaphal — Tajika Saham Points

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/nakshatra/prediction" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

Python

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.nakshatra_prediction_request import NakshatraPredictionRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = NakshatraPredictionRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.nakshatra_prediction(nakshatra_prediction_request=request)
    print(result)

TypeScript

import { createClient, createConfig, nakshatraPrediction } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await nakshatraPrediction({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "target_date": "2026-09-28",
    "transit_moon": {
      "nakshatra": "Revati",
      "nakshatra_index": 26,
      "rashi_index": 11
    },
    "tarabala": {
      "tara_number": 4,
      "count_from_birth": 13,
      "cycle": 2,
      "cycle_name": "Anujanma",
      "name": "Kshema",
      "meaning": "Prosperity",
      "is_favorable": true,
      "is_moon_in_birth_nakshatra": false,
      "interpretation": "The Moon is in Revati. Fourth Tara brings wellbeing and security. Good for health-related matters and family."
    },
    "chandrabala": {
      "moon_house_from_natal": 6,
      "is_favorable": true,
      "favorable_houses": [
        1,
        3,
        "... and 4 more items"
      ]
    },
    "daily_score": {
      "score": 4,
      "max_score": 4,
      "label": "Excellent"
    },
    "transit_nakshatra_quality": {
      "nakshatra": "Revati",
      "quality_type": "Mridu",
      "english": "Gentle",
      "auspicious_for": [
        "Romance and marriage",
        "Making new friends",
        "... and 5 more items"
      ],
      "inauspicious_for": [
        "Aggressive confrontations",
        "Forceful acts",
        "... and 1 more item"
      ]
    },
    "nakshatra_activities": {
      "favorable": [
        "travel completion",
        "compassion service",
        "... and 4 more items"
      ],
      "unfavorable": [
        "violent conflict",
        "hard punitive actions",
        "... and 1 more item"
      ]
    },
    "transit_nakshatras": [
      {
        "nakshatra": "Revati",
        "nakshatra_index": 26,
        "start": "2026-09-27T11:08:19+05:30",
        "end": "2026-09-28T10:16:31+05:30",
        "tara": {
          "count_from_birth": 13,
          "tara_number": 4,
          "cycle": 2,
          "cycle_name": "Anujanma",
          "name": "Kshema",
          "meaning": "Prosperity",
          "is_favorable": true,
          "is_moon_in_birth_nakshatra": false,
          "interpretation": "The Moon is in Revati. Fourth Tara brings wellbeing and security. Good for health-related matters and family."
        }
      },
      {
        "nakshatra": "Ashwini",
        "nakshatra_index": 0,
        "start": "2026-09-28T10:16:31+05:30",
        "end": "2026-09-29T09:03:44+05:30",
        "tara": {
          "count_from_birth": 14,
          "tara_number": 5,
          "cycle": 2,
          "cycle_name": "Anujanma",
          "name": "Pratyak",
          "meaning": "Obstacle",
          "is_favorable": false,
          "is_moon_in_birth_nakshatra": false,
          "interpretation": "The Moon is in Ashwini. Fifth Tara brings delays and opposition. Avoid forcing outcomes — patience yields better results…"
        }
      }
    ],
    "birth_nakshatra": {
      "name": "Swati",
      "index": 14
    },
    "natal_moon_sign_index": 6
  }
}