FreeAstroAPI Astrology

Calculate a Chinese BaZi (Four Pillars of Destiny) chart: the year, month, day and hour pillars, the day master, the five-element balance and the ten-year luck cycles. Requires the birth year, month and day; add hour, minute and a city or lat/lng for the hour pillar. `sex` (M or F) only sets the direction of the luck cycles.

calculate_bazi_chart

Calculate a Vedic (sidereal, Jyotish) birth chart: the ascendant (lagna), planets in signs, houses and nakshatras, plus the current Sade Sati status. Use it for Vedic or Indian astrology questions. Requires the birth year, month, day, hour and minute plus a city or lat/lng. Uses the Lahiri ayanamsha unless another is given.

calculate_vedic_chart

Calculate a Western (tropical) birth chart: planet signs, degrees and houses, the Ascendant and Midheaven, and the major aspects between planets. Use it for questions about someone's birth chart, Sun, Moon or rising sign, or a specific placement. Pass the birth year, month, day, hour and minute plus a city (or lat/lng). If the birth time is unknown, set time_known to false: houses and angles are then unreliable. Returns calculated positions, not a written reading.

calculate_natal_chart

Calculate a numerology profile, including the life path number and name-based core numbers, from a person's name and birth date. Pass `subject` with name as {"birth": full birth name} (add "current" for a changed name), birth_date (YYYY-MM-DD) and tz_str (IANA timezone), and `method` with system set to pythagorean or chaldean.

calculate_numerology_profile

Calculate a solar return chart: the chart for the moment the Sun returns to its exact birth position in a given year, used for a birthday-year outlook. Requires `natal` birth details with a location, and `solar_return` with the year and the location where the person will be on that birthday.

calculate_solar_return

Check traditional Vedic marriage compatibility for two people: the Ashtakoota (Guna Milan) score out of 36 and dosha checks such as Manglik. Requires full birth details for person1 and person2. Present the result as a traditional indicator, not a decision about a relationship.

check_vedic_compatibility

Compare two people's Western birth charts (synastry) and return a relationship compatibility summary with the main supporting and challenging aspects between them. Requires birth details for person_a and person_b (year, month, day, hour, minute, and city or lat/lng). Set time_unknown to true for a person whose birth time is not known.

compare_birth_charts

Get the Moon phase and illumination for a moment in time (defaults to now), plus the dates of the next new Moon, first quarter, full Moon and last quarter. Add a city or lat/lon for local times. Set include_zodiac, include_rise_set, include_eclipse or include_interpretation to true when the question needs that detail. For several dates, call it once per date.

get_moon_phase

Get the Hindu Panchang for a date, time and place: tithi, nakshatra, yoga, karana, weekday, sunrise, sunset and Rahu Kalam. Use it for questions about the Vedic calendar or auspicious timing on a given day. Requires year, month, day, hour and minute plus a city or lat/lng.

get_panchang

Calculate the Vimshottari dasha timeline (planetary major and sub-periods) from birth details and show which periods are active now. Use it for Vedic timing questions such as which dasha someone is running. Requires the full birth date and time plus a city or lat/lng.

get_vimshottari_dasha