Asterwise Astrology
Asterwise is an astrology REST API built for developers. It provides accurate ephemeris calculations across Vedic and classical traditions. **Core capabilities:** - Natal charts with planet positions, house cusps, arudha padas, and divisional charts - Vimshottari Dasha with full period hierarchy - Yoga detection with classical BPHS and Phaladeepika citations by chapter and verse - Dosha analysis…
Asterwise Astrology endpoints
| Method | Endpoint | Description |
|---|---|---|
| Utilities | ||
| GET |
timezone_from_coordinates_v1_utils_timezone_get /v1/utils/timezone |
Get IANA timezone for a coordinate pair. Fully offline — no external API call. Accepts ?latitude=&longitude= and/or ?lat=&lon= (any pair that supplies both coordinates).… |
| GET |
geocode_v1_utils_geocode_get /v1/utils/geocode |
Resolve a city or place name to coordinates and timezone. Returns up to {limit} matches. When a query is ambiguous (e.g. 'Fatehabad' exists in multiple states), multiple results… |
| Astrology | ||
| POST |
post_panchanga_calendar_v1_astro_panchanga_calendar_post /v1/astro/panchanga/calendar |
Same data as GET /v1/astro/panchanga/calendar. Minimum required JSON fields: `year` (1900–2100), `month` (1–12), `lat`, `lon`. Optional `timezone` defaults to Asia/Kolkata. |
| POST |
get_rahu_kaal_v1_astro_panchanga_rahu_kaal_post /v1/astro/panchanga/rahu-kaal |
Calculate the three inauspicious time periods for a given date and location. Rahu Kaal, Gulika Kaal (Mandi), and Yamaganda Kaal are avoided for starting auspicious activities.… |
| POST |
get_atmakaraka_v1_astro_atmakaraka_post /v1/astro/atmakaraka |
Computes all 8 Jaimini Charakarakas from the natal chart: Atmakaraka, Amatyakaraka, Bhratrikaraka, Matrikaraka, Pitrikaraka, Putrakaraka, Gnatikaraka, and Darakaraka. The planet… |
| POST |
get_sade_sati_v1_astro_sade_sati_post /v1/astro/sade-sati |
Calculate all Sade Sati periods for a natal chart. Returns rising, peak, and setting phases for each period, current active status, intensity score (0-100), intensity label, and… |
| POST |
get_yoga_report_v1_astro_yoga_post /v1/astro/yoga |
Detect all classical Vedic yogas in a natal chart — Pancha Mahapurusha Yogas, Raja Yogas, Gajakesari, Neecha Bhanga Raja Yoga, Budhaditya, Chandra Mangala, and more. Each… |
| POST |
get_natal_chart_v1_astro_natal_post /v1/astro/natal |
Calculate a complete Vedic natal chart using Swiss Ephemeris. Returns planet positions in sidereal zodiac, house placements (whole sign), ascendant, nakshatra data, Avakahada… |
| POST |
get_hora_v1_astro_panchanga_hora_post /v1/astro/panchanga/hora |
Calculate all 24 Hora (planetary hours) for a given date and location, starting from sunrise. Each hora is ruled by a planet in the Chaldean sequence with qualities indicating… |
| POST |
get_gochar_v1_astro_gochar_post /v1/astro/gochar |
Computes planetary transits against a natal chart using classical Vedic rules. Returns house positions from Moon and Lagna, Vedha obstruction checks, Ashtakavarga Bhinna scores,… |
| GET |
get_panchanga_calendar_v1_astro_panchanga_calendar_get /v1/astro/panchanga/calendar |
Calculate complete Panchanga for every day of a given month at a given location. Returns all 5 Panchanga elements (Tithi, Vara, Nakshatra, Yoga, Karana) plus Rahu Kaal for each… |
| POST |
panchanga_v1_astro_panchanga_post /v1/astro/panchanga |
Calculate Vedic Panchanga for a given date and location. Returns Tithi, Nakshatra, Yoga, Karana, Vara (weekday), and auspicious and inauspicious periods for the day. Returns… |
| POST |
get_porutham_v1_astro_matchmaking_porutham_post /v1/astro/matchmaking/porutham |
Computes all 10 Kerala Poruthams: Dinam, Ganam, Mahendra, Stree Deergha, Yoni, Rasi, Rasiyathipaty, Rajju, Vedha, and Vasya. Rajju and Vedha are absolute vetoes — if either fails… |
| POST |
get_matchmaking_report_v1_astro_matchmaking_post /v1/astro/matchmaking |
Complete Vedic compatibility analysis using Ashtakoot Guna Milan (36-point system). Returns all 8 koota scores, Mangal Dosha compatibility with Dosha Samya analysis, classical… |
| POST |
get_dosha_report_v1_astro_dosha_post /v1/astro/dosha |
Detect all major Vedic doshas in a natal chart — Mangal Dosha, Kaal Sarp Dosha, Gandmool, Grahan, Guru Chandal, Kemdrum, Shrapit, and Pitru Dosha. Present doshas include… |
| POST |
get_muhurta_v1_astro_muhurta_post /v1/astro/muhurta |
Finds and ranks auspicious time windows for a specific event type. Scores each Choghadiya period using Choghadiya quality, Yoga, Vara (weekday), and Tithi. Returns top N ranked… |
| GET |
get_nakshatra_v1_astro_nakshatra__name__get /v1/astro/nakshatra/{name} |
Returns the complete classical profile for a given nakshatra: deity, ruling planet, gana, nature, body part, profession, life themes, strengths, challenges, favorable/unfavorable… |
| POST |
get_char_dasha_v1_astro_char_dasha_post /v1/astro/char-dasha |
Computes Jaimini Char Dasha — a sign-based dasha system from Jaimini Sutras. Returns mahadasha and antardasha periods starting from the Atmakaraka's sign, with the current active… |
| POST |
get_dasha_periods_v1_astro_dasha_post /v1/astro/dasha |
Calculate complete Vimshottari Dasha timeline for a birth chart. Returns all Mahadasha and Antardasha periods with dates, plus classical interpretation text for the currently… |
| POST |
get_ishta_devta_v1_astro_ishta_devta_post /v1/astro/ishta-devta |
Computes Ishta Devta (personal deity) from the 12th house lord of the Navamsa (D9) chart per Jaimini Sutras. Returns the ruling planet, associated deity, and D9 positions.… |
| POST |
get_thirumana_porutham_v1_astro_matchmaking_thirumana_porutham_post /v1/astro/matchmaking/thirumana-porutham |
Computes all 10 Tamil Thirumana Poruthams with Tamil naming convention. Includes Rajju severity classification (Siro=most severe to Pada=least severe). Rajju and Vedha are… |
| POST |
get_dasha_transits_v1_astro_dasha_transits_post /v1/astro/dasha-transits |
Correlates active Vimshottari Dasha lords (maha, antar, pratyantar) with current planetary transits. Returns conjunction and aspect correlations scored by strength, and… |
| POST |
get_gemstones_v1_astro_gemstones_post /v1/astro/gemstones |
Recommends gemstones based on the natal chart. Primary gemstone strengthens the Lagna lord. Secondary gemstone supports the Atmakaraka (soul planet). Returns contraindicated… |
| POST |
get_varshaphal_v1_astro_varshaphal_post /v1/astro/varshaphal |
Computes the Varshaphal (annual horoscope) for a given year. Finds the exact moment when the Sun returns to its natal longitude, computes all planet positions at that moment, and… |
| POST |
get_choghadiya_v1_astro_panchanga_choghadiya_post /v1/astro/panchanga/choghadiya |
Calculate all 16 Choghadiya periods (8 day + 8 night) for a given date and location. Each period is classified (e.g. highly auspicious for Amrit, good, beneficial, neutral, or… |
| POST |
get_remedies_v1_astro_remedies_post /v1/astro/remedies |
Prescribes personalised Vedic remedies based on planetary dignity in the natal chart. Prioritises debilitated planets, planets in enemy signs, and dusthana lords (6th/8th/12th… |
| POST |
get_papasamyam_v1_astro_matchmaking_papasamyam_post /v1/astro/matchmaking/papasamyam |
Computes Papasamyam between two natal charts. Scores each person based on Sun, Mars, Saturn, Rahu, Ketu in houses 1, 2, 4, 7, 8, 12 from Lagna, Moon, and Venus (#105). Compatible… |
| POST |
get_dashakoot_v1_astro_matchmaking_dashakoot_post /v1/astro/matchmaking/dashakoot |
Computes all 10 kootas for two persons: the standard 8 Ashtakoot kootas plus Mahendra and Stree Deergha. Returns total score out of 38, per-koota breakdown, dosha analysis (Nadi,… |
| POST |
get_chart_v1_astro_chart_post /v1/astro/chart |
Generate Vedic astrological chart SVGs. Returns North Indian and South Indian style charts for both Lagna (D1) and Navamsa (D9), as SVG strings. Each planet shows abbreviation,… |
| Advanced | ||
| POST |
get_transits_v1_astro_transits_post /v1/astro/transits |
Scans a date range for planetary sign ingresses and retrograde/direct station events. Requires authenticated API key access (Vedic tier or above in product terms). Returns… |
| POST |
get_strength_report_v1_astro_strength_post /v1/astro/strength |
Builds a composite strength report including shadbala, divisional charts, ashtakavarga, and karakas from birth input. Requires authenticated API key access (Vedic tier or above… |
| POST |
ashtottari_dasha_v1_astro_ashtottari_post /v1/astro/ashtottari |
Computes Ashtottari Dasha periods for a given birth chart. **What is Ashtottari Dasha?** Ashtottari Dasha is a 108-year dasha cycle using 8 planets (excluding Ketu). It is… |
| POST |
yogini_dasha_v1_astro_yogini_post /v1/astro/yogini |
Computes Yogini Dasha periods for a given birth chart. **What is Yogini Dasha?** Yogini Dasha is a Nakshatra-based dasha system using 8 Yoginis, each ruled by a planet. The total… |
| POST |
ashtakavarga_v1_astro_ashtakavarga_post /v1/astro/ashtakavarga |
Computes the Ashtakavarga system for a given birth chart. **What is Ashtakavarga?** Ashtakavarga is a Vedic system that assigns benefic points (bindus) to each house based on the… |
| POST |
divisional_charts_v1_astro_divisional_post /v1/astro/divisional |
Computes all 16 Vedic divisional charts (Varga charts) for a given birth date, time, and location. **What are divisional charts?** In Vedic astrology, the birth chart (D1) is… |
| Numerology | ||
| GET |
get_business_name_v1_numerology_business_name_get /v1/numerology/business-name |
Scores a business name using Pythagorean expression number. Returns single digit, theme, harmony score (1-10), and recommended uses. |
| GET |
get_personal_year_number_v1_numerology_personal_year_get /v1/numerology/personal-year |
Calculates personal year influence for a given birth date and target year. Query: `date`, `year`. Requires authenticated API key access (Core tier or above in product terms).… |
| POST |
get_name_correction_v1_numerology_name_correction_post /v1/numerology/name-correction |
Analyses a full name using Pythagorean numerology and suggests spelling variants that are more harmonious with the life path number. Returns current name scores and up to 8… |
| GET |
get_number_meaning_v1_numerology_meaning__number__get /v1/numerology/meaning/{number} |
Returns interpretation details for a specific number within a numerology context. Query `context` defaults to `general` (same meanings as life path). Requires authenticated API… |
| GET |
get_mobile_number_v1_numerology_mobile_number_get /v1/numerology/mobile-number |
Analyses a mobile/phone number numerologically. Sums all digits to a single number and returns theme, harmony score, and recommended uses. |
| GET |
get_lucky_numbers_v1_numerology_lucky_numbers_get /v1/numerology/lucky-numbers |
Generates a deterministic lucky number set from `name` and `date` query params (BirthInput-aligned). Requires authenticated API key access (Core tier or above in product terms).… |
| GET |
get_vehicle_number_v1_numerology_vehicle_number_get /v1/numerology/vehicle-number |
Analyses a vehicle registration number numerologically. Extracts digits, sums to single number, returns theme and harmony score. |
| POST |
get_numerology_profile_v1_numerology_profile_post /v1/numerology/profile |
Builds a complete numerology profile from name and birth date (BirthInput-aligned: `name`, `date`). Requires authenticated API key access (Core tier or above in product terms).… |
| POST |
get_lo_shu_v1_numerology_lo_shu_post /v1/numerology/lo-shu |
Builds a Lo Shu 3x3 numerology grid from a birth date. Returns the grid with digit counts, present/missing/repeated numbers, plane analysis (thought/will/action), and per-number… |
| GET |
get_life_path_number_v1_numerology_life_path_get /v1/numerology/life-path |
Calculates the life path number for a birth date and returns interpretation details. Query: `date` (YYYY-MM-DD). Requires authenticated API key access (Core tier or above in… |
| POST |
post_personal_year_number_v1_numerology_personal_year_post /v1/numerology/personal-year |
Same calculation as GET /v1/numerology/personal-year with an MCP-friendly JSON body: `name`, `date` (YYYY-MM-DD), optional `year` (defaults to the current calendar year). |
| POST |
post_business_name_v1_numerology_business_name_post /v1/numerology/business-name |
Same analysis as GET /v1/numerology/business-name for clients that send a JSON body (e.g. MCP): `{ "name": "..." }`. |
| POST |
get_chaldean_v1_numerology_chaldean_post /v1/numerology/chaldean |
Computes a full Chaldean numerology profile. Chaldean uses a different letter-value table than Pythagorean (numbers 1-8 only; 9 is sacred). Returns name number, birth number, and… |
| POST |
get_numerology_compatibility_v1_numerology_compatibility_post /v1/numerology/compatibility |
Computes compatibility between two people from their numerology signatures. Each person uses `name` and `date` (BirthInput-aligned). Requires authenticated API key access (Core… |
| Horoscope | ||
| GET |
get_monthly_horoscope_v1_horoscope_monthly__moon_sign__get /v1/horoscope/monthly/{moon_sign} |
Returns this month's pre-generated monthly horoscope for the given Moon sign. |
Asterwise Astrology pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|