Nakshatra Transit API

Overview

The Moon transits through 27 nakshatras approximately every 27 days. This API provides:

Current Nakshatra: Moon's current nakshatra position
Tara Bala: Relationship with your birth nakshatra (9 categories)
Transit Effects: Good/bad period based on nakshatra relationship
Timing: Start and end times of current nakshatra
Activities: Suitable and unsuitable activities for the period

Request

curl -X POST "https://api.vedika.io/v2/astrology/nakshatra-transit" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "datetime": "1990-05-15T10:30:00+05:30",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "transitDate": "2026-01-07"
  }'

Parameters

Parameter	Type	Required	Description
`datetime`	string	Required	Birth date/time (ISO 8601)
`latitude`	number	Required	Birth latitude
`longitude`	number	Required	Birth longitude
`transitDate`	string	Optional	Date to check transit (defaults to today)

Response

{
  "success": true,
  "data": {
    "birthNakshatra": {
      "name": "Rohini",
      "number": 4,
      "lord": "Moon",
      "pada": 2,
      "deity": "Brahma"
    },
    "currentTransit": {
      "nakshatra": "Hasta",
      "number": 13,
      "lord": "Moon",
      "startTime": "2026-01-07T03:45:00+05:30",
      "endTime": "2026-01-08T05:23:00+05:30",
      "remainingDuration": "14h 23m",
      "moonDegree": 168.456,
      "rashi": "Virgo"
    },
    "taraBala": {
      "position": 10,
      "cycle": 2,
      "taraNumber": 1,
      "taraName": "Janma",
      "nature": "Mixed",
      "description": "Moon transiting 10th nakshatra from birth - Janma Tara (10th position in 2nd cycle)",
      "interpretation": "Janma Tara can bring focus on self, health matters. Be mindful of emotional decisions."
    },
    "prediction": {
      "overall": "Moderate",
      "score": 6,
      "guidance": "Day favors routine activities. Avoid starting new ventures. Good for completing pending work.",
      "activities": {
        "favorable": ["Completing tasks", "Health checkups", "Short travel", "Meeting relatives"],
        "avoid": ["New projects", "Major purchases", "Important decisions", "Long journeys"]
      }
    },
    "nineNakshatraCycle": {
      "description": "The 27 nakshatras form 3 cycles of 9 from your birth nakshatra",
      "cycle": [
        { "tara": "Janma", "position": 1, "nature": "mixed", "current": false },
        { "tara": "Sampat", "position": 2, "nature": "good", "current": false },
        { "tara": "Vipat", "position": 3, "nature": "bad", "current": false },
        { "tara": "Kshema", "position": 4, "nature": "good", "current": false },
        { "tara": "Pratyak", "position": 5, "nature": "bad", "current": false },
        { "tara": "Sadhana", "position": 6, "nature": "good", "current": false },
        { "tara": "Vadha", "position": 7, "nature": "bad", "current": false },
        { "tara": "Mitra", "position": 8, "nature": "good", "current": false },
        { "tara": "Atimitra", "position": 9, "nature": "best", "current": false }
      ]
    },
    "upcomingTransits": [
      {
        "nakshatra": "Chitra",
        "startTime": "2026-01-08T05:23:00+05:30",
        "taraNumber": 2,
        "taraName": "Sampat",
        "nature": "Good - wealth and prosperity"
      },
      {
        "nakshatra": "Swati",
        "startTime": "2026-01-09T07:12:00+05:30",
        "taraNumber": 3,
        "taraName": "Vipat",
        "nature": "Challenging - avoid important work"
      }
    ]
  },
  "metadata": { "cost": 0.003 }
}

Nine Tara (Star) Classification

1. Janma (Birth)

Mixed - focus on self, health awareness

2. Sampat (Wealth)

Good - prosperity, gains

3. Vipat (Danger)

Bad - obstacles, losses

4. Kshema (Well-being)

Good - peace, prosperity

5. Pratyak (Obstacles)

Bad - hindrances, delays

6. Sadhana (Achievement)

Good - success in efforts

7. Vadha (Death)

Bad - avoid important work

8. Mitra (Friend)

Good - favorable for relationships

9. Atimitra (Best Friend)

Best - highly auspicious