Cosmic Chemistry

Use this when someone asks for their Vedic birth chart, kundli, janam kundali, sidereal chart, or where their planets are in Vedic astrology (signs, houses, nakshatras, rising sign). Returns all nine planets with sign, degree, house (needs birth time), nakshatra and pada. If the person asks for only one thing (rising sign, Moon sign, dasha, Manglik), use the narrower tool. Needs birth date and town, and the time for houses; ask if missing. Do not use for Western/tropical charts or daily horoscopes.

{
  "type": "object",
  "properties": {
    "birth_date": {
      "type": "string",
      "description": "Date of birth, YYYY-MM-DD, e.g. 1993-03-17."
    },
    "birth_time": {
      "type": "string",
      "description": "Local clock time of birth, 24-hour HH:MM, e.g. 13:35. As exact as possible (from a birth certificate)."
    },
    "birth_place": {
      "type": "string",
      "description": "Town or city of birth, with region or country if known, e.g. \"Chicago, Illinois, US\" or \"Pune, India\"."
    }
  },
  "required": [
    "birth_date",
    "birth_place"
  ],
  "additionalProperties": false
}

Use this when someone asks for their rising sign, ascendant or lagna in Vedic astrology, or why their Vedic rising sign differs from a Western app. Returns the Vedic rising sign, its ruler, and the Western rising sign for comparison. Needs the birth time.

{
  "type": "object",
  "properties": {
    "birth_date": {
      "type": "string",
      "description": "Date of birth, YYYY-MM-DD, e.g. 1993-03-17."
    },
    "birth_time": {
      "type": "string",
      "description": "Local clock time of birth, 24-hour HH:MM, e.g. 13:35. As exact as possible (from a birth certificate)."
    },
    "birth_place": {
      "type": "string",
      "description": "Town or city of birth, with region or country if known, e.g. \"Chicago, Illinois, US\" or \"Pune, India\"."
    }
  },
  "required": [
    "birth_date",
    "birth_time",
    "birth_place"
  ],
  "additionalProperties": false
}

Use this when someone asks for their Moon sign (rashi), birth star or nakshatra and pada in Vedic astrology. Also use for "birth star", "janma nakshatra", "what is my rashi", "my zodiac sign in Vedic astrology". Works from the birth date and town; the time makes it exact when the Moon changes sign that day. Do not use for Western sun signs, horoscopes or the rising sign.

{
  "type": "object",
  "properties": {
    "birth_date": {
      "type": "string",
      "description": "Date of birth, YYYY-MM-DD, e.g. 1993-03-17."
    },
    "birth_time": {
      "type": "string",
      "description": "Local clock time of birth, 24-hour HH:MM, e.g. 13:35. As exact as possible (from a birth certificate)."
    },
    "birth_place": {
      "type": "string",
      "description": "Town or city of birth, with region or country if known, e.g. \"Chicago, Illinois, US\" or \"Pune, India\"."
    }
  },
  "required": [
    "birth_date",
    "birth_place"
  ],
  "additionalProperties": false
}

Use this when someone asks whether they are in Sade Sati, when their Sade Sati starts or ends, or about Saturn’s seven and a half years. Also use for Shani sade sati and "Saturn’s 7.5 years". Returns whether it is running now, its three phases with dates, and the next one. Needs birth date and town.

{
  "type": "object",
  "properties": {
    "birth_date": {
      "type": "string",
      "description": "Date of birth, YYYY-MM-DD, e.g. 1993-03-17."
    },
    "birth_time": {
      "type": "string",
      "description": "Local clock time of birth, 24-hour HH:MM, e.g. 13:35. As exact as possible (from a birth certificate)."
    },
    "birth_place": {
      "type": "string",
      "description": "Town or city of birth, with region or country if known, e.g. \"Chicago, Illinois, US\" or \"Pune, India\"."
    }
  },
  "required": [
    "birth_date",
    "birth_place"
  ],
  "additionalProperties": false
}

Use this when someone asks when their Saturn return is (in Vedic, sidereal reckoning), whether they are in it now, or at what ages it comes. Also use for "Saturn return at 28/29" and Shani return. Returns every Saturn return with dates and ages. Needs birth date and town; ask if missing.

{
  "type": "object",
  "properties": {
    "birth_date": {
      "type": "string",
      "description": "Date of birth, YYYY-MM-DD, e.g. 1993-03-17."
    },
    "birth_time": {
      "type": "string",
      "description": "Local clock time of birth, 24-hour HH:MM, e.g. 13:35. As exact as possible (from a birth certificate)."
    },
    "birth_place": {
      "type": "string",
      "description": "Town or city of birth, with region or country if known, e.g. \"Chicago, Illinois, US\" or \"Pune, India\"."
    }
  },
  "required": [
    "birth_date",
    "birth_place"
  ],
  "additionalProperties": false
}

Use this when someone asks which mahadasha or antardasha they are running, their Vimshottari dasha timeline, when their next dasha begins, or when a dasha ends ("when does my Rahu dasha end", "my current dasha lord"). Returns every mahadasha with dates, and the current and next antardasha. Needs birth date, time and town.

{
  "type": "object",
  "properties": {
    "birth_date": {
      "type": "string",
      "description": "Date of birth, YYYY-MM-DD, e.g. 1993-03-17."
    },
    "birth_time": {
      "type": "string",
      "description": "Local clock time of birth, 24-hour HH:MM, e.g. 13:35. As exact as possible (from a birth certificate)."
    },
    "birth_place": {
      "type": "string",
      "description": "Town or city of birth, with region or country if known, e.g. \"Chicago, Illinois, US\" or \"Pune, India\"."
    }
  },
  "required": [
    "birth_date",
    "birth_time",
    "birth_place"
  ],
  "additionalProperties": false
}

Use this when someone asks if they are Manglik or have Mangal dosha. Returns where Mars falls from the rising sign, the Moon and Venus. Present it honestly: about half of all charts count as Manglik by the common rule, so it is common, not a danger. Needs the birth time.

{
  "type": "object",
  "properties": {
    "birth_date": {
      "type": "string",
      "description": "Date of birth, YYYY-MM-DD, e.g. 1993-03-17."
    },
    "birth_time": {
      "type": "string",
      "description": "Local clock time of birth, 24-hour HH:MM, e.g. 13:35. As exact as possible (from a birth certificate)."
    },
    "birth_place": {
      "type": "string",
      "description": "Town or city of birth, with region or country if known, e.g. \"Chicago, Illinois, US\" or \"Pune, India\"."
    }
  },
  "required": [
    "birth_date",
    "birth_time",
    "birth_place"
  ],
  "additionalProperties": false
}

Use this when someone asks what a planet in a house means in Vedic astrology, e.g. "Venus in the 8th house", "Saturn in 12th house meaning", "Sun in my 12th house". Use this instead of vedic_birth_chart when the person names a planet and a house, even in the first person ("my Venus is in my 8th"); do not ask for birth details. Returns what the house holds, what the planet brings, and our article when one exists. None of these tools cover daily horoscopes, gemstones, tarot or predictions.

{
  "type": "object",
  "properties": {
    "planet": {
      "type": "string",
      "enum": [
        "sun",
        "moon",
        "mars",
        "mercury",
        "jupiter",
        "venus",
        "saturn",
        "rahu",
        "ketu"
      ]
    },
    "house": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "House number, 1 to 12."
    }
  },
  "required": [
    "planet",
    "house"
  ],
  "additionalProperties": false
}

Use this when someone asks for today’s panchang or the Hindu calendar for a place: the tithi, nakshatra, yoga, karana, Rahu kaal (rahu kalam), Yamaganda, Gulika, Abhijit muhurat, choghadiya, sunrise and sunset, or which festival or vrat falls today ("aaj ka panchang", "what is today’s tithi", "Rahu kaal today in Pune", "is today Ekadashi", "good time to start today"). Also answers for another date. Needs no birth details. Send the town if the person has said it; without one the answer is for New Delhi. Do not use for a person’s birth chart or birth star.

{
  "type": "object",
  "properties": {
    "place": {
      "type": "string",
      "description": "Town or city, with region or country if known, e.g. \"Pune, India\" or \"Austin, Texas\"."
    },
    "date": {
      "type": "string",
      "description": "The date wanted, as YYYY-MM-DD. Leave out for today at that place."
    }
  },
  "required": [],
  "additionalProperties": false
}

Use this when someone asks when a Hindu festival, vrat or observance falls, or what is coming up: "when is Diwali", "next Ekadashi", "Karwa Chauth date", "Pradosh vrat this month", "festivals in November", "when is Pongal in Chennai". Returns the dated list for a place, from a start date (today if left out), for up to 120 days. For a festival in a later year, set "from" to about a month before its usual season. Dates can differ from city to city, so send the town if known; without one the list is for New Delhi. Needs no birth details.

{
  "type": "object",
  "properties": {
    "place": {
      "type": "string",
      "description": "Town or city, with region or country if known, e.g. \"Pune, India\" or \"Austin, Texas\"."
    },
    "from": {
      "type": "string",
      "description": "First day of the list, as YYYY-MM-DD. Leave out for today."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "How many days to list, 1 to 120. Default 45."
    },
    "name": {
      "type": "string",
      "description": "Optional: only days whose name contains this word, e.g. \"Ekadashi\", \"Diwali\", \"Pradosh\"."
    }
  },
  "required": [],
  "additionalProperties": false
}

Use this when someone asks where the Moon is right now or today: its sign (Vedic and Western), its nakshatra, its phase, or when the next full moon or new moon comes ("what sign is the Moon in today", "moon phase today", "next full moon", "today’s nakshatra"). Needs no birth details and no place. Do not use for a person’s own Moon sign at birth: use moon_sign_nakshatra for that.

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

Use this when someone asks for the planetary hours or hora of a day and place, which planet rules the hour now, or when a planet’s hour comes ("planetary hours today in London", "what planetary hour is it", "when is the Venus hour today", "hora today"). Returns the twelve day hours and twelve night hours counted from sunrise, with clock times for that place, and the hour running now. Needs the town: ask if the person has not said it. Needs no birth details.

{
  "type": "object",
  "properties": {
    "place": {
      "type": "string",
      "description": "Town or city, with region or country if known, e.g. \"Pune, India\" or \"Austin, Texas\"."
    },
    "date": {
      "type": "string",
      "description": "The date wanted, as YYYY-MM-DD. Leave out for today at that place."
    }
  },
  "required": [
    "place"
  ],
  "additionalProperties": false
}

Use this when someone asks whether Mercury is retrograde now, when the next Mercury retrograde starts or ends, or for the Mercury retrograde dates of a year ("is Mercury in retrograde", "when does Mercury retrograde end", "Mercury retrograde 2027 dates"). Returns the period running now or the next one, with its shadow dates and signs, and the ones after it. Needs no birth details and no place. Say it without fear: it is a stretch of the calendar, not a warning.

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 2024,
      "maximum": 2031,
      "description": "Optional: list every Mercury retrograde of this year."
    }
  },
  "required": [],
  "additionalProperties": false
}