analysis.compatibility
Ashtakoota (8-fold) marriage compatibility analysis between two birth charts. Returns Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi scores and total points out of 36.
analysis.muhurta
Find auspicious Muhurta (electional astrology) windows for a given datetime and location. Optionally filter by event type. IMPORTANT: Use exact date/time from a system clock — incorrect dates produce wrong muhurta windows.
prediction.transits
Get current planetary transits relative to a birth chart. Returns transit positions, aspects to natal planets, and transit effects. IMPORTANT: Use the exact current date/time from a system clock for accurate transit data.
chart.vargas
Calculate divisional charts (Varga Kundalis) such as D-1 through D-60. Returns planet positions in each requested divisional chart.
analysis.shadbala
Calculate Shadbala (six-fold strength) for all planets. Returns Sthana Bala, Dig Bala, Kala Bala, Chesta Bala, Naisargika Bala, and Drik Bala.
chart.bhava_chalit
Generate Bhava Chalit chart showing house cusps and planet placement by house (as opposed to sign-based Rashi chart).
prediction.prashna
Prashna (horary) astrology analysis for a question asked at a specific time and place. IMPORTANT: The exact moment of the question is critical — use precise current date/time from a system clock, not an approximation.
prediction.varshaphal
Varshaphal (annual horoscope / Solar Return) chart for a given birth datetime and a target year.
data.festivals
Get Hindu festivals and observances for a given year, optionally filtered by month.
data.festivals_month
Get Hindu festivals and observances for a specific year and month.
analysis.kp_system
Calculate KP (Krishnamurti Paddhati) chart. Returns planet positions with star lord, sub lord, sub-sub lord, Placidus house cusps with KP divisions, and house significators following the KP four-level hierarchy. KP system divides each nakshatra into 9 unequal sub-parts based on Vimshottari Dasha proportions for precise prediction.
analysis.kp_sublord_changes
Track when a planet's KP sub-lord changes over a time range. Uses adaptive step sizes and binary search for exact crossing moments. Returns each change event with datetime, longitude, from/to sub-lord and star-lord. Useful for KP timing predictions.
analysis.kp_ingress
Find exact times when a planet enters a new rashi (sign). Steps through the time range detecting sign boundary crossings and uses binary search for precise timing. Useful for tracking major planetary transits.
analysis.kp_planets_intervals
Get all planet positions with full KP hierarchy (sign, star lord, sub lord) at regular time intervals. Useful for ephemeris tables and tracking planetary movement patterns.
data.choghadiya
Calculate Choghadiya (hourly muhurta divisions) and Hora (planetary hours) for a given datetime and location. Choghadiya divides day and night into 8 auspicious/inauspicious periods each. Hora assigns a planetary ruler to each hour from sunrise following the Chaldean order. IMPORTANT: Use the exact current date/time from a system clock.
analysis.pancha_pakshi
Calculate Pancha Pakshi (Five Birds System) — ancient Tamil timing system based on 5 birds: Vulture (Earth), Owl (Water), Crow (Fire), Cock (Air), Peacock (Ether). Returns current active bird and activity, day/night period breakdown with sub-activities. Optionally provide birth_nakshatra (1-27) and is_shukla_paksha for personalized birth bird analysis and best timing. IMPORTANT: Use exact date/time from a system clock.
data.vrata
Get Vrata (religious observance) calendar for a given year. Returns Ekadashi dates, Sankranti, Navaratri, Pradosh Vrat, Chaturthi, Purnima, Amavasya, and other important fasting/observance days with astronomical basis and recommended rituals.
data.vrata_month
Get Vrata (religious observance) calendar for a specific year and month. Returns Ekadashi, Sankranti, Pradosh Vrat, Chaturthi, Purnima, Amavasya, and other fasting/observance days for the given month.
analysis.remedies
Get planetary remedies based on a birth chart. Returns personalized recommendations including mantras, gemstones, fasting days, charity suggestions, and ritual prescriptions for afflicted or weak planets. Analyzes planetary strengths, afflictions, and Dasha periods to prioritize remedies.
analysis.aspects
Calculate planetary aspects (Graha Drishti and Rashi Drishti). Returns Parashari house-based aspects with strength percentages (25/50/75/100%), Jaimini sign-based Rashi Drishti, and mutual aspect detection. Special aspects: Mars (4th/8th at 100%), Jupiter (5th/9th at 100%), Saturn (3rd/10th at 100%). IMPORTANT: Use exact date/time from a system clock.
data.upagrahas
Calculate all 11 Upagrahas (sub-planets). Sun-based (5): Dhuma, Vyatipata, Parivesha, Indrachapa, Upaketu — derived from Sun longitude. Time-based (6): Gulika, Mandi, Kaala, Mrityu, Ardhaprahara, Yamaghantaka — derived from sunrise and weekday. Each returns longitude, sign, and nakshatra. IMPORTANT: Use exact date/time from a system clock.
prediction.monthly_transits
Get all planetary sign changes (ingress) and retrograde start/end events during a month. Tracks all 9 Vedic planets for sign changes, and Mercury/Venus/Mars/Jupiter/Saturn for retrograde direction changes. Binary-searches for exact event times. IMPORTANT: Use exact year/month values.
analysis.monthly_aspects
Get major aspect formations between planets during a month. Detects conjunction (0 deg), sextile (60 deg), square (90 deg), trine (120 deg), and opposition (180 deg) for all planet pairs excluding Moon. Returns exact times and orb values.
analysis.lunar_aspects
Get Moon's aspects to all planets over a given number of days. Moon moves ~13 deg/day forming frequent aspects. Returns aspect type, exact time, orb, and Moon's sign at each aspect. IMPORTANT: Use exact date/time from a system clock.
account.webhook_subscribe
Subscribe to astrological event notifications via webhook. Your URL receives a POST when the event occurs. Costs 1 credit per subscription, deliveries are free. Supported events: ekadashi (11th tithi), purnima (full moon), amavasya (new moon), sankranti (sun entering new sign), saturn_sign_change, jupiter_sign_change, mercury_retrograde_start, mercury_retrograde_end, eclipse_solar, eclipse_lunar. Webhook payload includes event type, event data, and subscriber location if provided. Verify authenticity via X-Webhook-Signature header (HMAC-SHA256 of body using subscription_id as key).
account.register
Register for an API key to access PanchangaAPI. Three registration flows: (1) Anonymous: call with empty body {} for instant api_key (only when x402 USDC payments enabled), 2 free requests/day, 1 registration per IP/day. (2) Email: call with {"email": "
[email protected]"} — returns pending status + account_id + polling info. Email arrives with HTML button (for humans) and 6-digit PIN (for agents). Human path: clicks button -> sees HTML page with api_key and message 'Send this key to your AI agent'. Agent with email access: reads PIN -> POST /verify {"email": "...", "code": "123456"} -> gets api_key. Agent without email access: polls GET /register/status/{account_id} every 5s for up to 5min -> gets api_key when user clicks button. (3) Telegram: call with {"telegram_id": 123456789} — returns pending status + verify_url + polling info. Agent sends verify_url to user via Telegram. User clicks -> @vastr_bot verifies -> api_key in chat. Agent polls GET /register/status/{account_id} every 5s to get api_key. Alternatively POST /verify {"telegram_id": 123, "code": "1234"} to verify via API. Admin receives Telegram notification on every registration and verification.