Rulebook
Astrology API rulebook
Updated
What the rule kinds mean
- classical 123 rules
- from the classical texts, where the major traditions agree
- school 284 rules
- traditions differ here, and the API follows one stated choice
- invention 59 rules
- a rule the API adds where the texts give no method, so its answers stay consistent
- gap 14 rules
- something the API does not compute, named so no one assumes it does
CH Chart fundamentals 19
The basics every other rule rests on. They cover which planet rules each sign and where each planet is strong or weak. They also cover how houses are counted, and when a planet is combust or retrograde.
- CH-01classicalSign lordshipEach zodiac sign is ruled by one planet, following the classical Parashari table. Rahu and Ketu rule no sign.
- CH-02schoolExaltation signsA planet in its exaltation sign is at its strongest. The whole sign counts, except for the Moon and Mercury, which are exalted only in the first degrees of that sign.
- CH-03schoolDebilitation signsA planet in its debilitation sign, the sign opposite its exaltation, is at its weakest. The whole sign counts.
- CH-04classicalMulatrikona signsMulatrikona is a planet's favored stretch of one sign, given as a range of degrees. Past that range, the rest of the sign counts as the planet's own sign. Rahu and Ketu have no mulatrikona.
- CH-05schoolWhich dignity wins when two applyWhen a planet qualifies for more than one dignity, the API reports one, in this order: exalted, debilitated, mulatrikona, own sign, then neutral. For mulatrikona and own sign, the planet's degree decides.
- CH-06schoolHouses are whole-sign, counted from the ascendantHouses are whole-sign houses. The rising sign is house 1 in full, the next sign is house 2, and so on around the zodiac. Every reading uses these houses. The one other house table is the bhava chalit (CH-15), which is shown beside them and changes nothing else.
- CH-07schoolCombustion (astangata) orbsA planet close enough to the Sun is combust (asta), which weakens it. Each planet has its own distance in degrees, and the separation is measured along the zodiac only.
- CH-09classicalYogakarakaA yogakaraka is a single planet that rules both a kendra and a trikona for the rising sign. The kendras here are houses 4, 7 and 10, and the trikonas houses 5 and 9. It counts as especially helpful in that chart.
- CH-10schoolRetrogression, and the nodesA planet that appears to move backward is retrograde. Rahu and Ketu are always reported as retrograde, as tradition treats them, while the speed field still gives their real motion.
- CH-11classicalThe nine grahas, and nothing elseThe API uses the nine classical planets (grahas): the Sun, the Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu and Ketu. Uranus, Neptune and Pluto are not used.
- CH-12schoolSeven dignity states, and the friendship behind themA planet's dignity is one of seven states: exalted, debilitated, mulatrikona, own sign, friend's sign, enemy's sign or neutral. The API reports the strongest one that applies. Friend's sign and enemy's sign look at how well the planet gets along with the sign's ruler right now, combining their natural bond with where each one currently stands. Two planets that are natural friends can still read as neutral here if they are not well placed from each other at this moment.
- CH-13schoolFive house classesHouses fall into five classes: kendras, trikonas, dusthanas, upachayas and marakas. The first three describe strength. The last two are read differently.
- CH-14schoolNatural benefics and maleficsJupiter and Venus are always natural benefics (helpful planets). The Sun, Mars, Saturn, Rahu and Ketu are always natural malefics (harsh planets). The Moon and Mercury depend on the chart: the Moon on its phase, and Mercury on the planets it sits with.
- CH-15schoolBhava chalitThe bhava chalit measures houses from the exact rising degree and the degree overhead at birth, using the Sripati method. The rising degree is the middle of house 1. Each house begins halfway between two house middles. So a planet near the edge of a sign can fall in the next or previous house.
- CH-16schoolThe chalit sits beside the birth chartThe API shows each planet's chalit house next to its usual house and marks the planets that move. It does not change any reading, yoga or strength, because traditions differ on how a moved planet should be read.
- CH-17classicalPushkara navamsaEach sign has two helpful ninths, called pushkara navamsas. Which two depends on the sign's element: fire, earth, air or water. The API marks any planet that sits in one.
- CH-18schoolPushkara bhagaEach sign also has one helpful degree, the pushkara bhaga. Two lists of these degrees are in use, and they differ for eight signs. The API checks both lists and counts a planet within 1 degree of the listed degree. It says when the two lists give different answers.
- CH-19schoolPlanetary warWhen two of Mars, Mercury, Jupiter, Venus and Saturn are within 1 degree of each other, they are at war (graha yuddha). The API names the winner as the planet further north in the sky. It also names the brighter planet, since some readers use brightness instead, and says when the two answers differ.
- CH-20classicalSudarshana chakraThe sudarshana chakra reads the chart three times. Each time, house 1 starts from a different place: the rising sign, the Moon's sign and the Sun's sign. The planets stay in the same signs. Only the house numbers change.
YG Yogas 104
Named planetary combinations the API looks for in a birth chart. Each yoga it finds, and each one it checked and did not find, comes back with the rule it tested.
- YG-01schoolRuchakaRuchaka yoga is one of the five pancha mahapurusha yogas. It forms when Mars is in its own or exaltation sign, and in a kendra (house 1, 4, 7 or 10).
- YG-02schoolBhadraBhadra yoga is one of the five pancha mahapurusha yogas. It forms when Mercury is in its own or exaltation sign, and in a kendra (house 1, 4, 7 or 10).
- YG-03schoolHamsaHamsa yoga is one of the five pancha mahapurusha yogas. It forms when Jupiter is in its own or exaltation sign, and in a kendra (house 1, 4, 7 or 10).
- YG-04schoolMalavyaMalavya yoga is one of the five pancha mahapurusha yogas. It forms when Venus is in its own or exaltation sign, and in a kendra (house 1, 4, 7 or 10).
- YG-05schoolSasaSasa yoga is one of the five pancha mahapurusha yogas. It forms when Saturn is in its own or exaltation sign, and in a kendra (house 1, 4, 7 or 10).
- YG-06schoolHarshaHarsha yoga, a vipareeta raja yoga: the ruler of house 6 sits in house 6, 8 or 12, with no helpful planet or ruler of a pillar or lucky house touching it, and the ruler of the ascendant stronger than it. Tradition reads it as difficulty that turns out well.
- YG-07schoolSaralaSarala yoga, a vipareeta raja yoga: the ruler of house 8 sits in house 6, 8 or 12, with the same two extra conditions as Harsha yoga.
- YG-08schoolVimalaVimala yoga, a vipareeta raja yoga: the ruler of house 12 sits in house 6, 8 or 12, with the same two extra conditions as Harsha yoga.
- YG-09schoolBudhadityaBudhaditya yoga: the Sun and Mercury in the same sign. Ruled out within 3 degrees of an exact pairing, in house 6, 8 or 12, or when a shadow planet or Saturn looks at it.
- YG-10schoolChandra-MangalaChandra-Mangala yoga: the Moon and Mars in the same sign. Tradition links it to earning power.
- YG-11schoolGuru-MangalaGuru-Mangala yoga: Jupiter and Mars in the same sign.
- YG-12schoolGajakesariGajakesari yoga: Jupiter in a kendra counted from the Moon, meaning 1, 4, 7 or 10 signs from it. The count starts from the Moon, not from the rising sign. Ruled out if Jupiter is weak, too close to the Sun, or sitting with a shadow planet, if the Moon is at the new moon point, or if either planet sits in house 6, 8 or 12.
- YG-13schoolDharma-KarmadhipatiDharma-karmadhipati yoga: the rulers of house 9 and house 10 are linked, by sitting together, by aspect, or by exchanging signs.
- YG-14schoolDharma-Karmadhipati (partial)The partial form of dharma-karmadhipati yoga: one of the two rulers sits in the other's house, without a full exchange of signs.
- YG-15schoolKemadrumaKemadruma yoga: no planet other than the Sun, Rahu or Ketu stands next to the Moon or in a kendra from it. The API also reports when this is cancelled.
- YG-16schoolNeecha BhangaNeecha bhanga: a weak (debilitated) planet has its weakness cancelled. Any one of five checks is enough. The ruler of its sign, or the ruler of the sign where it is strongest, sits in a pillar house (1, 4, 7 or 10) from the ascendant or the Moon. The ruler of its sign sits with it or looks at it. The planet strongest in that sign sits with it. The two rulers sit in pillar houses from each other. Or both rulers sit in house 1, 5 or 9.
- YG-17schoolMaha ParivartanaMaha Parivartana yoga: two planets each sit in the sign the other rules, an exchange of signs that links them, where both houses exchanged are among the strong or lucky ones (house 1, 2, 4, 5, 7, 9, 10 or 11).
- YG-18schoolSunaphaSunapha yoga: a planet other than the Sun, Rahu or Ketu in the sign after the Moon.
- YG-19schoolAnaphaAnapha yoga: a planet other than the Sun, Rahu or Ketu in the sign before the Moon.
- YG-20schoolDurudharaDurudhara yoga: planets other than the Sun, Rahu or Ketu on both sides of the Moon.
- YG-21schoolVesiVesi yoga: a planet other than the Moon, Rahu or Ketu in the sign after the Sun.
- YG-22schoolVasiVasi yoga: a planet other than the Moon, Rahu or Ketu in the sign before the Sun.
- YG-23schoolUbhayachariUbhayachari yoga: planets other than the Moon, Rahu or Ketu on both sides of the Sun.
- YG-24schoolVasumathiVasumathi yoga: every benefic (helpful planet) sits in house 3, 6, 10 or 11, counted from the rising sign or from the Moon. Tradition links it to steady wealth.
- YG-25schoolAdhiAdhi yoga: benefics (helpful planets) in the 6th, 7th and 8th signs from the Moon.
- YG-26schoolParvataParvata yoga: benefics (helpful planets) in the kendras, with houses 6 and 8 empty or holding only benefics.
- YG-27schoolSaraswatiSaraswati yoga: Jupiter, Venus and Mercury each sit in a kendra, a trikona or house 2. Jupiter is also in its own sign, its exaltation sign or a friend's sign.
- YG-28schoolDaridraDaridra yoga: the ruler of house 11, the house of gains, sits in house 6, 8 or 12.
- YG-29schoolAputraAputra yoga: the ruler of house 5, the house of children, sits in house 6, 8 or 12.
- YG-30schoolRajaRaj yoga: the ruler of a kendra (house 4, 7 or 10) and the ruler of a trikona (house 5 or 9) are linked. They sit together, exchange signs, or aspect each other. Ruled out if one of the two also rules house 6, 8 or 12, or is weak or too close to the Sun.
- YG-31schoolGrahanGrahan yoga: the Sun or the Moon shares a sign with Rahu or Ketu, the two points linked to eclipses.
- YG-32schoolPravrajyaPravrajya yoga: four or more planets in one sign. Tradition links it to a pull toward giving up worldly life.
- YG-33schoolRajjuRajju yoga, a nabhasa yoga: all seven planets from the Sun to Saturn in movable signs.
- YG-34schoolMusalaMusala yoga, a nabhasa yoga: all seven planets in fixed signs.
- YG-35schoolNalaNala yoga, a nabhasa yoga: all seven planets in dual signs.
- YG-36schoolMalaMala yoga, a nabhasa yoga: benefics (helpful planets) in three kendras and no malefic (harsh planet) in any kendra.
- YG-37schoolSarpaSarpa yoga, a nabhasa yoga: malefics (harsh planets) in three kendras and no benefic (helpful planet) in any kendra.
- YG-38schoolGadaGada yoga, a nabhasa yoga: the seven planets fill two neighboring kendras and no other house.
- YG-39schoolSakataSakata yoga, a nabhasa yoga: the seven planets fill houses 1 and 7 and no other house.
- YG-40schoolVihagaVihaga yoga, a nabhasa yoga: the seven planets fill houses 4 and 10 and no other house.
- YG-41schoolShringatakaShringataka yoga, a nabhasa yoga: the seven planets fill houses 1, 5 and 9 and no other house.
- YG-42schoolHalaHala yoga, a nabhasa yoga: the seven planets fill one set of three trine houses other than the rising sign's, and no other house.
- YG-43schoolVajraVajra yoga, a nabhasa yoga: benefics (helpful planets) in houses 1 and 7, and malefics (harsh planets) in houses 4 and 10.
- YG-44schoolYavaYava yoga, a nabhasa yoga: malefics (harsh planets) in houses 1 and 7, and benefics (helpful planets) in houses 4 and 10.
- YG-45schoolKamalaKamala yoga, a nabhasa yoga: the seven planets fill all four kendras and no other house.
- YG-46schoolVapiVapi yoga, a nabhasa yoga: the seven planets fill the four houses after the kendras (2, 5, 8 and 11) and no other house.
- YG-47schoolYupaYupa yoga, a nabhasa yoga: the seven planets fill houses 1 to 4, at least one in each.
- YG-48schoolSharaShara yoga, a nabhasa yoga: the seven planets fill houses 4 to 7, at least one in each.
- YG-49schoolShaktiShakti yoga, a nabhasa yoga: the seven planets fill houses 7 to 10, at least one in each.
- YG-50schoolDandaDanda yoga, a nabhasa yoga: the seven planets fill houses 10, 11, 12 and 1, at least one in each.
- YG-51schoolNaukaNauka yoga, a nabhasa yoga: the seven planets fill houses 1 to 7, at least one in each.
- YG-52schoolKutaKuta yoga, a nabhasa yoga: the seven planets fill houses 4 to 10, at least one in each.
- YG-53schoolChhatraChhatra yoga, a nabhasa yoga: the seven planets fill houses 7 to 1, at least one in each.
- YG-54schoolChapaChapa yoga, a nabhasa yoga: the seven planets fill houses 10 to 4, at least one in each.
- YG-55schoolArdha ChandraArdha Chandra yoga, a nabhasa yoga: the seven planets fill seven houses in a row that start somewhere other than a kendra.
- YG-56schoolChakraChakra yoga, a nabhasa yoga: the seven planets fill the six alternate houses starting from house 1.
- YG-57schoolSamudraSamudra yoga, a nabhasa yoga: the seven planets fill the six alternate houses starting from house 2.
- YG-58schoolVallakiVallaki yoga, a nabhasa yoga: the seven planets are spread over seven different signs.
- YG-59schoolDamaDama yoga, a nabhasa yoga: the seven planets are spread over six signs.
- YG-60schoolPashaPasha yoga, a nabhasa yoga: the seven planets are spread over five signs.
- YG-61schoolKedaraKedara yoga, a nabhasa yoga: the seven planets are spread over four signs.
- YG-62schoolShulaShula yoga, a nabhasa yoga: the seven planets are spread over three signs.
- YG-63schoolYugaYuga yoga, a nabhasa yoga: the seven planets are spread over two signs.
- YG-64schoolGolaGola yoga, a nabhasa yoga: all seven planets are in one sign.
- YG-65schoolDhana (5th house)Dhana yoga: the ruler of house 5 sits there in its own sign, with a supporting planet in house 11. It shows money coming from your own ideas and judgment.
- YG-66schoolDhana (lagna)Dhana yoga: the ruler of house 1 sits there in its own sign, joined or aspected by a supporting planet. It shows money following your own effort.
- YG-67schoolBhratrumoola DhanapraptiBhratrumoola Dhanaprapti yoga: the rulers of houses 1 and 2 sit in house 3. Or the ruler of house 3 sits in house 2 with Jupiter. Money through siblings, friends and colleagues.
- YG-68schoolPutramooladhanaPutramooladhana yoga: the ruler of house 2 sits with the ruler of house 5 or with Jupiter. Money connected with children.
- YG-69schoolSatrumooladhanaSatrumooladhana yoga: the ruler of house 2 sits with the ruler of house 6 or with Mars. Money that comes out of competition and disputes.
- YG-70schoolKalatramooladhanaKalatramooladhana yoga: the ruler of house 2 is joined or aspected by the ruler of house 7 or by Venus. Money through a spouse or a partner.
- YG-71schoolAyatnadhanalabhaAyatnadhanalabha yoga: the rulers of houses 1 and 2 sit in each other's signs. Money that comes with less struggle.
- YG-72schoolDaridra (1st and 6th exchange)Daridra yoga, one of its forms: the rulers of houses 1 and 6 sit in each other's signs. Debts that tend to follow a person.
- YG-73schoolDaridra (5th and 9th lords)Daridra yoga, one of its forms: the ruler of house 5 sits in house 6 and the ruler of house 9 in house 12. Luck that does not easily turn into money.
- YG-74schoolDaridra (Mars and Saturn in the 2nd)Daridra yoga, one of its forms: Mars and Saturn sit together in house 2, the house of savings and family.
- YG-75schoolDaridra (Sun in the 2nd)Daridra yoga, one of its forms: the Sun sits in house 2 and Saturn aspects it. Savings that build slowly.
- YG-76schoolEkaputraEkaputra yoga: the ruler of house 5, the house of children, sits in a kendra or a trikona. The API does not claim a number of children.
- YG-77schoolSatputraSatputra yoga: Jupiter rules house 5 and the Sun is neither debilitated nor in house 6, 8 or 12.
- YG-78schoolKalanirdesat PutraKalanirdesat Putra yoga: Jupiter in house 5 with the ruler of house 5 joined by Venus. Or Jupiter in house 9, with Venus and the ruler of house 1 together in house 5.
- YG-79schoolKalanirdesat PutranasaKalanirdesat Putranasa yoga: a malefic (harsh) planet in house 5 and another in the fifth sign counted from Jupiter. No benefic (helpful planet) sits in house 5 or aspects it. Read as children needing extra care.
- YG-80schoolTheevrabuddhiTheevrabuddhi yoga: the ruler of house 5 is a benefic (helpful planet). The lord of its sign in the navamsa chart is aspected by a benefic. A quick, able mind.
- YG-81schoolSodaranasaSodaranasa yoga: Mars and the ruler of house 3, the house of siblings, sit together in house 3, 5, 7 or 8. Read as strain between siblings, and marked sensitive.
- YG-82schoolSatkalatraSatkalatra yoga: the ruler of house 7, or Venus, is joined or aspected by Jupiter or Mercury. A caring spouse and a steady home.
- YG-83schoolJaraJara yoga: house 10 holds the ruler of house 10, 2 or 7. Read as relationships taking more than one turn, and marked sensitive.
- YG-84schoolBharyasahavyabhicharyaBharyasahavyabhicharya yoga: Venus, Saturn, Mars and the Moon all sit in house 7. Very rare. Read as trust in marriage needing work, and marked sensitive.
- YG-85schoolMookaMooka yoga: the ruler of house 2, the house of speech, sits in house 8 with Jupiter. Speaking up may not come easily.
- YG-86schoolNishturabhashiNishturabhashi yoga: Saturn and the Moon sit together, or Saturn aspects the Moon. Words that can come out sharper than meant.
- YG-87schoolKushtarogaKushtaroga yoga: the ruler of house 1 sits in house 4 or 12 with Mars or Mercury. Or Jupiter, Saturn and the Moon sit together in house 6. Read as the skin needing care, and marked sensitive.
- YG-88schoolBandhanaBandhana yoga: the rulers of houses 1 and 6 sit together in a kendra or a trikona with Saturn, Rahu or Ketu. Read as care with legal matters, and marked sensitive.
- YG-89schoolAdhamaAdhama yoga: the Moon sits in the same sign as the Sun or 4, 7 or 10 signs from it. One of three yogas read from the Moon's distance from the Sun, and every chart has exactly one. Read as good things coming through steady effort.
- YG-90schoolSamaSama yoga: the Moon sits 2, 5, 8 or 11 signs from the Sun. The middle of the three, read as a fair share of comfort and learning.
- YG-91schoolVarishthaVarishtha yoga: the Moon sits 3, 6, 9 or 12 signs from the Sun. The easiest of the three, read as comfort and learning coming more readily.
- YG-92schoolKahalaKahala yoga: the rulers of houses 4 and 9 sit in angles from each other, and the ruler of house 1 is strong. Strong means it is in its own or exaltation sign, or in house 1, 4, 5, 7, 9 or 10. It must also not be in its weakest sign or hidden by the Sun. Courage, drive and property.
- YG-93schoolChamaraChamara yoga: the ruler of house 1 is exalted in an angle and Jupiter aspects it. Or two helpful planets sit together in house 1, 7, 9 or 10. Respect earned through skill and good speech.
- YG-94schoolShankhaShankha yoga: the rulers of houses 5 and 6 sit in angles from each other, with a strong ruler of house 1. Or the rulers of houses 1 and 10 both sit in movable signs, with a strong ruler of house 9. Strength is judged as in Kahala. A kind, fair and fortunate life.
- YG-95schoolMaharajaMaharaja yoga: the rulers of houses 1 and 5 swap places. Also, the planets that stand for the self and for children both sit in house 1 or 5. Each is in its own or exaltation sign or own navamsa, with a helpful planet aspecting it. Very rare. Wide recognition.
- YG-96schoolKalanidhiKalanidhi yoga: Jupiter sits in house 2 or 5. It is joined or aspected by both Mercury and Venus, or sits in a sign they rule. A love of learning and the arts.
- YG-97schoolRahu-Ketu RajaRahu-Ketu raja yoga: Rahu or Ketu sits in an angle, with the ruler of house 5 or 9 joined or aspecting it. Or it sits in house 1, 5 or 9, with the ruler of house 4, 7 or 10 joined or aspecting it. The ruler of house 1 does not count. A rise that may come by an unusual path. Two other yogas that outside reports use are not checked. Karmajiva describes a line of work rather than forming. A Moon-navamsa raja yoga forms in about three charts in four.
- YG-98schoolPapa KartariPapa kartari yoga: hard planets sit in both house 12 and house 2, with no helpful planet beside them. The Moon counts as hard when waning, and Mercury when it sits with a hard planet. Only planets sitting in those houses count. A planet that only looks at house 1 from elsewhere never forms it. The same check runs for the Moon and for every house and planet (KT-01). Effort meets pushback, and steady habits help.
- YG-99schoolShubha KartariShubha kartari yoga: helpful planets sit in both house 12 and house 2, with no hard planet beside them. The Moon counts as helpful when waxing, and Mercury when it sits with no hard planet. Only planets sitting in those houses count, never a planet that only looks at house 1. The same check runs for the Moon and for every house and planet (KT-01). Support around you and easier starts.
- YG-100schoolPapa Kartari (Moon)Papa kartari of the Moon: hard planets sit in the signs on both sides of the Moon, with no helpful planet beside them. Hard planets here are Mars, Saturn, the Sun, Rahu and Ketu. Only planets sitting there count, never aspects. It comes with Durudhara yoga (YG-20), unless one side holds only the Sun, Rahu or Ketu. The mind may carry more pressure, and a steady routine helps.
- YG-101schoolShubha Kartari (Moon)Shubha kartari of the Moon: helpful planets sit in the signs on both sides of the Moon, with no hard planet beside them. Only planets sitting there count, never aspects. Every chart with it also has Durudhara yoga (YG-20). A calmer mind and good company.
- YG-102schoolNeecha Bhanga RajaNeecha bhanga raja yoga: a weak planet whose weakness is cancelled, and that sits in house 1, 4, 5, 7, 9 or 10. The ruler of the ascendant must not be weak or too close to the Sun. In any other house (2, 3, 6, 8, 11 or 12) the weakness is still cancelled, but this yoga does not form.
- YG-103schoolKhala YogaKhala Yoga: two planets each sit in the sign the other rules, where one of the two houses exchanged is house 3 and neither is house 6, 8 or 12.
- YG-104schoolDainya YogaDainya Yoga: two planets each sit in the sign the other rules, where one of the two houses exchanged is house 6, 8 or 12.
KT Kartari: hemmed in 1
Kartari means "hemmed in". This checks every house and every planet for hard or helpful planets on both sides.
DO Doshas 5
The three doshas the API checks: manglik, kaal sarp and pitra. Each has competing definitions, so every result states the rule it used and the placements that decided it.
- DO-01schoolManglik (kuja) doshaManglik dosha: Mars in house 1, 2, 4, 7, 8 or 12. The houses are counted three separate ways, from the rising sign, from the Moon and from Venus, and each count is reported. The present field in the response is true if any count finds it. The plain answer is stricter, as DO-05 explains: a find from Venus alone is only partial.
- DO-02schoolManglik cancellationsThe API checks four classical exceptions to manglik dosha and lists any it finds. It never applies them, because astrologers disagree about which exceptions count.
- DO-03schoolKaal sarp doshKaal sarp dosh: all seven planets from the Sun to Saturn sit on one side of the line from Rahu to Ketu. A planet within 1 degree of that line marks the result as partial, because schools disagree on whether that breaks the dosha.
- DO-04schoolPitra doshPitra dosh: the Sun, Rahu or Ketu afflicts (harms) the 9th house or its ruler. Or the ruler of the 9th house sits in house 6, 8 or 12.
- DO-05schoolManglik: the lagna and the Moon decide the answerThe plain answer for manglik is decided by the counts from the rising sign and from the Moon. If either finds Mars in house 1, 2, 4, 7, 8 or 12, the answer says manglik and names which one found it. If only the count from Venus finds it, the answer says "Partial Manglik Dosha", a milder sign, and does not say plainly yes.
VG Divisional charts 6
The 16 divisional charts (vargas), from D1 to D60. Each splits every sign into parts and gives each part a sign. The schools differ most on where the counting starts.
- VG-01classicalThe sixteen divisions computedThe API works out 16 divisional charts. Most split each sign into equal parts and map each part to a sign. D2 and D30 use their own unequal rules.
- VG-02schoolWhere each division starts countingFor each equal-part divisional chart, this rule gives the sign the first part maps to. The other parts follow in order from there.
- VG-03schoolThe step between partsMost divisional charts move forward one sign per part. This rule names the two that do not.
- VG-04schoolWorked example: the D9 navamsaThe navamsa (D9) counts from the sign itself for a movable sign and from the 9th sign for a fixed sign. For a dual sign it counts from the 5th sign. This rule shows the result for the first signs as a worked example.
- VG-05schoolD2 HoraThe hora chart (D2) splits each sign into two halves of 15 degrees. Odd signs give Leo then Cancer, and even signs give Cancer then Leo, so only those two signs appear in it.
- VG-06schoolD30 TrimsamsaThe trimsamsa (D30) splits each sign into five unequal parts, each ruled by a planet's sign. The Sun, the Moon, Rahu and Ketu never rule a trimsamsa part.
AS Aspects (graha drishti) 7
Aspects (graha drishti): which houses each planet looks at from where it sits. They are counted in whole houses.
- AS-01schoolAspects are counted in whole houses, not degreesAspects are counted in whole houses, not in degrees. A planet aspects a whole house from the house it sits in, with no orb (allowed margin in degrees) and no partial strength.
- AS-02classicalCounting is inclusive of the occupied houseThe count includes the house the planet sits in, so a planet in house 1 aspects house 7 with its 7th aspect.
- AS-03classicalWhich houses each graha aspectsEvery planet aspects the 7th house from itself. Mars also aspects the 4th and 8th, Jupiter the 5th and 9th, and Saturn the 3rd and 10th.
- AS-04classicalWorked example: the three special aspectsA worked example of the three special aspects from every house, including how the count wraps past house 12.
- AS-05schoolThe nodes aspect, and that is disputedThe API gives Rahu and Ketu aspects on the 5th, 7th and 9th houses. Schools disagree on this, so POST /v1/aspects takes nodes=false to leave them out.
- AS-06schoolThe ascendant does not aspectThe rising sign (lagna) casts no aspect. Houses, including house 1, can still receive aspects from planets.
- AS-07schoolWhat aspects are now used forAspects are used in the API's yoga checks, such as dharma-karmadhipati yoga and the cancellation of a debilitated planet's weakness.
DA Vimshottari dasha 4
Vimshottari dasha, the 120-year cycle of planetary periods. It covers the order of the periods, which one runs first, and how much of it was already over at birth.
- DA-01classicalVimshottari sequence and period lengthsVimshottari has nine periods in a fixed order, 120 years in all. They are Ketu 7 years, Venus 20, the Sun 6, the Moon 10, Mars 7, Rahu 18, Jupiter 16, Saturn 19 and Mercury 17.
- DA-02classicalWhich lord runs firstThe ruler of the Moon's nakshatra at birth runs the first period.
- DA-03classicalThe balance at birth is measured by timeHow much of the first period was already over at birth is measured by time: how long the Moon had been in its birth nakshatra, out of the whole time it takes to cross it. This is the classical method. Measuring by distance instead is a common software shortcut; it can move the dates by days, up to about a month, and it is available on request. Both numbers are always given.
- DA-04classicalSub-period constructionEach period splits into sub-periods in the same order, starting with the period's own planet. Each sub-period gets the parent period's length times its planet's share of the 120 years. The API goes five levels deep.
AV Ashtakavarga 8
Ashtakavarga, a point system that scores how much support each sign gives each planet, from 0 to 8 points (bindus).
- AV-01classicalEight contributors, seven tablesThere are eight contributors: the seven planets from the Sun to Saturn, and the rising sign. Each gives a point to certain signs, counted from where the contributor sits. This is done for each of the seven planets.
- AV-02classicalThe 337-point checkIn every chart, the seven tables hold exactly 337 points between them. The API checks this on every request, which catches any error in its tables.
- AV-03schoolTrikona shodhanaTrikona shodhana, a classical reduction across each set of trine signs. The lowest of the three is taken from all three. A set with one empty sign is left as it is. The API works it out and returns it, but does not apply it (see AV-04).
- AV-04schoolEkadhipatya shodhana, and why neither reduction is appliedEkadhipatya shodhana is the second classical reduction, for pairs of signs with the same ruler. What happens depends on whether each sign holds a planet or the rising sign. The texts differ on whether either reduction should be applied before a chart is read, so the API returns both and applies neither.
- AV-05inventionThe strength bands are the API's ownThe classical texts give point counts but no grading. The strong and weak labels in the API's readings are the API's own bands, and they are stated as such.
- AV-06inventionBindus are reported beside a transit, never folded inEvery transit comes with the points its planet's own table gives the sign it is passing through. The points are shown beside the transit result and never change it.
- AV-07classicalThe rising sign has its own tableThe rising sign gets a table of its own from the same eight contributors. It always holds 49 points, which the API checks on every request, and it is kept separate from the 337.
- AV-08schoolPindasPindas weight each reduced table. Each sign's points are multiplied by a figure for that sign. The points in each planet's sign are multiplied by a figure for that planet, and the two are added. The API returns them for every planet and the rising sign but does not apply them. They match two desktop programs on every table of the charts checked. Some books give Virgo a figure of 5 where these programs use 6, and the API names that difference.
TR Transits (gochar) 10
Transits (gochar): where the planets are now, counted from the birth Moon, with the classical results and the vedha rule that can block them.
- TR-01schoolGochar is counted from the birth MoonTransits are counted from the birth Moon's sign, not from the rising sign, because that is how the classical result tables are set up. POST /v1/transits and the love, career and wealth forecasts also give the house counted from the rising sign, for readers who use it. POST /v1/transits/forecast gives the house from the birth Moon only.
- TR-02schoolWhich houses each planet is favorable inEach planet gives a good result from certain houses counted from the birth Moon and a difficult one from all the others. There is no neutral result.
- TR-03schoolWhich house blocks each good transitVedha: a good transit is blocked when another transiting planet sits in the house that blocks it. The response names the blocking planet. Houses count from the birth Moon, and "3 by 9" means a good transit of the 3rd house is blocked by a planet in the 9th. Sun: 3 by 9, 6 by 12, 10 by 4, 11 by 5. Moon: 1 by 5, 3 by 9, 6 by 12, 7 by 2, 10 by 4, 11 by 8. Mars: 3 by 12, 6 by 9, 11 by 5. Mercury: 2 by 5, 4 by 3, 6 by 9, 8 by 1, 10 by 7, 11 by 12. Jupiter: 2 by 12, 5 by 4, 7 by 3, 9 by 10, 11 by 8. Venus: 1 by 8, 2 by 7, 3 by 1, 4 by 10, 5 by 9, 8 by 5, 9 by 11, 11 by 6, 12 by 3. Saturn: 3 by 12, 6 by 9, 11 by 5. Texts differ over some of these pairs. This is the table the API uses.
- TR-04classicalTwo pairs that never obstruct each otherTwo pairs never block each other: Saturn and the Sun, and Mercury and the Moon.
- TR-05schoolThe nodes have results but no vedhaRahu and Ketu give good results from houses 3, 6, 10 and 11. The classical sources give them no vedha, so a good transit of Rahu or Ketu is never blocked.
- TR-06classicalHow a transit date is foundTransit dates are found by scanning each planet's motion, so every sign change is caught. That includes a planet turning retrograde and briefly moving back into the previous sign.
- TR-07inventionVedha is not applied to a future periodA forecast over a period gives the classical result without vedha. Only a transit read for a single moment applies vedha, because the blocking planets move many times during a long period. A planet that changes house more than 14 times in the date range is left out and named. The love, career and wealth forecasts never leave out the planets that stand for their theme (karakas), so the love forecast always has Venus.
- TR-08gapWhat transits are not judged byThe transit result comes from the classical table and vedha only. Ashtakavarga points are shown beside it and do not change it.
- TR-09inventionA week's better and harder days are a stated ruleThe weekly reading calls a day good when both day checks pass: the count from your birth star (tara bala) and the Moon's place from your birth Moon (chandra bala). It calls a day hard when both fail, and mixed when one passes. Nothing is scored.
- TR-10classicalA planet turning direct during the weekWhen a planet turns direct (starts to move forward again) during the week, the weekly reading gives it its own entry and its own text. It says what that planet looks after and that held-up matters there tend to move again. Turning retrograde (seeming to move backward) has its own, different text. Each turn shows its date and time in the birth time zone.
SS Sade sati 5
Sade sati: Saturn's passage over the birth Moon's sign and the signs on each side of it, in three dated phases.
- SS-01classicalThe band and its three phasesSade sati runs while Saturn is in the sign before the birth Moon's sign, in the Moon's sign, or in the sign after it. It lasts about seven and a half years, in a rising, a peak and a setting phase.
- SS-02schoolThe two dhaiya are reported, and are not sade satiSaturn in the 4th or the 8th sign from the birth Moon is called dhaiya, each lasting about two and a half years. The API reports dhaiya separately, because it is not sade sati.
- SS-03classicalDates resolve every crossing, including retrograde re-entrySaturn often crosses a sign boundary three times: forward, back while retrograde, then forward again. The API dates every crossing and keeps one sade sati together, with the break inside it.
- SS-04gapWhat the date scan cannot resolveSaturn's position is checked every few days and each sign change is then pinned down. The rule notes the one rare case this cannot separate: Saturn turning around within a fraction of a degree of a sign boundary.
- SS-05schoolKantaka shaniSaturn in the 4th, 7th or 10th sign from the birth Moon is called kantaka shani, each stay lasting about two and a half years. The API dates it and says when it is running, next to sade sati and dhaiya. The 4th is both dhaiya and kantaka, so it is listed once with both names.
KM Kundli matching (guna milan) 17
Kundli matching: the 36-point guna milan (ashtakoot), the classical exceptions, the checks that carry no points, the ten southern poruthams, and the final verdict.
- KM-00inventionMatching text names the coupleThe matching text names the couple's own details, such as their nakshatras, signs and yoni animals. So each reading is about the two people, not only about the factor in general.
- KM-01classicalThe eight kootas and their weightsGuna milan gives 36 points across eight factors (kootas), worth 1 to 8 points each. All eight come from the two birth Moons alone, their signs and nakshatras.
- KM-02classicalThe scheme is asymmetricThe score is not the same both ways: swapping the two people can change it. That is why the request names them bride and groom.
- KM-03schoolVarna, and vashya by whole signVarna follows the element of each Moon sign: water, fire, earth or air. It scores only when the groom's varna is equal to or higher than the bride's. Vashya is read from each Moon sign as a whole.
- KM-04schoolYoni, and the seven sworn enmitiesEach nakshatra has an animal (yoni) and a sex. The same animal with opposite sexes scores 4 points, sworn enemies score nothing, and every other pair scores 2.
- KM-05schoolGana and nadi, by nakshatraGana and nadi each split the 27 nakshatras into three groups of nine.
- KM-06classicalBhakoot, and graha maitriBhakoot scores 7 points or none: the Moon signs 2 and 12, 5 and 9, or 6 and 8 apart carry bhakoot dosha. Graha maitri scores the natural friendship between the two Moon-sign rulers, read both ways.
- KM-07schoolThe classical exceptions, and why they are appliedNadi and bhakoot are worth 15 of the 36 points and are all or nothing. Every text that gives these doshas also gives their exceptions, so the API applies the exceptions and shows the score both before and after.
- KM-08schoolRajju and vedha carry no pointsRajju and vedha are pass-or-fail checks. They are reported beside the score and never added to it.
- KM-09inventionDasha sandhi has no stated widthDasha sandhi, the changeover from one main planetary period to the next, is traditionally avoided for weddings. The texts give no width for it. So the API takes it to be the first or last sub-period of a main period, and says so.
- KM-11schoolDashakoot: ten pass-or-fail poruthamsDashakoot is the southern way to read the same two Moons: ten poruthams, each answered yes or no. The API counts how many agree and gives no points. So there is no second 36-point score.
- KM-12schoolStree deergha has two thresholdsFor stree deergha, sources disagree on how far the groom's nakshatra should be from the bride's. The API returns both answers and counts the porutham as agreeing only when both do.
- KM-14schoolThe match conclusion is a stated rule, not a scoreThe verdict follows a stated rule, not a score. A serious finding, such as fewer than 18 points or a nadi or bhakoot dosha that no exception cancels, makes a match difficult. Otherwise any concern makes it workable, and a match with neither is favorable.
- KM-16inventionA weak 7th lord with the partner's Mars on itThis check was created for the API, not taken from a classical text. It marks a match as serious when one person's own 7th house ruler (the planet in charge of marriage) is debilitated (in its weakest sign), and the other person's Mars sits in that same sign. The 36-point score can never see this on its own, because it only looks at the two Moons. There is no score cutoff: this check runs and can flag a match no matter how high the 36-point score is.
- KM-13classicalPapa samyam is manglik widened, and it is compared not scoredPapa samyam asks the manglik question of five difficult planets (the Sun, Mars, Saturn, Rahu and Ketu) instead of Mars alone. The API compares the two counts and does not score them.
- KM-15schoolThe Mars (manglik) check in a matchThe Mars (manglik) check in a match grades each person by the counts from the rising sign and from the Moon. Found from either means manglik. Found only from Venus means a milder, partial sign. If one person is manglik and the other shows no sign of it, that is a concern. If the other has the milder sign, the match is noted as partly balanced and not counted against it. Both manglik, or neither, is balanced.
- KM-10gapWhat matching does not look atThis rule lists everything matching looks at, and names what it leaves out. Examples are a full comparison of the two 7th houses or the two navamsa charts. KM-16 now covers one narrow piece of the 7th house comparison; the rest is still left out. That way no one assumes more was checked than was.
JM Jaimini 13
Jaimini astrology: the chara karakas, the arudha padas, sign aspects, argala, chara dasha and Narayana dasha.
- JM-01schoolThe seven chara karakasThe seven planets from the Sun to Saturn are ranked by their degree within their sign. The highest becomes the atmakaraka, the next the amatyakaraka, and so on. The API uses the seven-karaka scheme, which leaves out Rahu.
- JM-02classicalArudha padas, and the two exceptionsAn arudha pada is found by counting from a house to its ruler, then the same number of signs again. If that lands on the house itself or the 7th from it, the API takes the 10th sign from there instead.
- JM-03classicalRashi drishti: signs looking at signsIn Jaimini astrology, signs aspect other signs by their type (movable, fixed or dual), with no planet involved. These aspects are always mutual.
- JM-04schoolArgala: three pairs, not fourArgala is influence on a sign from planets in the 2nd, 4th and 11th signs from it. Planets in the 12th, 10th and 3rd signs can block it.
- JM-05schoolEqual numbers obstructAn argala is blocked when the blocking sign holds at least as many planets as the sign causing it. Some sources ask for more, not an equal number, and the rule says so.
- JM-06schoolChara dasha, stated in fullChara dasha runs forward or backward depending on the sign in the 9th house. Each sign's period is the count from the sign to its ruler, minus one. The count goes forward or backward by that sign's own group. A ruler in its own sign gives 12 years. The response shows the working for every period.
- JM-07schoolTwo lords for Scorpio and Aquarius, and which one countsScorpio has two rulers, Mars and Ketu, and Aquarius has Saturn and Rahu. If one ruler sits in the sign itself, chara dasha counts to the other one. If both sit in it, the period is 12 years. If both are elsewhere, the stronger one counts: the one with more planets beside it, then the one further through its sign (Rahu and Ketu by their own degree), then the atmakaraka (the planet that stands for the self). The count to Rahu or Ketu runs the normal way, not in reverse. Checked against 7 published charts, 84 periods in all.
- JM-08gapWhat Jaimini astrology the API does not compute yetThis rule names the parts of Jaimini astrology the API does not calculate yet, such as longevity and the third level of chara dasha periods.
- JM-09schoolChara dasha dates, the second cycle and the antardashasChara dasha is dated from the moment of birth. After the first round of twelve periods, each sign runs again for 12 minus its first-round years. Each period splits into 12 equal sub-periods, starting from the next sign and ending with the period's own sign. They run forward or backward depending on the sign 9th from the period's sign.
- JM-10schoolNarayana dasha: where it startsNarayana dasha is a Jaimini dasha where each period belongs to a sign. It starts from the stronger of the ascendant sign and the sign opposite it. The API tests strength rule by rule, starting with which sign holds more planets, and shows every test.
- JM-11schoolNarayana dasha: direction and orderThe 9th sign from the starting sign sets the direction. Saturn in the starting sign makes the periods run forward, one sign after another. Ketu there turns the direction around. The starting sign's type (movable, fixed or dual) sets the order.
- JM-12schoolNarayana dasha: the years of each signEach sign's years are the count from the sign to its ruler, minus one, as in chara dasha. A ruler in its own sign gives 12. A ruler at its strongest (exalted) adds a year, and one at its weakest (debilitated) takes a year off. The API never lets a period go below 1 or above 12 years.
- JM-13schoolNarayana dasha: dates, the second cycle and the antardashasNarayana dasha is dated from the moment of birth. After the first round, each sign runs again for 12 minus its first-round years. Each period splits into 12 equal sub-periods. They start from the sign holding the ruler of the stronger of the period's sign and the sign opposite it.
UG Upagrahas 4
Upagrahas: sensitive points that are not planets. Gulika, Mandi and five others come from the time of day, and five more come from the Sun's position.
- UG-01classicalThe eight parts of the dayThe day, from sunrise to sunset, or the night, from sunset to the next sunrise, is split into eight equal parts. Each of the first seven belongs to a planet, starting from the lord of the weekday, and gives one upagraha. The eighth part has no lord.
- UG-02schoolGulika and MandiEach upagraha is the degree rising in the east during its part. The API gives both the degree at the start of the part and at the end, because the two traditions use different ones. Gulika is the start of Saturn's part and Mandi is its end.
- UG-03schoolEight parts, not sevenSome software splits the day into seven parts and ends them a few minutes before sunset. The API follows the classical text and uses eight, so its upagraha degrees can differ from that software.
- UG-04classicalThe Sun-based upagrahasDhooma, Vyatipata, Parivesha, Indrachapa and Upaketu are fixed distances from the Sun, so they need no clock. They match other software exactly whenever the Sun does.
SL Special lagnas 10
Special lagnas: extra rising points counted from sunrise or from the Moon. Also the yogi point, two Jaimini significators and the signs a lunar day marks as unlucky.
- SL-01classicalBhava, hora and ghati lagnaThese three start at the Sun's degree at sunrise and move forward at a fixed pace. They move one sign every two hours, every hour, and every 24 minutes.
- SL-02schoolWhen sunrise is takenThe API takes sunrise as the moment the center of the Sun crosses the true horizon, without the bending of light by the air (PA-21). Calendars print a sunrise three to four minutes earlier. The fast-moving lagnas move several degrees in that time, so the API shows the sunrise it used.
- SL-03classicalPranapadaPranapada turns the time since sunrise into degrees. It adds them to the Sun, or to the 9th or 5th sign from it, depending on the kind of sign the Sun is in.
- SL-04gapJaimini hora lagnaThe API gives the classical hora lagna only. A separate Jaimini version printed by some software does not follow a rule the API could confirm, so it is left out.
- SL-05schoolVarnada lagnaVarnada lagna combines the sign of the ascendant and the sign of the hora lagna, as the classical text describes. It counts forward for odd signs and backward for even ones. Some software counts differently and can give another sign.
- SL-06classicalIndu lagnaIndu lagna is counted from the Moon's sign by fixed values of the two 9th-house lords. It is a sign only, with no degree.
- SL-07classicalYogi and avayogiThe yogi point is the Sun's degree plus the Moon's degree plus a fixed amount. It names the yogi, a planet that tends to help, and the avayogi, a planet that tends to hold things back.
- SL-08schoolMaheshwara and RudraMaheshwara and Rudra are Jaimini significators for long life. Rudra is the stronger of the 2nd and 8th house lords. The weaker one takes its place if only it gets the gaze of a harmful planet. The API states the order of the strength tests it uses.
- SL-09schoolBrahmaBrahma is one of the 6th, 8th or 12th lords, counted from the lagna or the 7th, whichever is stronger. The API first looks for one in an odd sign in the upper half of the chart; if none fits, it tries an odd sign anywhere, and failing that, any sign in an odd house, so a chart is almost never left without one. Saturn, Rahu and Ketu never take the role; a sixth planet in a fixed order stands in for them instead.
- SL-10schoolDagdha rashisEach lunar day marks certain signs as "burnt," which are avoided for new work. The API gives the signs for the lunar day of birth.
SB Shadbala 12
Planetary strength: shadbala, the six-part strength of each planet in virupas, and the strength of the houses.
- SB-01classicalSix sources, measured in virupasA planet's shadbala adds six kinds of strength: position, direction, time, motion, natural strength and aspects. It is measured in virupas, 60 to a rupa, and the six parts are also returned on their own.
- SB-02classicalUchcha bala falls linearly from the exaltation pointPositional strength from exaltation is 60 virupas at the exact exaltation degree and falls evenly to zero at the opposite point.
- SB-03schoolDig bala is measured from the degree, to the real anglesDirectional strength is 60 virupas at a planet's best angle and zero at the opposite point, measured from the planet's degree. The angles are the real ones: the ascendant, the descendant, the midheaven (the degree overhead at birth) and the point opposite it.
- SB-04classicalSaptavargaja bala uses the five-fold friendshipOne part of positional strength scores the planet's dignity in seven divisional charts, using the five-fold friendship between planets.
- SB-05schoolCheshta bala is the cheshta kendra divided by threeStrength of motion comes from the angle between a planet and its mean Sun, divided by 3, so it runs from 0 to 60. The mean positions come from the Surya Siddhanta, an old Indian astronomy text. A planet moving backward (retrograde) scores high, and a planet hidden behind the Sun scores near 0. The Sun and Moon use other measures.
- SB-06inventionWhat is not computed is namedAny part of the score that could not be worked out is listed in not_computed with the reason. Nothing is set to zero and then added in quietly.
- SB-07classicalA house is as strong as its lord, plus the kind of sign on itA house's strength (bhava bala) starts from the strength of its ruling planet. It adds a figure for the kind of sign on the house, highest where that kind of sign is strongest.
- SB-08classicalDrik bala: a quarter of the drishti, Jupiter and Mercury in fullAspect strength takes a quarter of each planet's aspect. A helpful planet's aspect adds and a harsh planet's aspect takes away. Jupiter's and Mercury's aspects count in full, as the classical text says. Only the seven planets from the Sun to Saturn count, not Rahu or Ketu. A waning Moon counts as a harsh planet.
- SB-10classicalTime strength follows the SunShadbala uses the weekday, the planetary hour and the thirds of the day. All are counted from the real sunrise and sunset at the birth place (the center of the Sun, PA-21), not from the clock. The planetary hour here is a 60-minute hour counted from sunrise.
- SB-09classicalAspect strength is gradedAspect strength uses Parashara's graded aspect. A glance is strongest, 60 virupas, at the opposite point. It fades to nothing at 30 degrees and at 300 degrees of separation. The special aspects of Mars, Jupiter and Saturn are graded by degree too. Each is full only at its exact distance.
- SB-11schoolThe year and month lordsPart of time strength goes to the lord of the year (15 virupas) and of the month (30 virupas). Both are counted in days from creation, with a 360-day year and a 30-day month, as the classical text says.
- SB-12classicalStrength from a planetary warWhen two of Mars, Mercury, Jupiter, Venus and Saturn are within one degree, they are at war. The planet further north wins. The winner gains the gap between the two planets' strength from position, direction and time. The loser loses the same amount.
VB Vimshopaka bala, ishta and kashta 5
Strength across the divisional charts on a scale of 20, and how much good and harm each planet can give. Also the table of planet friendships these are graded on.
- VB-01classicalStrength across the divisional chartsVimshopaka bala scores each planet out of 20 across a set of divisional charts. Each chart carries a fixed weight and the weights add up to 20. Four sets are given: 6, 7, 10 and 16 charts.
- VB-02schoolHow a planet scores in each chartIn each divisional chart a planet earns the full weight in its own sign. It earns less as the sign's ruler is a great friend, friend, neutral, enemy or great enemy to it. Exaltation is not scored separately, as in the source text.
- VB-03schoolRahu and Ketu are not scoredRahu and Ketu are left out of these scores, and the response says so. The traditional friendship table has no entry for them, so there is nothing to grade them by.
- VB-04classicalThe planet friendship tableThe five-fold friendship table is returned for every pair of planets: the natural friendship, the friendship from this chart's positions, and the two combined. It is the same table the strength scores use.
- VB-05schoolGood and harm a planet can giveIshta phala (the good a planet can give) and kashta phala (the harm) are each out of 60. They are worked out from the planet's exaltation strength and strength of motion, by the formula in the source text. The simple average that some software prints is returned beside it.
BD Birth details 11
Birth details: the avakhada chakra and the panchang at the moment of birth, as on the second page of a printed kundli.
- BD-01classicalThe avakhada chakraThe avakhada chakra gives one chart's varna, vashya, yoni, gana, nadi and rajju. It also gives the birth nakshatra, its quarter, the name syllable, the Moon sign and its ruler. It uses the same tables as kundli matching, so the two always agree. One birth star, Shravana, has two sets of name syllables. The API counts 27 stars and gives Ju, Je, Jo and Kha. Hindi, Gujarati and Marathi calendars count 28 stars and give Khi, Khu, Khe and Kho. The API returns that set beside its own.
- BD-02schoolPaya, and what is left outPaya sorts a birth by metal: gold, silver, copper or iron. Rashi paya comes from the house the Moon is in, counted from the rising sign: houses 1, 6 and 11 give gold, 2, 5 and 9 silver, 3, 7 and 10 copper, 4, 8 and 12 iron. Nakshatra paya comes from the birth star itself, by a fixed list of which stars give which metal. Both follow the Mansagari tradition, as our astrologer ruled, and both match an outside report on every chart we checked. A few items from the hansa chakra are still left out, because the rules for them differ. The response names them in not_included.
- BD-03classicalThe lunar monthThe lunar month runs from one new moon to the next and is named for the Sun's sign change that falls inside it. A month with no sign change is a leap month (adhika masa).
- BD-04classicalThe birth panchang is not the day panchangThe five parts of the panchang are read at the moment of birth, and the lunar month, season and era years for the day. Both are returned, with the parts at sunrise beside them.
- BD-05classicalTime spent in the birth nakshatraThe response gives when the Moon entered your birth nakshatra (birth star) and when it leaves. It also gives how much of that time had passed at birth (bhayat) and the full length (bhabhog). Times are in ghatis (24 minutes each) and in hours.
- BD-06classicalLocal time, star time and the Sun's sideLocal mean time is your birth time set by the sun at your place, not by the time zone. Sidereal time (star time) is the time the rising sign is worked out from. The gola says whether the Sun was north or south of the equator.
- BD-07classicalThe Gujarat year countBeside the usual Vikram year, the response gives the Gujarat count of the same year. It starts at Kartika, the day after Diwali, instead of at Chaitra.
- BD-08schoolThe ghat chakraThe ghat chakra lists days and times that do not suit you for some kinds of work, like a journey or a dispute. It is picked by your Moon sign at birth. We use the old text Muhurta Chintamani, with its best-known commentary, and the response names it. It gives the lunar days (tithis), weekday, nakshatra, Moon sign and rising sign. The tithi group and the tithi numbers are kept apart, each as the text prints it. The text gives no month, yoga, karana or part of the day (prahar). Those come from one other named table, shown apart from the first. Only two of the twelve rows have been checked against another program's report.
- BD-09schoolThe other ghat tablesOther published ghat tables do not agree on every entry. Each one is returned in full beside ours, with its name. Every place one differs from ours is listed with both values. We never mix tables. The ghat chakra only applies to travel, legal disputes and dealing with people in power, because that is what the old text itself says. A wedding, a naming day, or any other family rite of passage has its own protections and is never affected by the ghat chakra. The response names both lists, so an app can decide when to show it.
- BD-10schoolThe hora at birth, counted two waysA hora is one of the 24 planetary hours of a day. We split the daylight into 12 equal parts, and the night into 12 more, starting at sunrise. Some software counts plain 60-minute hours from sunrise instead. We give both, with ours first.
- BD-11schoolThe season and the Sun's half-year, counted two waysThe ritu (season) and ayana (the Sun's half-year, moving north or south) in your birth details follow the solstices and equinoxes, the way the seasons really turn. The lunar-month season and the star-based half-year are given beside them, named.
DR Reading a dasha period 4
How a dasha period is read: what the main period, sub-period and sub-sub-period each mean for this chart.
- DR-01inventionThree levels of dasha readingA reading of the running periods is built from three levels: the main period, the sub-period and the sub-sub-period. It uses short pieces of text for each planet and each relation between two planets.
- DR-02classicalA period is qualified by where its lord standsEach period's reading depends on where its planet stands in this chart, and the response shows the evidence. A Venus period reads differently when Venus is strong than when it is weak.
- DR-03classicalThe nodes rule periods but hold no friendshipRahu and Ketu rule periods but have no friends or enemies among the planets. When one of them rules a period, the relation is reported as node instead of being guessed.
- DR-04inventionSookshma and prana are dated and not readOnly the first three levels of periods get reading text. The two deepest levels last days or hours, so they come back as dates only.
RC Where a chart disagrees with itself 3
Where a chart disagrees with itself. When two rules about the same part of life point opposite ways, the API names the disagreement instead of hiding it.
- RC-01inventionA disagreement is named, never averagedWhen two rules about one house point opposite ways, the API reports both, what each rests on, and which one leads. It never averages them into one vague answer.
- RC-02classicalHow a rule about a house ruler leansA rule about a house ruler leans on which houses that planet rules: ruling a trikona supports, ruling a dusthana strains. Other rules lean on the planet's own strength.
- RC-03inventionWhen a disagreement is reportedA disagreement needs one rule leaning good and another leaning difficult. A rule that is itself mixed sits on neither side, so a disagreement is only reported when it is real.
KR Karmic reading 3
The karmic reading: the Rahu-Ketu axis, the atmakaraka and its karakamsa, and the 5th, 9th and 12th houses, with no claims about past lives.
- KR-01inventionWhat the karmic reading refuses to claimThe karmic reading describes a person's leanings and direction: where they are already at ease, and where they are drawn to grow. It is not a report on a past life, and every response says so.
- KR-02classicalThe nodes are one axis, and Ketu's house keys itRahu and Ketu are always seven houses apart, so they are read as one axis. Ketu's end is what a person already knows well, and Rahu's end is where their effort goes. The reading is based on the house Ketu sits in.
- KR-03classicalThe atmakaraka and its karakamsaThe atmakaraka is the planet at the highest degree within its sign. Its karakamsa is its sign in the navamsa (D9), counted as a house from the rising sign of the birth chart.
PQ Question chart (prashna) 51
A chart cast for the moment and place a question is asked, read for one topic you pick from a list. It shows tendencies of the moment. It is not a yes or no answer and not medical, legal or financial advice.
- PQ-01inventionWhat a question chart does not claimThe reading describes the tendencies of the moment you ask. It does not promise an outcome, and every response says it is not medical, legal or financial advice. A question is chosen from a list of topics and is never read from a sentence.
- PQ-02classicalTopics and their housesEach topic is read from its own houses: marriage from the 7th, career from the 10th and 11th, money from the 2nd and 11th, health from the 1st against the 6th, studies from the 4th and 5th, property from the 4th, travel from the 9th, 12th and 3rd, and court cases from the 1st against the 7th. More questions have their own houses too, such as a lost item from the 4th, a job offer from the 10th and 11th, and selling a house from the 11th and 3rd. Natural significator planets are shown beside them.
- PQ-03schoolHow each lord standsThe ruler of the rising sign stands for you, and the ruler of the topic's house stands for the matter. Each is judged by the same classical conditions as every other reading: sign, house, combustion and the planets around it.
- PQ-04classicalThe whole-sign ties between the two rulersThe ways the two rulers are tied by whole signs are listed: sharing a sign, swapping signs, looking at each other, sitting in each other's house, or being the same planet. For a question they are shown as evidence. The answer now uses the planets' degrees instead (PQ-18).
- PQ-05schoolThe MoonThe Moon is strong when it is growing and outside the 6th, 8th and 12th houses, and under strain when it is fading and inside them. A Moon under strain keeps a question from being called Looks good.
- PQ-06classicalHelpful and harsh planets on the housesThe gentle and harsh planets that sit in or look at your rising sign and the topic's houses are listed. They are shown as reasons and do not change the verdict.
- PQ-07schoolThe four answers to a questionA question gets one of four answers, checked in this order. Highly unlikely: the two rulers are not moving toward each other, and at least one is weak. Delayed: they are moving toward each other, but the faster one is moving backward, Saturn presses on them, or both sit in fixed signs. Possible with effort: they are moving toward each other, but a harsh planet gets in the way, or a weak ruler gets help from a kind planet. Looks good: they are moving toward each other, neither is weak, and the Moon is not under strain. Cases our astrologer's rule does not cover are read as Possible with effort and marked as waiting for review.
- PQ-08schoolHealthThe reading leans toward recovery when your ruler stands better than the ruler of the 6th house, the house of illness. It is never a diagnosis and never medical advice.
- PQ-09schoolCourt cases and disputesYour ruler is compared with the ruler of the 7th house, which stands for the other side. The stronger one is read as prevailing, and an even match is read as a likely settlement. It is never legal advice.
- PQ-10schoolEach side judged from its own houseIn a health or court question, the other side is judged with its own house as the starting point, so neither side gets an advantage from how the houses are counted.
- PQ-11schoolTimingFor a question, the time is the number of degrees the faster ruler still has to move to meet the other exactly, one degree to one unit. The unit comes from the faster ruler's sign: days for a movable sign, weeks for a dual sign, months for a fixed sign, or years if Saturn is one of the two rulers. It is an estimate, never a date, and none is given when the answer is Highly unlikely or the rulers are not moving toward each other. Health and court questions keep the old rule of thumb from the rising sign.
- PQ-12gapMethods not usedKP horary numbers from 1 to 249, Kerala ashtamangala, a Moon "void of course" and a directional arudha are not used, and every response names them.
- PQ-13inventionNo verdict is the same for everyoneAcross hundreds of random moments, every verdict of every topic shows up between 5% and 80% of the time. One known exception is named and checked: Looks good is rare for now (about 1 in 100), and our astrologer is reviewing the rule that causes it.
- PQ-14inventionThe answer comes firstEach reading opens with a short answer. A question gets Looks good, Possible with effort, Delayed or Highly unlikely. Health and court questions get Looks good, Possible with effort or Not right now. Up to three reasons follow, the ones that decided the answer first. The rest are picked in a fixed order: whether you and the matter meet, what delays it, the matter's planet, your planet, the planets that press on or help them, the Moon, the planets on the houses, and last the natural planets of the topic. Nothing is weighted.
- PQ-15inventionQuestions that are not answeredSome questions are never answered, whatever the chart shows: how long someone will live, the sex of an unborn child, lotteries, gambling and share tips, a medical diagnosis, whether a named person committed a crime, and a question asked only as a test. The reply says so in plain words and no chart is made. This is our own policy, agreed with our astrologer. It is not a classical rule, and it is not legal advice.
- PQ-16classicalA rising sign too early or too lateIf the rising degree is under 3 degrees of its sign, the matter is not yet ready to read. If it is over 27 degrees, the matter is already settled. Either way the question is not answered and the reply says why. Exactly 3 and exactly 27 degrees are still read.
- PQ-17classicalThe Moon or the rising sign at a sign junctionIf the Moon or the rising sign sits in the last 48 minutes of arc of Cancer, Scorpio or Pisces, or the first 48 minutes of Leo, Sagittarius or Aries, the moment is too unclear to read. The question is not answered and the reply names the cause. Ask again at another time.
- PQ-18classicalHow the planets meet by degreeTwo planets meet when they are 0, 60, 90, 120 or 180 degrees apart, counted by sign. Each planet has its own range: Sun 15 degrees, Moon 12, Jupiter and Saturn 9, Mars 8, Mercury and Venus 7. Two planets use the average of their two ranges. If the faster planet has not yet reached the exact point, the meeting is still to come. If it has passed it, the meeting is over. Source: Prasna Tantra, chapter 2.
- PQ-19schoolPlanets moving backward, and Rahu and KetuWhether a meeting is still to come is read from how the planets are really moving, so a planet moving backward can still come toward the exact point. The faster planet is the one that usually moves faster. Rahu and Ketu have no range, so they take no part in these meetings. These points are waiting for our astrologer's review.
- PQ-20schoolThe Moon's last and next meetingThe Moon's last meeting shows what just happened, and its next meeting shows what comes next. When the next one is with a kind planet or with the planet of your matter, it supports success (Kamboola). We do not use a Moon "void of course". The exact conditions are waiting for our astrologer's review.
- PQ-21schoolWhat the words in the answers meanLinked means the two rulers are moving toward an exact meeting, or one planet rules both. Weak means too close to the Sun, in its weakest sign, or in the 8th house. A harsh planet gets in the way when it sits in your rising sign or the matter's house, or meets either ruler. These readings are waiting for our astrologer's review.
- PQ-22inventionThe list of topicsA list of every topic you can ask about, with its houses and a short note, and every kind of question that is not answered, with the reason, in your language. It uses the same tables as the question chart itself.
- PQ-23schoolOne rule, two questionsA job offer uses the same houses and the same rule as a career question. A pregnancy uses the same house and rule as a question about children. The words change so that each reading is about your actual question. A pregnancy reading never says anything about the sex of a child.
- PQ-24schoolSchool exams and higher examsAn exam up to high school is read from the 4th house. A college, university or higher board exam is read from the 9th. Jupiter and Mercury are shown beside them. These readings are waiting for our astrologer's review.
- PQ-25schoolA missing personThe question is whether the person returns. A spouse is read from the 7th, a father from the 9th, a mother from the 4th, a brother or sister from the 3rd, a child from the 5th, a friend from the 11th, and an employee or servant from the 6th. Jupiter stands for a safe return. The reading never says whether anyone is alive or dead. It always says to go to the police. These readings are waiting for our astrologer's review.
- PQ-26schoolGetting a stolen thing backThe only question is "will I get it back?" The 4th house is the thing and the 2nd is your wealth. The reading never says who took it, never accuses anyone, and does not read the house of the other side. The planet of your wealth is shown as a second sign and does not change the answer. That choice is waiting for our astrologer's review.
- PQ-27schoolBuying a vehicle or a houseBuying is read from the 4th house and the 11th. Venus stands for a vehicle and Mars for land and buildings.
- PQ-28schoolSelling a vehicle or a houseSelling is cash coming in (the 11th) and parting with the thing (the 3rd, which is the 12th counted from the 4th). The 11th comes first. Which one should come first is waiting for our astrologer's review.
- PQ-29schoolSettling abroad, getting back together, and an inheritanceSettling abroad is read from the 9th and 12th, with Rahu and the Moon. Getting back together is read from the 7th and 11th, with Jupiter and Venus. An inheritance is read from the 8th and 2nd, with Saturn and Jupiter. An inheritance reading says nothing about anyone's length of life.
- PQ-30classicalWhich way and what kind of place to look for a lost itemThe sign on the 4th house gives both. Aries, Leo and Sagittarius point east. Taurus, Virgo and Capricorn point south. Gemini, Libra and Aquarius point west. Cancer, Scorpio and Pisces point north. A movable sign suggests the thing has gone far or is outside. A fixed sign suggests it is inside and safe, right where it fell. A dual sign suggests it is inside but moved a little, near doors, windows or edges.
- PQ-31schoolIs a lost item likely to be foundIt leans toward found when your planet is moving toward the item's planet, when one planet rules both, or when the Moon is moving toward your planet. It leans against when the item's planet is in the 8th house, too close to the Sun or under heavy strain, and it has no link to your planet. Otherwise it is unclear. Found wins if both are true. The main answer is a separate rule, so if the two say different things, both are shown. These readings are waiting for our astrologer's review.
- PQ-32gapRenting a houseThis is not offered yet. Our astrologer put renting with buying, but did not say whether that means renting a place to live in or renting one out. It stays off the list until that is settled.
- PQ-33schoolKP number readingThis is a separate reading from the main question chart. It uses KP (Krishnamurti Paddhati), which reads a chart by very small slices of the sky, and it has its own route. It never changes the main answers and never asks for birth details.
- PQ-34schoolYour number sets the housesYou pick a number from 1 to 249. Each number is one small slice of the sky, and it becomes your rising point. The other 11 houses come from it and your latitude. The moment you ask only places the planets in those houses. Places beyond 66 degrees of latitude are refused, because these houses do not work there.
- PQ-35schoolWhich point of your numberThe rising point is the first degree of the slice your number names. The latitude is the one sent with the question. All 12 houses show their slice's ruling planet, called the sub lord. These readings are waiting for our astrologer's review.
- PQ-36schoolEight topicsThis reading covers marriage, work, money, property, studies, travel abroad, children and court cases. Each has its own houses that say yes and houses that say no. Other topics get a clear message that they are not offered here.
- PQ-37schoolWhat the sub lord saysThe sub lord of the topic's house works through its star lord, the planet that rules its birth star. If that links only to yes houses, the chart supports it. If it links to both, it can happen but expect obstacles. If it links only to no houses, the chart does not support it. If it links to neither, there is no clear sign. These readings are waiting for our astrologer's review.
- PQ-38schoolPlanets of the momentRuling planets come from the moment you ask, not your number: the lords of the rising sign and its star, the lords of the Moon's sign and star, and the lord of the day. Rahu or Ketu counts if it sits in the sign of one of these. A planet moving backward, or sitting in the star of one, is set aside.
- PQ-39schoolWhat "confirmed" meansIf the planet carrying the answer is among the ruling planets still counting, we say the moment confirms the reading. That means the moment agrees. It does not mean the result is certain. These readings are waiting for our astrologer's review.
- PQ-40schoolWhen it may happenA date comes only from planet periods (dashas) whose rulers are ruling planets still counting and linked to the question's houses. A planet's movement must back it up. If no such period comes soon enough, or the chart does not support the matter, we say no date and give the reason.
- PQ-41schoolWhose planet periodsThe periods are counted from the Moon at the moment you ask, not from your birth. For marriage and work we look 10 years ahead. For the rest we look to the end of the next main period. These readings are waiting for our astrologer's review.
- PQ-42schoolWhich planet's movement countsFor a period starting within 8 weeks, the Moon's movement backs it up. For a later one, the Sun's, or Jupiter's if the Sun does not reach it in time. These readings are waiting for our astrologer's review.
- PQ-43inventionNo answer is the same for everyoneWe test many numbers, moments and places, and check that no answer comes up nearly always or nearly never.
- PQ-44schoolTrisphutaA question also shows Gulika and Mandi, two points read for hidden obstacles, and Trisphuta, which adds the rising degree, the Moon and Gulika. If that point falls in a harsh planet's navamsa, or Saturn or Rahu looks at it, the check leans toward a harder or slower result. It uses no omens and nothing about the way you face.
- PQ-45schoolWhich point we addGulika is the degree rising at the start of Saturn's part of the day or night, and Mandi the degree at its end. We add Gulika and show both.
- PQ-46schoolA harsh planet's navamsaWe count a navamsa (a small ninth part of a sign) as harsh when the Sun, Mars or Saturn rules it. Rahu and Ketu rule no sign.
- PQ-47schoolHow Saturn and Rahu look at itWe count whole signs. Saturn looks at the 3rd, 7th and 10th sign from itself, and Rahu at the 5th, 7th and 9th.
- PQ-48inventionShown beside the answerThis check never changes the main answer. If it leans harder or slower beside "looks good" or "possible with effort", we say so and show both. Health and legal questions do not get it.
- PQ-49inventionThis check is not the same for everyoneWe test many moments and places, and check that no result comes up nearly always or nearly never. The check does lean harder or slower in about two moments of three, so it says little by itself.
- PQ-50inventionAsking the same thing againOne person asks about one topic once in 72 hours, counted from the last question that got an answer. A refused question does not count, so you can ask again when the moment changes. This is a working rule from our astrologer, not one from the old books. We keep no record, so the app you use keeps track.
- PQ-51inventionTwo ways of asking, one questionAn answer from the KP number reading and one from the main reading on the same topic count as one question. Our astrologer has not ruled on this yet.
SP Spiritual path 15
The spiritual path reading: what one classical book, BPHS chapter 33, says about devotion and inner freedom from the soul planet's navamsa sign and the sign before it.
- SP-01schoolThe Sun and Ketu in the 12th from the karakamsaThis rule reads the 12th sign from the karakamsa (the soul planet's sign in the navamsa chart). The Sun and Ketu together there are linked to devotion to Shiva.
- SP-02schoolThe Moon and Ketu in the 12th from the karakamsaThis rule reads the 12th sign from the karakamsa (the soul planet's sign in the navamsa chart). The Moon and Ketu together there are linked to devotion to Gauri, a gentle form of Parvati.
- SP-03schoolVenus and Ketu in the 12th from the karakamsaThis rule reads the 12th sign from the karakamsa (the soul planet's sign in the navamsa chart). Venus and Ketu together there are linked to devotion to Lakshmi.
- SP-04schoolMars and Ketu in the 12th from the karakamsaThis rule reads the 12th sign from the karakamsa (the soul planet's sign in the navamsa chart). Mars and Ketu together there are linked to devotion to Subramanya (Kartikeya). The translation adds Ganesha, so both are given.
- SP-05schoolKetu alone in the 12th from the karakamsaThis rule reads the 12th sign from the karakamsa (the soul planet's sign in the navamsa chart). Ketu alone there is linked to devotion to Subramanya or Ganesha.
- SP-06schoolRahu in the 12th from the karakamsaThis rule reads the 12th sign from the karakamsa (the soul planet's sign in the navamsa chart). Rahu there is linked to devotion to Durga, or to a smaller local deity.
- SP-07schoolSaturn in the 12th from the karakamsa, in a malefic's signThis rule reads the 12th sign from the karakamsa (the soul planet's sign in the navamsa chart). Saturn there, in a sign ruled by the Sun, Mars or Saturn, is linked to devotion to local or family deities.
- SP-08schoolVenus and Saturn in the 12th from the karakamsa, in a malefic's signThis rule reads the 12th sign from the karakamsa (the soul planet's sign in the navamsa chart). Venus and Saturn together there, in a sign ruled by the Sun, Mars or Saturn, are linked to devotion to local or family deities.
- SP-09schoolKetu in the 12th from the karakamsa in Aries or Sagittarius, with a benefic's drishtiThis rule reads the 12th sign from the karakamsa (the soul planet's sign in the navamsa chart). Ketu there in Aries or Sagittarius, looked at by a gentle planet, is read as a strong pull toward moksha (inner freedom).
- SP-10schoolKetu in the 12th from the karakamsa with a malefic's drishtiThis rule reads the 12th sign from the karakamsa (the soul planet's sign in the navamsa chart). Ketu there, looked at by a harsh planet, is read as a pull toward moksha (inner freedom) that stays incomplete.
- SP-11schoolJupiter in the karakamsaThis rule reads the karakamsa itself (the soul planet's sign in the navamsa chart). Jupiter there is linked to good deeds, a spiritual leaning and learning in sacred texts.
- SP-12schoolVenus aspecting Ketu in the karakamsaThis rule reads the karakamsa itself (the soul planet's sign in the navamsa chart). Venus looking at Ketu there is linked to joining a religious order or taking formal initiation.
- SP-13schoolSaturn aspecting Ketu in the karakamsaThis rule reads the karakamsa itself (the soul planet's sign in the navamsa chart). Saturn looking at Ketu there is linked to penance, hard discipline or a life of service.
- SP-14schoolThe atmakaraka in the navamsa of PiscesThe soul planet (atmakaraka) is the planet at the highest degree in its sign. When it sits in Pisces in the navamsa chart, it is linked to final freedom, moksha.
- SP-15gapWhat the spiritual reading does not applyOnly the book's own verses are used. The popular planet-to-deity table is not in this chapter, so it is not applied, and nothing is said about life after death.
GA Planetary states 7
The five traditional sets of planetary states (avasthas): a planet's age, whether it is awake or asleep, its mood, its emotional condition and its activity. They are shown side by side and never added into a score.
- GA-01classicalAge of a planet (baladi)A planet's age comes from its degree: five stretches of six degrees, reversed in even signs. The classical share of results is given for each age, except old age, for which the text gives no number.
- GA-02classicalAwake, dreaming or asleep (jagradadi)A planet is awake in its own, exaltation or mulatrikona sign. It is dreaming in a friendly or neutral sign, and asleep in an unfriendly sign or in debilitation. Its dignity is read by degree, using the planets' natural bond only, which is the reading matched against outside reports for this state.
- GA-03schoolMood of a planet (deeptadi)A planet's mood comes from how the ruler of its sign relates to it, using the five-level friendship that combines natural and temporary relations. Combustion and malefic company are shown beside the mood, not in place of it.
- GA-04schoolEmotional condition (lajjitadi)Six conditions are read from a planet's sign, the planets in the same sign with it, and the planets that aspect it (look at it). Any one reason is enough for a condition. Proud: in its sign of highest strength (exaltation) or its own best stretch (mulatrikona). Delighted: in a friend's sign, with a friend, aspected by a friend, or with Jupiter. Ashamed: in the 5th house and with Rahu, Ketu, the Sun, Saturn or Mars; an aspect does not count here. Agitated: with the Sun and also aspected by a harsh planet (malefic) or an enemy. Hungry: in an enemy's sign, with an enemy, aspected by an enemy, or with Saturn. Thirsty: in a water sign (Cancer, Scorpio or Pisces), aspected by a harsh planet, and aspected by no kind planet (benefic). Friend and enemy always mean the planets' natural (lasting) friendships, never the mixed kind that also counts where planets sit. "Aspected" means a full aspect on the whole sign: every planet looks at the 7th sign from it, Mars also the 4th and 8th, Jupiter the 5th and 9th, Saturn the 3rd and 10th. Rahu and Ketu cast no aspect here. So the harsh planets that can aspect are the Sun, Mars, Saturn, a waning Moon and Mercury when it sits with a harsh planet. A planet can be in several at once, and each response lists the reason for every condition found. Our astrologer confirmed these rules.
- GA-05schoolWhere emotional condition differs from other softwareOther software reads the emotional conditions differently for some planets. It often leaves out a condition that applies. The API applies each classical condition as written, and our astrologer confirmed this method. Every difference we found is recorded.
- GA-06schoolActivity of a planet (shayanadi)A planet's activity comes from the classical formula. It uses the planet's nakshatra, its number and its navamsa, plus the birth nakshatra, the time since sunrise and the rising sign. Time since sunrise is counted in ghatis (24-minute units). Programs count the ghati two ways: the one running at birth, or the ones already finished. The API uses the running one and also gives the other result. It matches three outside reports for every planet: two on the running count and one on the finished count.
- GA-07schoolRahu and KetuRahu and Ketu get an age and an activity only. The other three sets depend on owning a sign and having friendships, which the nodes do not have. So the API says they are not computed, rather than calling them neutral.
OL Theme forecasts 7
Forecasts on one theme, such as love, career or wealth, over a date range. They list the transits and the dasha periods that touch that theme, and why each one does.
- OL-01inventionA theme is declared once and read by three sectionsEach theme is read from the same houses, rulers and karakas everywhere. The life topic, the monthly topic and the forecast all agree on where career, love or wealth is read from.
- OL-06inventionEach theme explains a transit in its own wordsOne planet's movement can matter to love, career and wealth at once. Each forecast then explains it for its own theme, so you never read the same paragraph three times. The full transit reading stays in the Transits section.
- OL-07inventionTwo transits that pull opposite ways are named togetherSometimes one planet helps an area of your life while another strains the same area at the same time. The forecast then says so, with the dates they share, instead of showing two cards that seem to disagree. It never says which one wins. Rahu and Ketu also get their own wording, because their hard effect is distance and unease, not heat.
- OL-02classicalTransits and periods, never ranked togetherA forecast returns two lists with dates: the transits across the theme's houses and the dasha periods whose planets touch them. Neither list is ranked against the other.
- OL-03classicalA period qualifies three ways, and says whichA dasha period joins a theme's list when its planet rules one of the theme's houses, sits in one, or signifies the theme. The response names which reasons applied.
- OL-04inventionA forecast always reads a windowA forecast always covers a date range, so it never has to guess a moment. If you send no dates, it runs from today to one year ahead, and the window field in the response shows the dates it used. The range can be at most 12 months.
- OL-05inventionA couple forecast shares events, never chartsA couple forecast gives each person their own forecast, plus the events and periods they share on the theme. The two charts are never merged into one. A shared transit crosses a different house for each person, because each house is counted from that person's own rising sign (lagna). Whether it helps or tests is still counted from each person's birth Moon.
PS Pair reading 6
Two charts read against each other: each person's planets placed in the other's houses, the half of compatibility the 36 points leave out. Nothing here is scored.
- PS-01classicalThe two whole charts, not the two MoonsEach person's planets are placed in the other person's whole-sign houses, counted from that person's rising sign.
- PS-02schoolMarriage and friendship are read from different bhavasMarriage is read from houses 7, 2 and 4, and friendship from houses 11, 5 and 3. So two people can be an average match for marriage and still great friends.
- PS-03classicalAsymmetric, and both directions are returnedHis planets in her houses are a different reading from hers in his. Both directions are returned under their own names.
- PS-04inventionNothing is scored, and the counts are never nettedNothing is scored. Benefic (helpful) and malefic (harsh) planets landing in the other chart's houses are counted separately, and neither count is subtracted from the other.
- PS-05inventionNo composite chartThe API does not build a composite (midpoint) chart or compare degree-based aspects between two charts. Both are Western techniques, and the response says they are left out.
- PS-06inventionThe partner's Mars check, shared with matchingThis result also checks each person's own 7th house ruler against the other person's Mars, the same check the marriage match result (KM-16) uses. Both endpoints use the same result, so they always agree.
YD Yogini dasha 5
Yogini dasha, a 36-year cycle of eight periods that runs beside Vimshottari.
- YD-01classicalEight yoginis, thirty-six years, and it repeatsYogini dasha has eight periods, each named for a yogini and linked to a planet. They are Mangala (Moon, 1 year), Pingala (Sun, 2), Dhanya (Jupiter, 3) and Bhramari (Mars, 4). Then come Bhadrika (Mercury, 5), Ulka (Saturn, 6), Siddha (Venus, 7) and Sankata (Rahu, 8). Together they make 36 years, and then the cycle repeats.
- YD-02classicalThe cycle starts from the birth nakshatraThe first yogini comes from the birth nakshatra: count it from Ashwini, add three, and take the remainder after dividing by eight. A remainder of zero means Sankata.
- YD-03inventionBoth systems read one Moon and take one balanceYogini dasha works out the balance at birth exactly as Vimshottari does, by time, so the two systems agree on where a life begins.
- YD-04inventionTwo levels, and the third is refusedYogini dasha is returned to two levels, periods and sub-periods. A third level would last only days.
- YD-05inventionNeither system overrules the otherVimshottari and Yogini are reported side by side. Neither overrules the other, and they are never averaged.
KP Krishnamurti Paddhati 9
The KP system, with its own ayanamsa, its own house cusps and its star and sub lords.
- KP-01schoolThe KP ayanamsaKP uses the Krishnamurti ayanamsa, which is always about 6 arcminutes smaller than Lahiri. Other programs sometimes use a slightly different value under the KP name. A point near the edge of a sub can then get a different sub lord.
- KP-02classicalThe 249 subsEach nakshatra is split into nine subs in the same proportions as the Vimshottari dasha years. Six subs cross a sign boundary and are split there, which gives 249 pieces. The API checks every time it starts that they cover the zodiac exactly.
- KP-03classicalThe sub-sub lordThe sub-sub lord splits each sub again in the same proportions, starting from the sub lord.
- KP-04schoolPlacidus cusps, for KP onlyKP is defined on Placidus house cusps, so the KP endpoint uses them. Everywhere else the API uses whole-sign houses, so a KP house number should not be mixed with house numbers from other endpoints. Placidus cusps are not calculated beyond 66 degrees of latitude.
- KP-05classicalKP housesA planet is in the house from that house's cusp up to the next cusp. There is no allowance for a planet that is close to the next cusp.
- KP-06classicalSignificatorsFor each house the API lists four levels of significators (planets that deliver the house's results), strongest first. First come planets in the star of a planet in the house, then the planets in the house. Then come planets in the star of the cusp's sign lord, and last that sign lord. The levels are listed, not scored.
- KP-07inventionRuling planets at birthOn the birth chart route, the ruling planets are for the moment of birth, and the response says so. For the moment a question is asked, the KP number reading calculates them (PQ-38).
- KP-08gapNot includedRahu and Ketu acting for other planets is left out and named in the response. Ruling planets for another moment and horary numbers are not on the birth chart route. They are in the KP number reading (PQ-34, PQ-38).
- KP-09schoolPart of FortuneThe Part of Fortune is the ascendant plus the Moon minus the Sun, for day and night births alike. Some other schools reverse it at night. For a night birth the API shows that point too, says the sources differ, and does not use it.
AD Ashtottari dasha 6
Ashtottari dasha, a 108-year cycle of eight periods, with the classical test of whether it applies to a chart.
- AD-01classicalEight lords, one hundred and eight yearsAshtottari dasha has eight periods: Sun 6 years, Moon 15, Mars 8, Mercury 17, Saturn 10, Jupiter 19, Rahu 12 and Venus 21. Together they make 108 years. Ketu rules no period.
- AD-02classicalTwenty-eight stars in groups of four and three from ArdraThe first period comes from the birth nakshatra. Ashtottari counts 28 nakshatras, including Abhijit, starting from Ardra, and gives them to the eight planets in groups of four and three.
- AD-03schoolAbhijit has its own span, and the balance at birth is now measured by time tooEach nakshatra in a group carries an equal share of its planet's years. The part left at birth is worked out by time, how long the Moon had been in its star, the same method Vimshottari and Yogini use. Our astrologer gave us the exact star edges around Abhijit needed to measure that. With no birth time to measure by, it falls back to distance and says so. Abhijit is given its usual short stretch between Uttara Ashadha and Shravana.
- AD-04inventionThree levels, the first shown wholeAshtottari is returned to three levels: periods, sub-periods and the level below. The period running at birth is shown in full, with the part left at birth beside it.
- AD-05schoolWhether Ashtottari applies is computed, and the two readings are both reportedClassical texts use Ashtottari only for some charts. One condition is Rahu in an angle or a trine counted from the ascendant's ruler, but not in the first house. The other is birth in the waning half of the lunar month by day, or the waxing half by night. Sources differ on whether one condition is enough or both are needed, so both answers are given. The periods are returned either way.
- AD-06inventionThe reading adds no proseThe Ashtottari reading uses the same planet descriptions as Vimshottari. It adds no text of its own.
RD Classical conditions 4
The classical conditions that decide which half of a placement's reading applies to this chart.
- RD-01classicalThe classical riders choose the half that appliesClassical texts add conditions to each placement: is its ruler strong, combust, retrograde, in a difficult house, with a malefic (harsh planet)? The API checks each condition and uses the half of the reading the chart supports, showing the evidence.
- RD-02inventionNothing is weighted, and the rule is statedNothing is weighted. Conditions that only support give a favorable reading, and those that only strain give a difficult one. Both give mixed, and neither gives a plain reading.
- RD-03classicalThe rider list is symmetric, and house 1 countsThe conditions are balanced: every condition that can strain a placement has one that can support it. A planet in a difficult house strains, and one in an angle or a trine supports.
- RD-04schoolRetrograde is reported and never countedA retrograde planet is named but not counted either way, because the schools read retrograde in opposite directions.
NR The nakshatra remedy 3
The nakshatra remedy: a remedy based on the birth nakshatra, with its deity, mantra, wood and the dates to do it.
- NR-01classicalA remedy keyed on the nakshatra, not on a grahaThe nakshatra remedy honors the deity of the birth nakshatra with its short mantra, chanted 1,000 times. It adds a fire offering of a tenth of that, fed with the wood of the nakshatra's tree.
- NR-02inventionThe full Vedic suktam is deliberately not reproducedOnly the short namaskara mantra is given. The long Vedic hymn is left out on purpose, because a long mantra remembered slightly wrong is worse than none.
- NR-03classicalThe dates are computed, not left to the readerThe API works out the dates for the remedy. These are days when the Moon returns to the birth nakshatra on the weekday ruled by that nakshatra's planet. Four nakshatras are ruled by Rahu or Ketu, which rule no weekday, and the response says so.
VP Varshaphal 14
Varshaphal: the yearly chart cast for your birthday, read with the Tajik system.
- VP-01classicalThe annual chart is cast at the sidereal solar returnThe yearly chart is cast for the exact moment the Sun returns to where it was when you were born. That is usually within a day of your birthday, and it is worked out to the second.
- VP-02schoolCast for the birth place unless another is givenThe yearly chart is cast for your place of birth, unless you give the place where you live now. Traditions differ on this, and the result says which place was used.
- VP-03classicalMuntha advances one sign a year from the natal lagnaMuntha moves one sign each year from your rising sign. The house it lands in shows how the year leans.
- VP-04schoolThe five office-bearers, the candidates for the year lordFive planets are candidates to rule the year. They are listed, and the ruler of the year is chosen from them.
- VP-05schoolMudda dasha divides a 365-day year in Vimshottari proportionMudda dasha divides the year into nine planetary periods, in the same proportions as the lifetime dasha. Two published methods disagree on how the year is measured, so both are given, each matching the program that uses it.
- VP-06schoolNine sahams, measured against two outside implementationsSahams are sensitive points of the yearly chart, such as fortune, education, fame and work, each worked out from three positions. Nine are given that two leading published programs agree on. The two programs work out four more differently, including marriage and trade. So both answers are shown and marked as disputed, instead of picking one.
- VP-07schoolPancha-vargeeya bala, fitted to an outside implementationEach planet's strength in the yearly chart is scored from the signs and divisions it sits in and who rules them. Our scores match a leading published program's in 34 of 35 checks.
- VP-08classicalHarsha bala, four conditions of five pointsEach planet also gets a joy score from four simple conditions, such as whether it sits in its favorite house. These match a leading published program in all 35 checks.
- VP-09schoolThe year lord is the strongest office-bearer aspecting the lagnaThe ruler of the year is the strongest of the five candidate planets that looks at the yearly rising sign. The Moon can never be the ruler, and a planet needs a strength of at least 5 out of 20. If no planet is left, the lord of the muntha (the yearly moving point) rules the year. If that is the Moon, the lord of the yearly rising sign rules instead, and if that is the Moon too, the lord of your birth rising sign. The full ranking of the five is shown too.
- VP-10classicalMasa pravesh: twelve monthly returns, solved like the yearThe year is also split into twelve months. Each month starts at the moment the Sun has moved on another 30 degrees from where it was at your birth. Each moment comes with the rising sign at that time.
- VP-11classicalDina pravesh: a day for every degree the Sun movesEach day of the year starts when the Sun has moved on one more whole degree from where it was at your birth. You can ask for one day or up to a month of days.
- VP-12schoolTri-pataki chakra: two divisions, both returnedThe tri-pataki chart (the three-flag chart) is a simple drawing for the year. Each planet moves on by a set count each year. The chart shows which planets reach your Moon and your rising sign along its lines. A planet on the same point as your Moon, or as your rising sign, counts as a direct hit. The Moon itself hits nothing; it is only the target. The Moon is the main target; some astrologers also check the rising sign. Two old texts count Mars differently, so both answers are shown. It is shown as it is, not as a verdict on the year.
- VP-13classicalTajaka orbs: the deeptamsha, and the mean of a pairTajik reads how two planets meet in the yearly chart. Each planet has its own range (orb). Two planets meet when the angle between them is close to an exact Tajik angle, within the average of their two ranges. A meeting is "coming closer" or "moving apart" from how fast each planet moves that day. A planet moving backward reverses this.
- VP-14schoolAll sixteen Tajaka yogas are computedAll sixteen Tajik yogas (planet patterns of the yearly chart) are worked out. Each one is a stated condition on how planets meet, such as two planets coming closer, a third planet linking two that do not see each other, or all seven planets sitting in one kind of house. Coming closer and moving apart show up in almost every year, which is normal for Tajik; the rest are each seen in a smaller share of years.
SG The signature page 5
The signature page: the lucky day, colors, numbers and stones, worked out from the chart.
- SG-01inventionThe signature page is read from two grahas, not the lagnaThe lucky day, colors and numbers come from two planets in the chart. These are the ruler of the rising sign and the ruler of the Moon sign. They do not come from the rising sign alone. So two people with the same rising sign can get different results.
- SG-02classicalA dusthana lord that rules a trine is not a maleficThe colors to go easy on belong to the rulers of houses 6, 8 and 12. A planet that also rules a trine is left out, and so is the yogakaraka.
- SG-03classicalThree lords, three stones, one tableThree stones come from three house rulers. House 1 gives the life stone, house 5 the stone of merit and house 9 the stone of fortune. The stones come from the same table as the remedies, so the two always agree.
- SG-04schoolLucky numbers use ank jyotishThe planet-to-number table is ank jyotish, an Indian numerology custom, not a classical astrology rule, and the reading says so.
- SG-05schoolThe strongest graha is named, with what it rests onThe signature page ranks the seven planets by their shadbala strength against the classical minimum for each. It names the strongest and the weakest, and returns the whole ranking with what it rests on.
AN Annual forecast 6
The annual forecast: a year of dated sky events, then read against the chart.
- AN-01inventionA year is dated from what moves, not from the lagnaAn annual forecast is a calendar of dated events for the year, read against the chart. The events include sign changes, retrograde periods, combustion periods and two conjunctions. Nothing in it is based on the rising sign alone.
- AN-02classicalWhat the calendar holdsThe calendar holds four kinds of event, for the planets that can produce each one.
- AN-03classicalStations are facts; their dates depend on the time zoneThe moment a planet turns retrograde or direct is a fact, and the API's times match an independent calendar. The date that moment falls on depends on the time zone, so the API gives it in the birth time zone.
- AN-04schoolCombustion is a convention and reports its orbWhether a planet is combust depends on its distance from the Sun, and the texts disagree on that distance. So every combustion event in a response gives the distance it used.
- AN-05classicalAn event is read from the natal house and the MoonEach event is placed in two ways. One is the house of the birth chart its sign falls in. The other is the house counted from the birth Moon, which gives the classical result.
- AN-06inventionFive sections select from one calendarThe year's events are worked out once, and each section of the forecast picks the events that matter to its question.
MF Monthly forecast 4
Monthly forecasts: how a month is read from the planets moving through it, and why these sections need a date.
- MF-01inventionA monthly section is keyed on the gocharaThe monthly forecast sections report the transits for the month you ask about. Without a date, they say they need one and return no reading.
- MF-02classicalA theme selects transits by karaka or by houseA transit belongs to a monthly theme when its planet signifies that theme. It also belongs when it crosses one of the houses the theme is read from. Both reasons are reported.
- MF-03classicalFavorable days come from the Moon's transitGood and difficult days come from the Moon's transit counted from the birth Moon. The Moon moves through all twelve houses in about 27 days, and houses 1, 3, 6, 7, 10 and 11 are the favorable ones.
- MF-04classicalPeriods report unobstructed; the instant applies vedhaPeriods in a monthly forecast give the classical result without vedha. The today list beside them applies vedha, because it is read for one moment.
LP Life prediction topics 4
Life prediction topics: which part of the chart answers each life question, such as career, love or wealth.
- LP-01classicalA life topic is read from houses, lords and karakasEach life question names the houses it is read from, the houses whose rulers matter, and the planets that signify it. The answer is built from the chart's rules for those placements.
- LP-02classicalDasha periods are classified by lordship aloneWhether a main period helps or costs is decided by which houses its planet rules: ruling a trikona helps, ruling a dusthana costs.
- LP-03inventionA life topic is built from the chartA life topic reading is built from this chart's own rules, not taken from a stored paragraph for the rising sign.
- LP-04inventionA topic says a few things more, from verdicts that existEach life topic also answers a few smaller questions, such as how you save or how others see you. Each one comes from a verdict the chart already gives, so it cannot disagree with the rest of the reading.
RM Remedies 12
Remedies: which gemstone, rudraksha, mantra and havan the chart calls for, and what decided each one.
- RM-01classicalThe life gemstone is the ascendant lord's stoneThe life gemstone comes from the ruler of the rising sign. It does not change over a lifetime.
- RM-02classicalThe period remedies are the dasha lord'sThe lucky gemstone, rudraksha, mantra and havan come from the planet whose main period is running, so they change when the period changes. They need a date to be worked out.
- RM-03inventionA qualified stone is reported, never withheldWhere tradition warns about a stone, such as blue sapphire, the warning is returned beside the suggestion. The suggestion is never hidden.
- RM-04inventionA dosha remedy appears only with the doshaRemedies for kaal sarp dosh and pitra dosh are given only when the chart has that dosha. Sade sati remedies are given only while sade sati is running.
- RM-05inventionRemedies are written per planetEach remedy is written once per planet, and the chart selects which planet applies.
- RM-06schoolWhich rudraksha goes with which planetEach planet has one rudraksha bead, from the one-faced bead for the Sun to the nine-faced bead for Ketu. Texts differ on this, so the API uses the most common table and uses it everywhere. For the Sun, the twelve-faced bead is also given, since it is the one more often worn.
- RM-07schoolThree ways a chart picks a rudrakshaA bead is suggested for each of three planets. They are the ruler of the rising sign, the planet whose main period is running, and the ruler of the birth star. Each comes with its reason, and a bead picked twice is listed once.
- RM-08inventionRudraksha advice stays simple and makes no promisesThe advice covers the day to start, the thread color, the metal and the planet's mantra. It makes no health, diet or luck claims, and every answer says in the reader's language that a bead is not a guarantee.
- RM-09schoolWhich mantras a chart getsYou get the mantras of the planet whose main period is running now, on that planet's day. Saturn and Hanuman mantras are added during sade sati. Mantras for manglik, kaal sarp or pitra dosha are added only when the chart really has that dosha. Every chart also gets a short everyday set. The mantra words are the same in every language. If you do not read Devanagari, each mantra is also written in your own letters, so you can say it.
- RM-10schoolWhich planets your charity and fasts are forYour charity and fasts follow the same planets as your mantras. They are the planet whose main period is running, the planet of your current sub-period, and the ruler of your rising sign. Saturn is added during sade sati. Mars, Rahu and Ketu, or the Sun are added only when the chart really has manglik, kaal sarp or pitra dosha.
- RM-11schoolWhat to give and how to fast for each planetEach planet has its own day, the things to give, the people to give them to, and the simple foods for its fast. These follow common tradition, and books differ on small details. Rahu and Ketu have no day of their own, so the usual day is given and the other days books name are listed too. For Ketu, the charity also includes feeding and caring for stray dogs, especially black-and-white or hurt ones, with tips on feeding them safely.
- RM-12inventionA fast comes with a caution, and no promiseEvery fasting answer says to skip or soften the fast if you are pregnant, unwell, older or take medicine, and to ask your doctor first. Neither charity nor fasting is a promise of any result.
MU Muhurat and times of the day 9
Muhurat and times of the day: horas, the choghadiya, and where they disagree with rahu kaal and the other windows.
- MU-01classicalEverything runs down the Chaldean orderHoras and the day and night choghadiyas all follow one fixed planet order: Saturn, Jupiter, Mars, Sun, Venus, Mercury, Moon. Horas and day choghadiyas move one place along it at a time. Night choghadiyas move five places.
- MU-02classicalThe weekday order is a consequence of the hora orderTwenty-four horas move three places along that order, and three places on from any weekday's planet is the next weekday's planet. That is where the order of the weekdays comes from.
- MU-03schoolChoghadiya, and where the night sequence startsDaylight and night are each split into eight choghadiyas. The day starts with the weekday's planet, and the night starts with the planet of the fifth weekday counted from it. Every night runs the same cycle, as published panchangs list it: Shubh, Amrit, Char, Rog, Kaal, Labh, Udveg.
- MU-04inventionWhen the choghadiya and rahu kaal disagreeRahu kaal, yamaganda and gulika kaal are eighths of the same daylight as the choghadiya, and some weeks they fall on a good choghadiya. The response lists every such overlap and does not pick one side.
- MU-05schoolA hora is not an hourA hora is a 24th of the time from one sunrise to the next, so it is close to an hour but not exactly one. Hora times use the birth-chart sunrise (PA-21), three to four minutes after the calendar sunrise. Many printed calendars use a flat 60 minutes instead, so their times can differ by a few minutes.
- MU-06gapWhat muhurat does not coverThe API finds good windows for an activity but never ranks them: every window it returns passes every rule. It does not judge the planets in the rising-sign chart of the moment, the running dasha, or varjyam and amrit kaal. Those are left to your astrologer.
- MU-07classicalThe 8th sign, for one personFor one person, the API marks the part of a good window to skip. That is when the Moon is in the 8th sign from their birth Moon. It is also when the rising sign is the 8th from their own rising sign or Moon sign. The rest of the window is given as their best time. No published calendar covers this, so it is the classical rule as written.
- MU-08classicalThe day's star from your birth star (tara bala)Count from your birth star (the nakshatra the Moon was in when you were born) to the day's star, counted in groups of nine. Steps 2, 4, 6, 8 and 9 are good for a start. Steps 3, 5 and 7 are not. Step 1 is your birth star and its repeats, the 10th and 19th stars. These days are best avoided for big new starts like a wedding, a long trip or a new business. The birth star itself is the strictest. The 10th and 19th are milder, but still not good for a big start.
- MU-09classicalThe Moon's place from your birth Moon (chandra bala)Count the Moon's sign today from the sign it was in when you were born. The 1st, 3rd, 6th, 7th, 10th and 11th are strong. The 4th, 8th and 12th are weak. The 2nd, 5th and 9th are strong while the Moon is growing (shukla paksha) and weak while it is shrinking (krishna paksha). The API says which half decided it.
MS Muhurat for an activity 25
The rules a time window must pass before it is returned as a good time for an activity, such as buying a vehicle or a wedding.
- MS-01schoolThe nakshatra is one the activity allowsThe Moon's nakshatra (its star) must be one the activity allows. For a wedding, the first or last quarter of three stars is left out.
- MS-02schoolThe tithi is one the activity allowsThe tithi (lunar day) must be one the activity allows. Weddings do not use the tithi, and property allows all thirty.
- MS-03schoolThe weekday (sunrise to sunrise) is one the activity allowsThe weekday must be one the activity allows. A Hindu day runs from sunrise to sunrise, so the early hours belong to the day before.
- MS-04schoolNot in an adhika (leap) monthNo good time is given in an extra leap month (adhik maas). A naming ceremony is the one exception, since it falls due a set number of days after birth.
- MS-05schoolNot in Pitru Paksha, the dark half of Bhadrapada (amanta)Vehicles are not bought in Pitru Paksha, the two weeks for remembering ancestors.
- MS-06schoolThe window starts in daylight or within the first third of the nightSome activities may only start in daylight, or early in the night. Child ceremonies are held in daylight and end by sunset.
- MS-07inventionThe window lasts at least the activity's minimumA window shorter than a few minutes is not returned.
- MS-08schoolThe lunar month (amanta) is one the activity allowsMoving into a new home is allowed only in certain lunar months.
- MS-09schoolJupiter is not set (Guru asta)No good time is given while Jupiter is too close to the Sun to be seen, where the activity asks for it.
- MS-10schoolVenus is not set (Shukra asta)No good time is given while Venus is too close to the Sun to be seen, where the activity asks for it.
- MS-11schoolNot after a kshaya tithi or nakshatra – one that began and ended between the same two sunrises – on the same dayWhen a tithi or nakshatra starts and ends between two sunrises, the part of the day after it is not used.
- MS-12schoolThe Sun is in a sign the activity allows, for the whole dayWeddings, business starts and some child ceremonies (first haircut, start of learning, sacred thread) happen only while the Sun is in certain signs, for the whole day.
- MS-13schoolNot in Chaturmas (Devshayani to Prabodhini Ekadashi)No weddings or ear piercing in Chaturmas, the four months from Devshayani to Prabodhini Ekadashi.
- MS-14schoolThe yoga is not one the activity forbidsWeddings, business starts and child ceremonies skip the nine yogas (Sun and Moon combinations) that are seen as harmful. Travel skips the worst two.
- MS-15schoolThe karana is not one the activity forbidsWeddings, business starts, child ceremonies and travel skip certain karanas (half lunar days), such as Vishti, also called bhadra.
- MS-16classicalMercury is not retrogradeA business is not started while Mercury, the planet of trade, moves backward.
- MS-17classicalMercury is not combustA business is not started while Mercury is too close to the Sun.
- MS-18classicalThe rising sign (lagna) is of a nature the activity requiresA business starts only while a fixed rising sign (Taurus, Leo, Scorpio or Aquarius) is up.
- MS-19classicalOutside rahu kaalA business start skips rahu kaal. For the other activities rahu kaal is shown beside the window, not cut out.
- MS-20schoolWhere each activity's tables come fromThe rules for vehicles, property, moving home and weddings were read from a published calendar and checked window by window. The rules for business, travel and the child ceremonies are the classical ones and are not yet checked against a calendar.
- MS-21classicalTravel: the direction to avoid is named, not cutFor travel, each good time names one direction not to set out in that day (disha shool). It is not cut out, because only you know where you are going.
- MS-22schoolChild ceremonies: the age window comes firstEach child ceremony belongs to an age. With the child's birth details, only the time inside that age is searched. Days run from sunrise to sunrise, and the day of birth is day 1. A birth before sunrise counts from the day before. Months and years follow the Sun, counted from the time of birth. Naming is on the 11th or 12th day. First food is in the 6th, 8th or 10th month for a boy, and the 5th, 7th or 9th for a girl. First haircut is in the 1st, 3rd or 5th year. Ear piercing is on the 10th, 12th or 16th day, in the 6th, 7th or 8th month, or in the 1st, 3rd or 5th year. Start of learning is in the 5th year. The sacred thread is in the 5th or 8th, the 11th or the 12th year, as different traditions keep it. We never ask for caste.
- MS-23schoolVidyarambha: Vasant Panchami, and the 5th-5th-5th dayVasant Panchami is the best day of the year to start a child's learning. On that day the lunar day, weekday and star are not checked. Eclipses, the junction times around sunrise, sunset and a change of lunar day or star, and a troubled rising sign are still avoided. A rising sign is troubled when a harsh planet sits in it, or when any planet sits in the 8th sign from it. The 5th day of the 5th month of the child's 5th year is also marked as a special day.
- MS-24schoolNaming day checks only the rising signThe naming day is fixed by tradition, so on the 11th and 12th days the usual day checks are set aside. Only the rising sign is checked: the 8th sign from it must be empty, and no harsh planet may sit in it. Times inside rahu kaal or gulika kaal (two unlucky daily windows) are still removed. Times with good planets in strong houses are marked as better, but nothing is removed for lacking them. Jupiter and Venus always count as good. The Moon counts while it is bright, from the 8th day of the waxing half to the 5th day of the waning half. Mercury counts while no harsh planet shares its sign.
- MS-25schoolA naming day moved past the 12th dayA troubled rising sign is never forced just to fit the 11th or 12th day. If no time on those two days passes, the search keeps going, day by day, for the next day where the usual checks (lunar day, star, weekday and the child's own lucky and unlucky days) all pass, and the rising sign is clean. That day is shown separately, so you know it is not the 11th or 12th day. If no such day turns up within 60 days, you are asked to speak with your family astrologer.
PA Panchang 21
The panchang: the five parts of the Hindu day, the lunar month and season, and the daily windows such as rahu kaal.
- PA-01classicalTithiThe tithi, or lunar day, is each 12 degrees the Moon gains on the Sun: 30 tithis in a lunar month. Tithis 1 to 15 are the waxing half and 16 to 30 the waning half.
- PA-02classicalYogaThe panchang yoga comes from the sum of the Sun's and Moon's sidereal positions, in steps of 13 degrees 20 minutes: 27 yogas in all.
- PA-03classicalKaranaA karana is half a tithi, 6 degrees of the Moon's gain on the Sun: 60 in a lunar month. Seven karanas repeat eight times, and four fixed ones fall around the new moon.
- PA-04classicalVaraThe vara is the weekday and its ruling planet. A Vedic day runs from sunrise to sunrise.
- PA-05classicalNakshatra and padaThere are 27 nakshatras of 13 degrees 20 minutes each, and each is split into four padas of 3 degrees 20 minutes.
- PA-06schoolMasa (lunar month)The lunar month (masa) runs from one new moon to the next and is named for the Sun's sign change inside it. Leap months are found and named.
- PA-07schoolRitu (season)There are six seasons (ritus), each two signs of the season-based (tropical) zodiac long, because the seasons follow the equinoxes and the solstices. The season of the lunar month is given beside it. Festival dates keep the lunar months and do not move.
- PA-08schoolAyanaUttarayana is the half year after the Sun turns north, at the December solstice. Dakshinayana starts when it turns south, at the June solstice. The star-based (sidereal) reading, which turns at Makar Sankranti in mid-January, is given beside it.
- PA-09schoolRahu kaal, yamaganda, gulikaRahu kaal, yamaganda and gulika kaal: daylight from sunrise to sunset is split into eight equal parts. The weekday picks which part each one is.
- PA-10classicalAbhijit muhuratAbhijit muhurat is the 8th of the 15 daytime muhurats, the one around local noon, and is thought to be good for most new starts.
- PA-11schoolAnandadi yogasThere are 28 Anandadi yogas. Each one comes from counting the Moon's nakshatra (star) from a starting star set by the weekday. The count uses 28 stars, with Abhijit as the 28th. A new yoga starts when the Moon moves to the next star. Of the 28, 15 are good and 13 are not. Chara is one of the 13: some use it for travel, but it is not a good time to start important things. A yoga that is not good holds for its whole time, not only its first part.
- PA-12schoolSarvartha Siddhi and Amrit SiddhiSarvartha Siddhi forms when the weekday meets one of its listed stars. Amrit Siddhi is one special star for each weekday. When one lunar day set by the weekday runs with Amrit Siddhi, that time turns into Visha yoga, which is not suited to starting important things. It is listed as Visha, with a note saying what it replaced. Some calendars do not apply this and show the whole time as Amrit Siddhi; the API says when sources differ.
- PA-13classicalDwipushkar and TripushkarThese form on a Sunday, Tuesday or Saturday, with the 2nd, 7th or 12th lunar day, and the Moon in a star that is split across two signs. The kind of split decides which one it is.
- PA-14classicalRavi yogaRavi yoga forms when the Moon's star is the 4th, 6th, 9th, 10th, 13th or 20th star from the Sun's star.
- PA-15classicalGuru Pushya and Ravi PushyaGuru Pushya is a Thursday with the Moon in Pushya. Ravi Pushya is a Sunday with the Moon in Pushya.
- PA-16schoolDisha shool by weekdayDisha shool is the direction it is better not to start a trip toward. One rule sets it from the weekday. Two more rules, from the lunar day and from the Moon's star, are listed on their own below (PA-19, PA-20); none of the three is merged with another, so a day can flag more than one direction.
- PA-19schoolDisha shool by tithiA second disha shool rule: the lunar day (tithi) also forbids a direction. The same lunar day forbids the same direction in both halves of the month, with one pair of exceptions: the full moon day and the new moon day are sent to different directions. Every lunar day maps to one of eight directions, so this always applies for some part of the day.
- PA-20schoolDisha shool by nakshatraA third disha shool rule: the direction to avoid while the Moon is in one of four nakshatras (the Moon's star that day). They are Jyeshtha (east), Purva Bhadrapada (south), Rohini (west) and Uttara Phalguni (north). Most days are not affected, since only 4 of the 27 stars carry this rule.
- PA-17classicalChandrashtamaFor each of the 12 birth Moon signs, this shows when today the Moon is in the 8th sign from it. It uses the same rule as the personal muhurta check.
- PA-18classicalTimes are kept within the dayEvery day yoga runs from this sunrise to the next one, the length of the Hindu day. Times come from the same changes the panchang lists.
- PA-21schoolTwo sunrisesThe API uses two sunrises. For the birth chart it uses the moment the center of the Sun crosses the true horizon, without the bending of light by the air. This is the classical astrological sunrise. For calendars, festivals and muhurta windows it uses the moment the top of the Sun appears, the sunrise printed calendars show. The two are three to four minutes apart in India.
PR Which rule leads 8
How the readings decide which rule leads when two rules about the same subject differ. This part is not classical: the weights are the API's own, stated openly.
- PR-01inventionThese weights are not classicalNo classical text gives rules a numeric weight. The API uses its own stated weights only to decide which of two rules about the same subject leads in a reading.
- PR-02inventionSpecificity ladderA more specific rule leads: a rule that links two houses outranks a rule about a planet in a sign.
- PR-03inventionDignity weightsA rule about a strong planet outranks the same rule about a weak one.
- PR-04inventionHouse class weightsHouses are ranked by class, first match wins: trikona, then kendra, then dusthana.
- PR-05inventionAffliction and the final scoreA combust planet lowers a rule's rank, and the rank is the plain sum of its parts.
- PR-06inventionWhat the ranking does not claimRanking says which rule leads. It never claims one rule is true and the other false.
- PR-07inventionDrishti is reported and not scoredEach rule lists the planets that aspect the houses it concerns. Aspects are shown as labels and do not change the ranking.
- PR-08schoolUpachaya is scored on placement, not lordshipA malefic (harsh planet) sitting in house 3, 6, 10 or 11 raises a rule's rank, because malefics do well there. Ruling one of those houses does not count.
CON Edge cases we settled 3
Places where two parts of the API once gave different answers, and how each was settled.
- CON-01classicalThe nodes and the retrograde readingRahu and Ketu are always retrograde, so they do not trigger the retrograde reading, which would say the same thing for every chart. The API still reports them as retrograde.
- CON-02classicalA combust MoonA Moon within 12 degrees of the Sun is combust, and it gets a combust reading like any other planet.
- CON-03classicalA graha listed as both benefic and maleficNo planet is listed as both a benefic (helpful) and a malefic (harsh) planet for the same rising sign. When a planet rules both a trikona and a dusthana, the trikona wins. This holds for every rising sign where it happens.
GAP What the API does not compute 5
Rules an astrologer might expect and not find in the API, named here so their absence is clear.
- GAP-01gapDegree-based drishti and aspect strengthAspects are whole-house only. The API does not calculate degree-based aspects or partial aspect strength outside shadbala.
- GAP-04gapExaltation labels have no degreeA planet anywhere in its exaltation sign gets the label exalted. The exact degree is not part of that label. Shadbala does measure exaltation strength by degree (SB-02).
- GAP-05gapYogas the API does not checkThe API checks 97 named yogas. Classical texts describe many more yogas. The API does not look for them, so it never returns them.
- GAP-08classicalTwo mixed planets, now settledClosed. For a Leo rising sign, Jupiter rules both a trikona (house 5, a lucky house) and a dusthana (house 8, a house of effort). For a Virgo rising sign, Saturn rules both a trikona (house 5) and a dusthana (house 6). The API treats each of them as benefic (helpful) for that sign and never as malefic (harsh), the same as every other planet that rules both kinds of house (CON-03).
- GAP-07gapConjunction means same sign, with no orbTwo planets count as together (conjunct) when they are in the same sign, however far apart in degrees. Two planets a few minutes apart across a sign boundary do not count.
Think a rule is wrong?
Tell us and give its ID, for example "DO-01 is wrong". We check every report and reply.
Astrology API
Every answer follows a published rule
Create a free test key and compare any response with the rule behind it. Or try a request in the API reference first.
Your first answer
John Doe, New York
- RisingVirgoHast
- SunCancerAshlesha
- MoonTaurusMrigashira
- MarsAriesKrittika
Real API output. A free test key gets the same answer.
01
Test key: 1,000 test calls a month to build with
02
Free plan: 2,000 live calls a month, no card needed
03
Open rules: every rule is published, so you can check any answer