Which Vedic-oriented calculations are supported?
On zodiac-option chart routes, send "zodiac": "sidereal" to opt in. Cosmic Ephemeris subtracts the
selected date-aware ayanamsa from tropical longitude and returns the sidereal
result. If the ayanamsa is omitted in sidereal mode, it defaults to
lahiri. Vargas, varga SVG, Vimshottari and Panchang are always
sidereal; select their ayanamsa rather than sending a zodiac field.
- Ayanamsas
- Lahiri, Raman, Krishnamurti, Fagan–Bradley (
fagan_bradley), Yukteshwar (yukteshwar), Sassanian (sassanian), True Chitra (true_chitra), True Revati (true_revati), True Pushya (true_pushya), Galactic Center at 0 Sagittarius (galactic_center_0_sagittarius), Galactic Alignment/Mardyks (galactic_alignment_mardyks) - Nakshatra geometry
- 27 nakshatras × 4 padas
- Date modes
- 1800–2200 standard civil dates; 1000 BCE (BC)–2500 CE (AD) with explicit historical conventions and per-tool limits.
Sidereal birth charts
Sidereal longitudes, signs, chart angles, houses, aspects, nodes, and Moon nakshatra data.
Sidereal houses
All 25 explicit Houses choices support sidereal output: 24 twelve-house systems plus Houses-only Gauquelin sectors, with each method's documented geometry limits.
Sidereal transits
A natal chart, one requested transit chart, and their cross-chart aspects.
Sidereal synastry
Two charts in the same sidereal frame plus raw cross-chart aspect geometry.
Nakshatra timelines Pro
Gap-free nakshatra and pada residence windows across a caller-supplied UTC interval.
Twenty-four divisional charts Current
D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D16, D20, D24, D27, D30, D40, D45, D60, D81, D108, D144, and D150 placements in JSON and matching North/South Indian SVGs.
Vimshottari periods Current
Natal Moon balance, major periods and subperiods, with optional third-level Pratyantardasha, fourth-level Sookshma periods and a fixed 365.25-day year.
Instant Panchang Current
Tithi, nakshatra, yoga, karana, vara and bounded USNO solar events—not a festival or regional calendar.
Ashtakavarga Current
Seven-planet Bhinnashtakavarga, contributor Prastara, 337-point Sarvashtakavarga, and explicit opt-in reductions and pindas without interpretation.
Partial Shadbala foundation Current
An explicit sidereal natal-analysis option returns bounded positional, directional, temporal-subset, motional, and partial aspect components—not complete Shadbala.
System selection
How tropical defaults, sidereal opt-in, ayanamsa choice, and separate products relate.
What does the nakshatra timeline return?
The Pro timeline endpoint divides the sidereal zodiac into 108 nakshatra-pada segments and returns contiguous residence intervals. Supported bodies are the Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Rahu, and Ketu. A requested interval must be positive, no longer than 180 days, and within the public calculation window.
Timeline output is geometry only. Rahu uses the engine's mean north node, and Ketu is its opposite south node. This endpoint does not calculate dashas or make predictions.
Named North/South Hindu festival calendars
The supplemental Vedic API offers North Purnimanta and South Amanta presets with 18 named observances per preset in bounded 1–31-day windows. Coverage includes Diwali/Lakshmi Puja, Maha Shivaratri, Rama Navami, Ganesh Chaturthi and other explicitly named rules. Governing-window evidence explains how a date was selected; ambiguous or unavailable results remain unresolved.
Historical dates use proleptic calculations, not claims that a festival was observed then. This is not a complete regional or sectarian calendar: Holi, Janmashtami, Ekadashi/parana and other excluded rules are not silently substituted.
What is outside the current Jyotish scope?
Cosmic Ephemeris is not a complete Vedic or Jyotish astrology system. Sidereal longitude and nakshatra geometry are inputs to many different traditions; they do not encode an entire interpretive or calendrical system. Cosmic Ephemeris does not provide the following complete systems:
- Dashas beyond the documented Vimshottari method (through optional depth 4) and supplemental Yogini periods
- Interpretive planetary yoga combinations, complete Shadbala, or complete dignity and strength systems; the documented Ashtakavarga API and opt-in partial Shadbala foundation remain bounded calculation-only current methods
- Complete regional or sectarian festival calendars, religious muhurta election rules, or festival allocation beyond the 18 named observances per North/South preset
- Vargas beyond the twenty-four documented D1/D2/D3/D4/D5/D6/D7/D8/D9/D10/D11/D12/D16/D20/D24/D27/D30/D40/D45/D60/D81/D108/D144/D150 mappings, or alternative divisional-chart conventions
- Alternative Hindu-geocentric sunrise conventions or undocumented regional rules; Panchang and the named festival calendars use the documented USNO solar-event model
- Interpretive, religious, remedial, or certainty-based predictions
Supported D1/D2/D3/D4/D5/D6/D7/D8/D9/D10/D11/D12/D16/D20/D24/D27/D30/D40/D45/D60/D81/D108/D144/D150, Vimshottari, Indian SVG and instant Panchang APIs provide defined calculations, not a complete tradition or predictive certainty. Vimshottari retains its original two-level default; optional depth 3 and 4 add 729 Pratyantardasha and 6,561 Sookshma periods under the same fixed year and birth-balance convention. Panchang returns instant tithi, nakshatra, yoga and karana plus sunrise-based vara and local-date solar events. Latitude is limited to [-88,88], sunrise uses the USNO −50 arcminute horizon at zero elevation, and unavailable or unsupported solar geometry is explicit. North/South Indian SVGs show D1/D2/D3/D4/D5/D6/D7/D8/D9/D10/D11/D12/D16/D20/D24/D27/D30/D40/D45/D60/D81/D108/D144/D150 sign placements, not bhava-chalit. Developers building the other features must define, implement, test, and disclose their own rules instead of presenting Cosmic Ephemeris's coordinate output as a complete Jyotish answer.
Appropriate product uses
Astrologers can work with a developer to build consultation dashboards, sidereal chart displays, and nakshatra learning tools. Specify the ayanamsa and house system your practice uses so those choices remain visible to your clients.
- Sidereal chart renderers with an explicit, user-selected ayanamsa
- Nakshatra and pada displays derived from returned geometry
- Transition calendars for supported bodies and bounded intervals
- Educational comparison tools that show how ayanamsa selection changes longitude
- Application-owned Jyotish logic built on a declared, tested coordinate layer
For application architecture and responsible handling of birth inputs, see Cosmic Ephemeris use cases. For calculation formulas and known approximations, see methodology.