Sidereal and nakshatra calculations

Sidereal & Vedic-Oriented Astrology API

Two date modes: standard civil inputs cover 1800–2200. All 77 date-bearing operations also accept explicit historical inputs from 1000 BCE (BC) to 2500 CE (AD), with a chosen calendar and, for timed calculations, UT1 or a fixed UT1 offset. Date-only numerology requires an explicit year-digit convention. Place search is date-independent. Each tool retains its search, geometry, derived-date and export limits; historical iCalendar is not supported. The ordinary date-string examples below describe standard mode. Historical input guide and current schemas.

Build divisional charts, dasha displays, and sidereal tools with a Vedic-oriented developer API. Cosmic Ephemeris provides an explicit sidereal mode with Lahiri, Raman, Krishnamurti, Fagan–Bradley, Yukteshwar, Sassanian, True Chitra, True Revati, True Pushya, Galactic Center at 0 Sagittarius, and Galactic Alignment/Mardyks ayanamsas, sidereal charts, Moon nakshatra and pada data, and a Pro timeline endpoint for supported bodies. Separate supported APIs provide twenty-four divisional charts, North/South Indian SVGs, Vimshottari through optional depth 4, instant Panchang elements, bounded Ashtakavarga, and an opt-in partial Shadbala foundation. Supplemental APIs add Yogini periods, regional calendar factors and named Hindu festival calendars.

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.