Agent Task Cheatsheet
Common tasks, each with the endpoint that answers it. Routes are shown exactly as they must be called, trailing slash included; where an endpoint takes a keys array, the keys worth asking for are listed, and asking for all of them in one call still costs one credit.
Birth chart and planets
Rising sign (lagna), tropical and sidereal in one call —
Vedic birth chart (D1): each body's sign, nakshatra, pada and house, with the ascendant —
Several divisional charts in one call (chart_name as an array) —
Navamsa (D9); the other divisional charts have their own routes —
Sidereal positions of the nine grahas, with the ayanamsa applied —
The twelve house cusps under two systems, side by side —
KP chart: cusps, signs and planets —
Shadbala (six-fold planetary strength) —
Sarvashtakavarga totals, one number per sign —
POST /api/astro/ascendant/Vedic birth chart (D1): each body's sign, nakshatra, pada and house, with the ascendant —
POST /api/astro/rashi/Several divisional charts in one call (chart_name as an array) —
POST /api/astro/chart/Navamsa (D9); the other divisional charts have their own routes —
POST /api/astro/navamsa/Sidereal positions of the nine grahas, with the ayanamsa applied —
POST /api/astro/planet-positions/The twelve house cusps under two systems, side by side —
POST /api/astro/bhava-cusps/KP chart: cusps, signs and planets —
POST /api/astro/kp-chart/Shadbala (six-fold planetary strength) —
POST /api/astro/strength/, keys shad_balaSarvashtakavarga totals, one number per sign —
POST /api/astro/sarvashtakavarga/Panchang and muhurta
The five limbs for a moment and place: tithi, vaara, nakshatra, yoga, karana —
A full panchang day, choosing only the parts you need —
The tithi in force, with its start, end and time remaining —
Sunrise and sunset —
Rahu kaal, with yamaganda and gulika —
Day and night choghadiya —
The day's favourable windows: abhijit, brahma, godhuli, nishita, vijaya, amrit kalam —
Dates for mundan, vidyarambha, upanayana, graha pravesha or deva pratishtha within a date range —
A whole month of panchang, one row per day —
POST /api/astro/panchang/A full panchang day, choosing only the parts you need —
POST /api/astro/panchanga/, keys tithi, vaara, yogam, karana, rahu_kaalam, abhijit_muhurtaThe tithi in force, with its start, end and time remaining —
POST /api/astro/tithi/Sunrise and sunset —
POST /api/astro/sunrise/Rahu kaal, with yamaganda and gulika —
POST /api/astro/rahu-kaal/Day and night choghadiya —
POST /api/astro/choghadiya/The day's favourable windows: abhijit, brahma, godhuli, nishita, vijaya, amrit kalam —
POST /api/astro/auspicious-timings/Dates for mundan, vidyarambha, upanayana, graha pravesha or deva pratishtha within a date range —
POST /api/astro/muhurat/, keys find_muhurats_in_rangeA whole month of panchang, one row per day —
POST /api/astro/monthly_panchang/Festivals and calendars
A year of festivals from the precomputed calendar —
A year of Hindu festivals calculated for a given place —
A year of fasting and observance days —
A regional calendar year (Bengali, Gujarati, Malayalam, Telugu and others have sibling routes) —
POST /api/festivals/, keys festivals, ekadashisA year of Hindu festivals calculated for a given place —
POST /api/astro/festival/, keys calculate_festivalsA year of fasting and observance days —
POST /api/vrat-upavas/, keys ekadashi, pradosham, pournami, amavasyaA regional calendar year (Bengali, Gujarati, Malayalam, Telugu and others have sibling routes) —
POST /api/astro/tamil_calendar/Dashas
Vimshottari dasha timeline, one to four levels deep —
The dasha running now (or at any moment), at every level —
Every dasha system offered, with the route that serves it —
Any rashi dasha by name, such as Chara or Narayana —
POST /api/astro/dasha/vimshottari/The dasha running now (or at any moment), at every level —
POST /api/astro/dasha/current/Every dasha system offered, with the route that serves it —
POST /api/astro/dasha/systems/Any rashi dasha by name, such as Chara or Narayana —
POST /api/astro/dasha/rashi/Yogas and doshas
Manglik, Kala Sarpa, Pitru and other doshas from a birth chart —
Whether Kala Sarpa forms, and which of its twelve forms —
Sade Sati and other Saturn phases: running now, when it ends, when the next begins —
Raja yogas in a birth chart —
POST /api/astro/dosha/, keys manglik, kala_sarpa, pitru_doshaWhether Kala Sarpa forms, and which of its twelve forms —
POST /api/astro/kalsarp/Sade Sati and other Saturn phases: running now, when it ends, when the next begins —
POST /api/astro/shani_analysis/Raja yogas in a birth chart —
POST /api/astro/raja_yoga/, keys get_raja_yoga_details_for_all_chartsMatching
Ashtakoota (gun milan) matching from two birth records —
Ashtakoota from the two birth stars and padas alone —
South Indian porutham, all twelve in one call —
POST /api/astro/horoscope-match/Ashtakoota from the two birth stars and padas alone —
POST /api/astro/ashtakoota/, keys compatibility_scoreSouth Indian porutham, all twelve in one call —
POST /api/astro/porutham/Horoscopes and readings
Today's horoscope for one sign —
Daily, weekly, monthly and yearly horoscopes for a sign in one call —
A written reading from a birth chart —
A horary chart for the moment a question is asked (Jamakkol) —
POST /api/astro/rashifal/daily/Daily, weekly, monthly and yearly horoscopes for a sign in one call —
POST /api/astro/rashifal/, keys get_daily_rashifal, get_weekly_rashifal, get_monthly_rashifal, get_yearly_rashifalA written reading from a birth chart —
POST /api/astro/general_prediction/, keys get_prediction_detailsA horary chart for the moment a question is asked (Jamakkol) —
POST /api/astro/prashna/jamakkol/Transits, returns and sky events
Where a planet is now: sign, degree, nakshatra and pada —
Every retrograde period in a year —
Varshaphal (Tajika) annual and shorter-period charts —
The exact moment of a solar return —
The next solar and lunar eclipses —
POST /api/astro/transit/details/Every retrograde period in a year —
POST /api/astro/retrograde/Varshaphal (Tajika) annual and shorter-period charts —
POST /api/astro/tajika/The exact moment of a solar return —
POST /api/astro/return/solar/The next solar and lunar eclipses —
POST /api/astro/eclipse/upcoming/Western astrology
Tropical natal chart with every aspect —
House cusps with ascendant, midheaven and vertex —
Every aspect between two people's charts —
Secondary progressions to a chosen date —
POST /api/astro/western/natal-chart/House cusps with ascendant, midheaven and vertex —
POST /api/astro/western/house-cusps/Every aspect between two people's charts —
POST /api/astro/western/synastry/Secondary progressions to a chosen date —
POST /api/astro/western/progressions/Numerology and tarot
Core numbers from a name and birth date —
The meaning of a repeating number such as 1111 —
Draw tarot cards (1 to 21), repeatable with a seed —
A named tarot spread with every position labelled —
A yes, no or maybe card for a question —
POST /api/astro/numerology/, keys life_path_number, expression_number, birthday_numberThe meaning of a repeating number such as 1111 —
POST /api/astro/numerology/angel/Draw tarot cards (1 to 21), repeatable with a seed —
POST /api/astro/tarot/draw/A named tarot spread with every position labelled —
POST /api/astro/tarot/spread/A yes, no or maybe card for a question —
POST /api/astro/tarot/yes-no/Other systems
Human Design bodygraph —
Human Design type, strategy, authority and profile —
Chinese Four Pillars (BaZi) —
Astrocartography lines to plot on a map —
POST /api/astro/human-design/chart/Human Design type, strategy, authority and profile —
POST /api/astro/human-design/properties/Chinese Four Pillars (BaZi) —
POST /api/astro/chinese/four-pillars/Astrocartography lines to plot on a map —
POST /api/astro/astrocartography/lines/Inputs, AI and reports
A place name to coordinates (address as a query parameter) —
A local birth date and time to an offset-aware timestamp for that date —
A plain-language answer to a question about a chart —
A complete Vedic horoscope as a PDF —
The next twelve months as a PDF, divided by dasha period —
GET /api/astro/geocode/A local birth date and time to an offset-aware timestamp for that date —
POST /api/astro/date_time/A plain-language answer to a question about a chart —
POST /api/astro/chat/ (25 credits per call)A complete Vedic horoscope as a PDF —
POST /api/astro/pdf/horoscope/ (25 credits per call)The next twelve months as a PDF, divided by dasha period —
POST /api/astro/pdf/yearbook/ (25 credits per call)