Nakshatra Timeline API

AstroAPI uses Western (tropical), geocentric astrology by default. The Nakshatra Timeline endpoint operates exclusively in sidereal coordinates and requires explicit ayanamsa selection. This endpoint provides geometric timelines only and does not implement full Vedic astrology systems.

Generate continuous, gap-free timelines of nakshatra and pada transitions for a single celestial body across a specified date range. Designed for passive, server-to-server usage.

Astronomical Foundations

AstroAPI uses NASA JPL DE421 ephemeris data as the authoritative astronomical source. All planetary positions are computed deterministically using a geocentric reference frame.

No AI models, heuristics, probabilistic systems, or interpretive logic are involved in timeline generation.

What this endpoint CAN do

• Compute sidereal longitudes using a selected ayanamsa
• Generate continuous nakshatra and pada timelines
• Handle direct motion, retrograde motion, and station points
• Return deterministic, reproducible results
• Provide raw geometry suitable for analytics and visualization

Operational Limits (Important)

This endpoint is optimized for short-range, high-precision astronomical timelines. To ensure reliable performance, the following limits are enforced.

• Maximum timeline range: 6 months (180 days)
• Minimum resolution: 1 hour per step
• Execution model: synchronous, short-burst computation

Requests exceeding these limits return a clean 400 Bad Request instead of timing out.

What this endpoint CANNOT do

• Generate timelines longer than 6 months in a single request
• Produce multi-year or multi-decade nakshatra timelines
• Run fine-grained (minute- or second-level) resolution over long ranges
• Perform bulk or batch historical timeline generation
• No interpretations, meanings, or predictive analysis
• No dashas, yogas, tithis, or Panchanga calculations
• No cultural, religious, or tradition-specific overlays
• No tropical (Western) zodiac output

Quick Test / curl

curl -i https://api.astroapi.io/api/astro/nakshatra-timeline \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -d '{
    "planet": "saturn",
    "start_utc": "2000-01-01T00:00:00Z",
    "end_utc": "2000-04-01T00:00:00Z",
    "ayanamsa": "lahiri"
  }'

// JavaScript — Nakshatra Timeline API
fetch("https://api.astroapi.io/api/astro/nakshatra-timeline", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    planet: "saturn",
    start_utc: "2000-01-01T00:00:00Z",
    end_utc: "2000-04-01T00:00:00Z",
    ayanamsa: "lahiri"
  })
})
  .then(res => res.json())
  .then(data => console.log(data));

# Python — Nakshatra Timeline API
import requests

url = "https://api.astroapi.io/api/astro/nakshatra-timeline"

payload = {
  "planet": "saturn",
  "start_utc": "2000-01-01T00:00:00Z",
  "end_utc": "2000-04-01T00:00:00Z",
  "ayanamsa": "lahiri"
}

headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())