New Numerology API

Nakshatras

Sub lord (KP) in Vedic astrology

In KP astrology, a sub lord is the planet that rules a sub, one of the nine parts of each nakshatra. KP reads the sub lord of a planet or a house cusp as the deciding factor for its results.

Updated

More terms in Nakshatras

© API for Astrology (apiforastrology.com). "Glossary wheel". All rights reserved. Not to be copied or reused.27 nakshatrasequal slicesEach nakshatra is 13 degrees 20 minutes

Sub lord: what it means and how the API computes it

The nine subs of a nakshatra are not equal. Their sizes follow the Vimshottari dasha years, starting from the nakshatra's own lord (KP-02). So the Venus sub, with 20 years, is the widest, and the Sun sub, with 6, the narrowest.

Six subs cross from one sign into the next, so the zodiac holds 249 pieces, not 243. Each piece comes back with its number in sub_number, from 1 to 249. A person picks one of these numbers for a KP horary question on POST /v1/prashna/kp.

Every time the API starts, it checks that the 249 pieces cover the zodiac exactly. Each sub is split the same way again for the sub-sub lord (KP-03). POST /v1/kp gives the sign lord, star lord, sub lord and sub-sub lord of every planet and every cusp.

For John Doe, the first cusp is at 20 degrees of Virgo. Its star lord is the Moon and its sub lord is Ketu. His Moon has Mars as its star lord and Rahu as its sub lord.

Get it from the API

Krishnamurti Paddhati: cusps, sub lords, significators. Here is the call to API for Astrology (apiforastrology.com) for our sample, John Doe, born Aug 15, 1990, 10:30 AM, New York.

POST /v1/kp

# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/kp" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Answer (long lists shortened)200 OK
{
  "ayanamsa": {
    "name": "Krishnamurti (KP)",
    "value": 23.6292203,
    "degree_dms": "23 : 37 : 45",
    "lahiri_minus_kp": 0.0968524
  },
  "house_system": "Placidus",
  "cusps": [
    {
      "cusp": 1,
      "longitude": 170.0310074,
      "degree_in_sign": 20.0310074,
      "degree_dms": "20 : 01 : 52",
      "sign": "Virgo",
      "sign_number": 6,
      "sign_lord": "Mercury",
      "nakshatra": "Hast",
      "star_lord": "Moon",
      "sub_lord": "Ketu",
      "sub_sub_lord": "Rahu",
      "sub_number": 118
    },
    {
      "cusp": 2,
      "longitude": 197.1046796,
      "degree_in_sign": 17.1046796,
      "degree_dms": "17 : 06 : 17",
      "sign": "Libra",
      "sign_number": 7,
      "sign_lord": "Venus",
      "nakshatra": "Swati",
      "star_lord": "Rahu",
      "sub_lord": "Venus",
      "sub_sub_lord": "Mercury",
      "sub_number": 135
    },
    {
      "cusp": 3,
      "longitude": 228.2508656,
      "degree_in_sign": 18.2508656,
      "degree_dms": "18 : 15 : 03",
      "sign": "Scorpio",
      "sign_number": 8,
      "sign_lord": "Mars",
      "nakshatra": "Jyeshtha",
      "star_lord": "Mercury",
      "sub_lord": "Mercury",
      "sub_sub_lord": "Jupiter",
      "sub_number": 158
    }
  ],
  "planets": [
    {
      "graha": "Sun",
      "longitude": 118.8721933,
      "degree_in_sign": 28.8721933,
      "degree_dms": "28 : 52 : 20",
      "sign": "Cancer",
      "sign_number": 4,
      "sign_lord": "Moon",
      "nakshatra": "Ashlesha",
      "star_lord": "Mercury",
      "sub_lord": "Saturn",
      "sub_sub_lord": "Venus",
      "sub_number": 83,
      "house": 11,
      "retrograde": false
    },
    {
      "graha": "Moon",
      "longitude": 54.6718876,
      "degree_in_sign": 24.6718876,
      "degree_dms": "24 : 40 : 19",
      "sign": "Taurus",
      "sign_number": 2,
      "sign_lord": "Venus",
      "nakshatra": "Mrigashira",
      "star_lord": "Mars",
      "sub_lord": "Rahu",
      "sub_sub_lord": "Jupiter",
      "sub_number": 39,
      "house": 9,
      "retrograde": false
    },
    {
      "graha": "Mars",
      "longitude": 27.8117852,
      "degree_in_sign": 27.8117852,
      "degree_dms": "27 : 48 : 42",
      "sign": "Aries",
      "sign_number": 1,
      "sign_lord": "Mars",
      "nakshatra": "Krittika",
      "star_lord": "Sun",
      "sub_lord": "Moon",
      "sub_sub_lord": "Saturn",
      "sub_number": 20,
      "house": 8,
      "retrograde": false
    }
  ],
  "significators": {
    "by_house": {
      "1": {
        "in_star_of_occupants": [],
        "occupants": [],
        "in_star_of_cusp_lord": [
          "Sun"
        ],
        "cusp_lord": "Mercury"
      },
      "2": {
        "in_star_of_occupants": [],
        "occupants": [],
        "in_star_of_cusp_lord": [
          "Mercury",
          "Saturn"
        ],
        "cusp_lord": "Venus"
      },
      "3": {
        "in_star_of_occupants": [],
        "occupants": [],
        "in_star_of_cusp_lord": [
          "Moon"
        ],
        "cusp_lord": "Mars"
      },
      "4": {
        "in_star_of_occupants": [
          "Jupiter",
          "Venus",
          "Ketu"
        ],
        "occupants": [
          "Saturn",
          "Rahu"
        ],
        "in_star_of_cusp_lord": [],
        "cusp_lord": "Jupiter"
      },
      "5": {
        "in_star_of_occupants": [],
        "occupants": [],
        "in_star_of_cusp_lord": [
          "Jupiter",
          "Venus",
          "Ketu"
        ],
        "cusp_lord": "Saturn"
      },
      "6": {
        "in_star_of_occupants": [],
        "occupants": [],
        "in_star_of_cusp_lord": [
          "Jupiter",
          "Venus",
          "Ketu"
        ],
        "cusp_lord": "Saturn"
      },
      "7": {
        "in_star_of_occupants": [],
        "occupants": [],
        "in_star_of_cusp_lord": [],
        "cusp_lord": "Jupiter"
      },
      "8": {
        "in_star_of_occupants": [
          "Moon"
        ],
        "occupants": [
          "Mars"
        ],
        "in_star_of_cusp_lord": [
          "Moon"
        ],
        "cusp_lord": "Mars"
      },
      "9": {
        "in_star_of_occupants": [
          "Rahu"
        ],
        "occupants": [
          "Moon"
        ],
        "in_star_of_cusp_lord": [
          "Mercury",
          "Saturn"
        ],
        "cusp_lord": "Venus"
      },
      "10": {
        "in_star_of_occupants": [
          "Mercury",
          "Saturn"
        ],
        "occupants": [
          "Jupiter",
          "Venus",
          "Ketu"
        ],
        "in_star_of_cusp_lord": [
          "Sun"
        ],
        "cusp_lord": "Mercury"
      },
      "11": {
        "in_star_of_occupants": [
          "Mars"
        ],
        "occupants": [
          "Sun"
        ],
        "in_star_of_cusp_lord": [
          "Rahu"
        ],
        "cusp_lord": "Moon"
      },
      "12": {
        "in_star_of_occupants": [
          "Sun"
        ],
        "occupants": [
          "Mercury"
        ],
        "in_star_of_cusp_lord": [
          "Mars"
        ],
        "cusp_lord": "Sun"
      }
    },
    "by_planet": {
      "Sun": {
        "in_star_of_occupants": [
          12
        ],
        "occupants": [
          11
        ],
        "in_star_of_cusp_lord": [
          1,
          10
        ],
        "cusp_lord": [
          12
        ],
        "all": [
          1,
          10,
          11
        ]
      },
      "Moon": {
        "in_star_of_occupants": [
          8
        ],
        "occupants": [
          9
        ],
        "in_star_of_cusp_lord": [
          3,
          8
        ],
        "cusp_lord": [
          11
        ],
        "all": [
          3,
          8,
          9
        ]
      },
      "Mars": {
        "in_star_of_occupants": [
          11
        ],
        "occupants": [
          8
        ],
        "in_star_of_cusp_lord": [
          12
        ],
        "cusp_lord": [
          3,
          8
        ],
        "all": [
          3,
          8,
          11
        ]
      },
      "Mercury": {
        "in_star_of_occupants": [
          10
        ],
        "occupants": [
          12
        ],
        "in_star_of_cusp_lord": [
          2,
          9
        ],
        "cusp_lord": [
          1,
          10
        ],
        "all": [
          1,
          2,
          9
        ]
      },
      "Jupiter": {
        "in_star_of_occupants": [
          4
        ],
        "occupants": [
          10
        ],
        "in_star_of_cusp_lord": [
          5,
          6
        ],
        "cusp_lord": [
          4,
          7
        ],
        "all": [
          4,
          5,
          6
        ]
      },
      "Venus": {
        "in_star_of_occupants": [
          4
        ],
        "occupants": [
          10
        ],
        "in_star_of_cusp_lord": [
          5,
          6
        ],
        "cusp_lord": [
          2,
          9
        ],
        "all": [
          2,
          4,
          5
        ]
      },
      "Saturn": {
        "in_star_of_occupants": [
          10
        ],
        "occupants": [
          4
        ],
        "in_star_of_cusp_lord": [
          2,
          9
        ],
        "cusp_lord": [
          5,
          6
        ],
        "all": [
          2,
          4,
          5
        ]
      },
      "Rahu": {
        "in_star_of_occupants": [
          9
        ],
        "occupants": [
          4
        ],
        "in_star_of_cusp_lord": [
          11
        ],
        "cusp_lord": [],
        "all": [
          4,
          9,
          11
        ]
      },
      "Ketu": {
        "in_star_of_occupants": [
          4
        ],
        "occupants": [
          10
        ],
        "in_star_of_cusp_lord": [
          5,
          6
        ],
        "cusp_lord": [],
        "all": [
          4,
          5,
          6
        ]
      }
    },
    "levels": [
      "in_star_of_occupants",
      "occupants",
      "in_star_of_cusp_lord"
    ]
  },
  "ruling_planets": {
    "day_lord": "Mercury",
    "lagna_sign_lord": "Mercury",
    "lagna_star_lord": "Moon",
    "lagna_sub_lord": "Ketu",
    "moon_sign_lord": "Venus",
    "moon_star_lord": "Mars",
    "moon_sub_lord": "Rahu",
    "grahas": [
      "Mercury",
      "Moon",
      "Ketu"
    ],
    "for": "birth moment",
    "at": "1990-08-15T10:30:00"
  },
  "part_of_fortune": {
    "point": "part_of_fortune",
    "longitude": 105.8307017,
    "degree_in_sign": 15.8307017,
    "degree_dms": "15 : 49 : 51",
    "sign": "Cancer",
    "sign_number": 4,
    "sign_lord": "Moon",
    "nakshatra": "Pushya",
    "star_lord": "Saturn",
    "sub_lord": "Jupiter",
    "sub_sub_lord": "Venus",
    "sub_number": 74,
    "house": 10,
    "formula": "ascendant + moon - sun",
    "sun_above_horizon": true,
    "sources_agree": true,
    "other_formula": {
      "formula": "ascendant + sun - moon",
      "used_by": "Western and Tajik practice, for night births only",
      "applies_here": false
    }
  },
  "not_computed": {
    "significator_grading": "KP software often grades each house a planet signifies from \"very strong\" to \"weak\". The weights behind those grades differ between programs and none comes from Krishnamurti, so the four levels are returned as lists and not scored.",
    "node_agency": "In KP, Rahu and Ketu also give the results of the sign lord and of planets joined with or aspecting them. Sources differ on which associations count, so the nodes are listed only where they themselves occupy a house or sit in a star.",
    "ruling_planets_now": "The ruling planets here are for the birth moment only. For the moment a question is asked, use `POST /v1/prashna/kp`.",
    "horary_numbers": "This route takes no horary number (a number from 1 to 249 chosen by the person asking). `sub_number` only says which of the 249 pieces a point falls in. For a horary number, use `POST /v1/prashna/kp`."
  },
  "meta": {
    "ayanamsa": "krishnamurti",
    "ayanamsa_value": 23.6292203,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

Where the API returns it

POST/v1/kpKrishnamurti Paddhati: cusps, sub lords, significators
POST/v1/prashna/kpKP horary: a question read from a number between 1 and 249

What the API reference says

Each line is quoted from the reference page of the endpoint named above it.

  • POST /v1/kp · Krishnamurti Paddhati: cusps, sub lords, significatorsEach sub is divided the same way again for the sub-sub lord.
  • POST /v1/prashna/kp · KP horary: a question read from a number between 1 and 249chart.cusps gives the sign, star and sub lord of all 12 cusps.
  • kp endpointsEach planet and cusp gets its sign, star and sub lords, and each house gets its significators (the planets that deliver its results).

Feature page: Kundli and birth charts. Who uses it: Astrologer consultation platforms. The classical rules the API follows are in the rulebook.

How we check the numbers

Every value here starts from planet positions worked out from NASA JPL planet data (DE440). We test them against NASA JPL Horizons, NASA's planet position service. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. On 2,000 random birth charts, the rising sign agrees with Swiss Ephemeris within 0.004 arc seconds. An arc second is 1/3,600 of a degree. A practicing astrologer reviews the rules behind these answers. See how we test.

Related terms

Free tools

See it with your own details

Runs on the same API call. Enter your details and see the answer in your browser.

  • Nakshatra finder

    Your birth star: the Moon's nakshatra, its quarter (pada), its ruler and your Moon sign.

    Find my nakshatra

From the blog

Astrology API

Get these values from the API

Create a free test key and call any endpoint on this page. Or try a request in the API reference first.

Your first answer

John Doe, New York

POST /v1/planets200 OK
  • RisingVirgoHast
  • SunCancerAshlesha
  • MoonTaurusMrigashira
  • MarsAriesKrittika

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    Open rules: every rule is published, so you can check any answer