Personal Nakshatra Prediction (Tarabala)

Returns a personalised daily prediction using Tarabala and Chandrabala. 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.

Endpoint

POST /v1/astro/nakshatra/prediction

Request parameters

Field	Type	Required	Description
location	string | null	No	City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
name	string	No	Person name associated with the birth record
date	string	Yes	Birth date in YYYY-MM-DD format
time	string | null	No	Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
latitude	number | null	No	Latitude. Required if location not provided.
longitude	number | null	No	Longitude. Required if location not provided.
timezone	string | null	No	IANA timezone. Required if location not provided.
ayanamsa	string	No	Sidereal ayanamsa mode used in calculations
target_date	string (date) | null	No	Date for the prediction day; defaults to today

Example request

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);

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "target_date": "2026-05-28",
    "transit_moon": {
      "nakshatra": "Swati",
      "nakshatra_index": 14,
      "rashi_index": 6
    },
    "tarabala": {
      "tara_number": 1,
      "count_from_birth": 1,
      "name": "Janma",
      "meaning": "Birth star",
      "is_favorable": false,
      "interpretation": "The transit Moon is in your birth nakshatra. Be mindful of health and emotional sensitivity today."
    },
    "chandrabala": {
      "moon_house_from_natal": 1,
      "is_favorable": true,
      "favorable_houses": [
        1,
        3,
        "... and 4 more items"
      ]
    },
    "daily_score": {
      "score": 2,
      "max_score": 4,
      "label": "Moderate"
    },
    "transit_nakshatra_quality": {
      "nakshatra": "Swati",
      "quality_type": "Chara",
      "english": "Movable",
      "auspicious_for": [
        "Travel and starting journeys",
        "Purchasing and riding vehicles",
        "... and 4 more items"
      ],
      "inauspicious_for": [
        "Long-term commitments and permanent vows",
        "Laying permanent foundations",
        "... and 1 more item"
      ]
    },
    "nakshatra_activities": {
      "favorable": [
        "trade",
        "independent business",
        "... and 3 more items"
      ],
      "unfavorable": [
        "fixed rigid vows",
        "forced emotional commitments",
        "... and 1 more item"
      ]
    },
    "birth_nakshatra": {
      "name": "Swati",
      "index": 14
    },
    "natal_moon_sign_index": 6
  }
}

Response fields

Field	Type	Description
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
data.tarabala.count_from_birth	integer
data.tarabala.name	string
data.tarabala.meaning	string
data.tarabala.is_favorable	boolean
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

Errors

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

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