Vedic Astrology

Vedic astrology (Jyotish) is the Indian system of astrology used by over a billion people. It uses the sidereal zodiac (star-based positions) instead of the tropical zodiac (season-based) used in Western astrology. Your users care about this for kundli generation, matrimonial matchmaking (Gun Milan), dasha period predictions, and auspicious timing (muhurta).

New to fetch()? The Western Astrology guide has an annotated example explaining every line of an API call.

What you can build

Kundli/matchmaking platforms — Gun Milan scoring for matrimonial compatibility, Manglik dosha detection
Dasha prediction apps — Vimshottari Dasha timeline showing planetary periods and sub-periods
Panchang calendars — daily Hindu calendar with tithis, nakshatras, and muhurtas
KP astrology tools — Krishnamurti Paddhati horoscopes and horary charts

Which endpoints to call

Birth chart (Kundli)

The most common call. Returns planets, houses, nakshatras, and lagna:

const response = await fetch('https://roxyapi.com/api/v2/vedic-astrology/birth-chart', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    date: '1990-07-15',
    time: '14:30:00',
    latitude: 19.076,
    longitude: 72.8777,
    timezone: 5.5
  })
});
const chart = await response.json();

Which fields to show your users:

planets — each planet's rashi (zodiac sign), nakshatra, nakshatra pada, and house placement. The Moon's nakshatra is the most important field for Vedic astrology users.
lagna — the Ascendant sign. This is the anchor of the entire chart.
houses — which planets occupy which house (bhava). House lords determine life area predictions.

Gun Milan (Compatibility)

The standard Indian matrimonial compatibility check. Returns a score out of 36:

const response = await fetch('https://roxyapi.com/api/v2/vedic-astrology/compatibility', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    person1: { date: '1990-07-15', time: '14:30:00', latitude: 19.076, longitude: 72.8777, timezone: 5.5 },
    person2: { date: '1992-03-22', time: '09:00:00', latitude: 28.6139, longitude: 77.209, timezone: 5.5 }
  })
});
const gunMilan = await response.json();
// gunMilan.totalScore — out of 36, 18+ is considered acceptable

Which fields to show your users: totalScore (out of 36) is the headline number. The 8 individual kuta scores (Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakut, Nadi) each have a score and description. Scores above 18 are traditionally considered acceptable for marriage.

Vimshottari Dasha

Returns the full dasha timeline — which planetary period someone is currently in:

const response = await fetch('https://roxyapi.com/api/v2/vedic-astrology/dasha', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    date: '1990-07-15',
    time: '14:30:00',
    latitude: 19.076,
    longitude: 72.8777,
    timezone: 5.5
  })
});
const dasha = await response.json();

Which fields to show your users: Each dasha period has planet, startDate, endDate, and sub-periods (antardashas). The current active period tells users which planet is "ruling" their life right now. Show the timeline as a visual progress bar or list.

Key concepts

Rashi — zodiac sign in Vedic astrology (same 12 signs, but shifted ~24 degrees from Western positions due to ayanamsa correction)
Nakshatra — lunar mansion. 27 nakshatras divide the zodiac into segments of 13 degrees 20 minutes each. The Moon's nakshatra at birth determines the dasha sequence.
Lagna — Ascendant sign. Changes every ~2 hours, so birth time accuracy matters.
Dasha — planetary period system. Vimshottari dasha assigns 120-year cycles ruled by different planets. Predicts which life themes are active.
Dosha — afflictions in the chart. Manglik dosha (Mars-related) is the most commonly checked for marriage compatibility.
Yoga — beneficial combinations of planets. Over 300 classical yogas indicate wealth, fame, spirituality, etc.

You do not need to understand any of this to use the API. All responses include English interpretations.

Full API reference

See all Vedic Astrology endpoints in the API Reference.