In Jaimini astrology, the atmakaraka is whichever planet sits deepest inside the sign it is in. Jaimini is the second classical school of Vedic astrology. Its karakas are planets that each stand for one part of life. The chara karakas get their roles by degree, so the roles change from chart to chart.

The method is short. Take the seven planets from the Sun to Saturn. Read each one's degree inside its sign, from 0 to 30, and ignore the sign itself. Sort them from high to low. The top planet is the atmakaraka, the planet for the self. The next six take the other roles in a fixed order.

John Doe was born on Aug 15, 1990, at 10:30 AM in New York. His Sun sat at 28°46′ of Cancer, the highest degree of the seven. So the Sun is his atmakaraka. Mars, at 27°43′ of Aries, comes second. Jupiter, at 5°41′ of Cancer, comes last.

Two things can change the answer. Some schools add Rahu as an eighth planet. And the ranking rests on exact degrees, so the birth time matters. We ran 300 random births through our API to measure both. A one-hour birth-time error changed the atmakaraka in 7.3% of charts. Adding Rahu changed it in 10.7%.

How the ranking works for John

Here are John's seven chara karakas from POST /v1/jaimini, with each planet's degree from POST /v1/planets.

Rank

Role

Stands for

Planet

Degree in its sign

1

Atmakaraka

the self

Sun

28°46′31″ Cancer

2

Amatyakaraka

career and advisers

Mars

27°42′54″ Aries

3

Bhratrikaraka

brothers and sisters

Saturn

26°07′32″ Sagittarius

4

Matrikaraka

the mother

Mercury

25°44′56″ Leo

5

Putrakaraka

children

Moon

24°34′30″ Taurus

6

Gnatikaraka

rivals and relatives

Venus

8°19′33″ Cancer

7

Darakaraka

the spouse

Jupiter

5°41′30″ Cancer

The sign plays no part. Venus and Jupiter share Cancer with the Sun, yet they rank last, because they sit early in the sign. Saturn was retrograde, which means it seemed to move backward that day. It still ranks by its plain degree. Rule JM-01 of our rulebook states the method.

One detail matters when you build the screen. The chara_karakas object in the answer lists roles and planets only. It does not repeat the degrees. Get those from POST /v1/planets with the same birth details, in the degree_in_sign field. In all 300 test births, the API's atmakaraka matched the highest degree_in_sign from /v1/planets.

John's lead is thin. The Sun is only 1.06° ahead of Mars. The glossary entry for atmakaraka covers what the role means. The rest of this post is about how stable it is.

Seven karakas or eight: where Rahu fits

Our API uses the seven-karaka scheme and leaves Rahu out. Some astrologers use eight karakas, with Rahu added. Rahu is not a physical planet. It is one of the two points where the Moon's path crosses the Sun's path, and it moves backward through the zodiac. So the eight-karaka scheme counts its degree backward, as 30 minus its degree.

John's Rahu sat at 13°30′49″ of Capricorn. As an eighth karaka it scores 30 − 13.51 = 16.49. That puts it 6th of 8. The Sun stays the atmakaraka, and the top five planets keep their ranks. Venus and Jupiter each drop one place. The eight-karaka list also has one more role. So the role names below Rahu do not line up between the two schemes.

Bar chart of John Doe's seven planets ranked by degree within their sign, with the Sun first at 28.78 degrees, and Rahu shown in sixth place at 16.49 degrees under the eight-karaka scheme

We ranked our 300 test births both ways, using the same degrees from /v1/planets.

What we measured, 300 births

Result

Rahu ranks 1st, so the atmakaraka changes

32 births (10.7%)

Rahu's place, from 1st to 8th

Each place got between 32 and 48 births

Eight karakas: atmakaraka changes between the true and mean node

15 births (5.0%)

Seven karakas: atmakaraka changes between the true and mean node

0 births

The node is the second hidden choice. Rahu's position can be the true node (its actual position) or the mean node (an averaged one). Our API takes a node field, and the true node is the default. Under seven karakas the node never matters, because Rahu is not ranked. John's seven karakas came back the same with "node": "mean".

So a chart read under seven karakas and a chart read under eight will disagree on the atmakaraka about 1 time in 10. Neither is a bug. If your users compare your app with other software, say which scheme you use.

How often a birth-time error swaps the atmakaraka

Next, we measured what a small error in birth time does. We picked 300 random births in New York, from 1950 to 2009, at random times between 4 AM and 11 PM. For each one, we asked /v1/jaimini for the atmakaraka at the birth time. Then we asked again at set minutes earlier and later.

Birth time off by

Atmakaraka changed

5 minutes either way

1 of 300 (0.3%)

15 minutes either way

4 of 300 (1.3%)

30 minutes either way

10 of 300 (3.3%)

60 minutes either way

22 of 300 (7.3%)

The Moon causes most of the swaps. It was one of the two planets in 18 of the 22 swaps within an hour. On John's birthday, the Moon moved 14.26° a day. The next fastest of the seven, Venus, moved 1.22° a day.

A small gap alone is a weak warning sign. In 58 of the 300 charts, the top two planets were less than 1° apart. Only 12 of those 58 swapped within an hour. A close gap between two slow planets barely moves in an hour. A gap the Moon is closing can be gone within the hour.

John's birth day, change by change

To see this in one chart, we asked /v1/jaimini every 10 minutes across John's birth date. Then we narrowed each change to the minute.

Time on Aug 15, 1990

What changed

12:00 AM to 12:35 PM

Nothing. All seven roles match the 10:30 AM chart

12:36 PM

The Moon passes Mercury: Moon becomes matrikaraka, Mercury putrakaraka

1:06 PM

The Moon passes Saturn and becomes bhratrikaraka

4:01 PM

The Moon passes Mars and becomes amatyakaraka

6:05 PM

The Moon passes the Sun and becomes the atmakaraka

7:39 PM

The Moon enters Gemini at 0°, drops to darakaraka, and the Sun is atmakaraka again

9:52 PM

Mercury passes Saturn, which is moving backward

John's atmakaraka holds from midnight to 6:04 PM. His birth would have to be about 7.5 hours later than recorded to change it. His lower roles are closer calls. The matrikaraka and putrakaraka swap just 2 hours and 6 minutes after his recorded time.

The Moon's path explains most of the table. It climbs the list as it crosses a sign. Then it drops to last place the moment it enters the next sign.

What else POST /v1/jaimini returns

Here is what one call to /v1/jaimini returned for John.

Field

What it holds

John's answer

chara_karakas

The seven roles and their planets

Sun is the atmakaraka

padas

The 12 arudha padas, A1 to A12: how each house appears to others

A1 (arudha lagna) is Cancer, A12 (upapada lagna) is Gemini

rashi_drishti

Sign aspects: which signs each sign looks at, with no planet involved

One entry per sign, with a short reading

argala

Pulls on each sign from planets in the 2nd, 4th and 11th signs from it

18 found, 5 of them blocked

argala_readings

Reading text for the pulls on the rising sign and the arudha lagna

4 readings

chara_dasha

Periods counted in signs, with the working for each one, and the same periods with dates

12 periods, 55 years in all; 144 years with dates

Add ?lang=hi to get the reading text in Hindi. The planet and sign names come back translated too.

Arudha lagna and chara dasha, worked for John

The arudha lagna is the image of the self, the way others see a person. Rule JM-02 finds it in two counts. John's rising sign is Virgo. Its ruler, Mercury, sits in Leo, the 12th sign counted from Virgo. Count 12 signs again from Leo, and you land on Cancer. The rule has two exceptions: the count may not land on the rising sign or on the 7th sign from it. Cancer is neither, so A1 is Cancer. The arudha lagna entry explains why those exceptions trip up software.

Chara dasha is the main Jaimini period system, and its periods belong to signs. For John, it starts from his rising sign, Virgo. The sign in his 9th house is Taurus, so the periods run forward through the zodiac. Each period lasts 1 to 12 years. Virgo gets 1 year, Libra 9 and Scorpio 8. Aries gets 12, because its ruler, Mars, sits in Aries itself.

Each period in periods gives its length and when it starts, counted in years after birth (starts_after_years). Each one also carries a why line, such as Mars occupies its own sign, which gives twelve. The dated part gives calendar dates, under rule JM-09. It adds a second round of periods, for 144 years in all, and splits each period into 12 sub-periods. For John, the 12-year Aries period starts on Aug 15, 2026. Chara dasha has several versions. The API uses the common Parashari form, set out in rule JM-06, and shows its working so a reader can check it.

Some Jaimini parts are not computed yet. Rule JM-08 lists them, including the third level of chara dasha periods. The karakamsa, the atmakaraka's sign in the navamsa (D9) chart, comes from POST /v1/karma.

What to build into a Jaimini screen

Show the degree next to each role. A user who sees "Sun 28°46′, Mars 27°43′" can see how close the race is. A bare list of names hides it.

Flag close calls by asking twice more. If your user's birth time may be off, ask /v1/jaimini at the margin on both sides, such as 30 minutes earlier and later. If the atmakaraka differs, tell the user it depends on the exact birth time. Our test says this flag fires for about 3% of charts at 30 minutes.

Banner that reads "Karakas, arudha padas and chara dasha in one call" and links to the Jaimini astrology API page

Name the scheme on the screen. A short line, "Seven karakas, Rahu not included", tells a user who compares apps what you computed.

See everything the API returns on our Jaimini astrology API page. Each role is defined in the chara karaka glossary entry.

Get John's karakas from the API

Send the birth details to POST /v1/jaimini. Here is the request for John Doe, born Aug 15, 1990, at 10:30 AM in New York:

{
  "year": 1990,
  "month": 8,
  "day": 15,
  "hour": 10,
  "minute": 30,
  "latitude": 40.7128,
  "longitude": -74.006,
  "timezone": "America/New_York"
}

And here is part of the answer, with the long lists and reading text left out:

{
  "meta": { "ayanamsa": "lahiri", "node": "true" },
  "chara_karakas": {
    "Atmakaraka": "Sun",
    "Amatyakaraka": "Mars",
    "Bhratrikaraka": "Saturn",
    "Matrikaraka": "Mercury",
    "Putrakaraka": "Moon",
    "Gnatikaraka": "Venus",
    "Darakaraka": "Jupiter"
  },
  "padas": {
    "A1": { "sign": "Cancer", "name": "Arudha Lagna" },
    "A12": { "sign": "Gemini", "name": "Upapada Lagna" }
  },
  "chara_dasha": {
    "direction": "direct",
    "direction_rule": "the 9th house holds Taurus, so the dasha runs zodiacally",
    "cycle_years": 55
  }
}

For every field and its type, see the Jaimini section of the API reference.

Banner that reads "Every field of /v1/jaimini, with its type" and links to the Jaimini section of the API reference

The ranking itself is one sort by degree. For John, it holds for 7.5 hours, while his matrikaraka holds for about 2. A screen that shows the degrees and names the scheme lets a user see which kind of answer they have.