KP Astrology API
Generate complete KP birth chart
Included with every plan (at no extra cost)
Generate authentic Krishnamurti Paddhati birth charts with Placidus house cusps, star-lord and sub-lord calculations. Supports custom ayanamsa and dynamic KP-Newcomb ayanamsa calculation. Returns complete chart with all 9 planets (Sun through Ketu), Ascendant, 12 Placidus house cusps, nakshatra details, star-lords, sub-lords, and KP horary numbers (1-249). Perfect for KP astrology software, horary prediction apps, and event timing analysis. One call is a complete Krishnamurti Paddhati chart generator, returning the Placidus cusps and the planets with their sub lords together.
Location first, chart second
The KP Astrology API needs latitude, longitude, and timezone. Never ask users to type coordinates. Resolve a city with the Location endpoint first, then feed the result into the request. Timezone accepts a decimal offset or an IANA name.
1 Resolve the location
curl "https://roxyapi.com/api/v2/location/search?q=New York" \
-H "X-API-Key: YOUR_KEY"
# -> cities[0]: { latitude, longitude, timezone: "America/New_York" }2 Call the KP Astrology endpoint
# feed latitude, longitude and timezone from step 1
POST https://roxyapi.com/api/v2/vedic-astrology/kp/chartRequest
POST /api/v2/vedic-astrology/kp/chart
Parameters
| Parameter | Type | Description |
|---|---|---|
| langquery | string enum | Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default en. |
| focusquery | string enum | Which signification vocabulary the houseThemes map returns. "general" gives the classical bhava significations (self, wealth, siblings, home, and so on). "finance" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use "finance" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to "general". Default general. |
Request body
| Field | Type | Description |
|---|---|---|
| date* | string (date) | Birth date in YYYY-MM-DD format |
| time* | string (time) | Birth time in 24-hour HH:MM:SS format. CRITICAL for accurate Lagna and house calculations. |
| latitude* | number | Birth location latitude in decimal degrees |
| longitude* | number | Birth location longitude in decimal degrees |
| timezone | number or string | Timezone: an IANA name (e.g. "America/New_York", "Europe/London", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5 (IST) for Vedic astrology. |
| ayanamsa | string enum | Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula (most common for KP). "kp-old" uses the Krishnamurti original table. "lahiri" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa, about 1.45 degrees below Lahiri. "custom" allows providing your own value via ayanamsaValue. Defaults to "kp-newcomb". |
| ayanamsaValue | number | Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source. |
| nodeType | string enum | Lunar node convention. "mean" is the smoothed average node, which always moves retrograde; "true" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the Rahu and Ketu positions. Mean is the traditional Vedic default and what printed panchangs use; the choice can move a KP sub-lord in narrow boundary cases, where a span can be as small as 0.5 degrees. Defaults to "mean". |
Example request
{
"date": "1990-07-04",
"time": "10:12:00",
"latitude": 28.6139,
"longitude": 77.209,
"timezone": 5.5,
"ayanamsa": "kp-newcomb",
"ayanamsaValue": 24,
"nodeType": "mean"
}Response
Structured JSON with documented fields, covered by 13,405 automated tests per deploy, 3,620 of them gold-standard tests verified against NASA JPL Horizons. Not hallucinated text.
{
"meta": {
"date": "1990-07-04",
"time": "10:12:00",
"latitude": 28.6139,
"longitude": 77.209,
"timezone": 5.5,
"ayanamsa": 23.63165604,
"ayanamsaType": "kp-newcomb",
"houseSystem": "placidus"
},
"ascendant": {
"longitude": 138.4753,
"sign": "Leo",
"signLord": "Sun",
"nakshatra": "Purva Phalguni",
"nakshatraLord": "Venus",
"pada": 2,
"starLord": "Venus",
"subLord": "Rahu",
"subSubLord": "Jupiter",
"kpNumber": 97
},
"cusps": [
{
"house": 1,
"longitude": 138.4753,
"sign": "Leo",
"signLord": "Sun",
"nakshatra": "Purva Phalguni",
"nakshatraLord": "Venus",
"pada": 2,
"starLord": "Venus",
"subLord": "Rahu",
"subSubLord": "Jupiter",
"kpNumber": 97
},
{
"house": 2,
"longitude": 165.444,
"sign": "Virgo",
"signLord": "Mercury",
"nakshatra": "Hasta",
"nakshatraLord": "Moon",
"pada": 2,
"starLord": "Moon",
"subLord": "Jupiter",
"subSubLord": "Rahu",
"kpNumber": 115
},
{
"house": 3,
"longitude": 195.6893,
"sign": "Libra",
"signLord": "Venus",
"nakshatra": "Swati",
"nakshatraLord": "Rahu",
"pada": 3,
"starLord": "Rahu",
"subLord": "Venus",
"subSubLord": "Sun",
"kpNumber": 135
},
{
"house": 4,
"longitude": 227.5736,
"sign": "Scorpio",
"signLord": "Mars",
"nakshatra": "Jyeshtha",
"nakshatraLord": "Mercury",
"pada": 1,
"starLord": "Mercury",
"subLord": "Mercury",
"subSubLord": "Moon",
"kpNumber": 158
},
{
"house": 5,
"longitude": 259.3175,
"sign": "Sagittarius",
"signLord": "Jupiter",
"nakshatra": "Purva Ashadha",
"nakshatraLord": "Venus",
"pada": 2,
"starLord": "Venus",
"subLord": "Rahu",
"subSubLord": "Ketu",
"kpNumber": 180
},
{
"house": 6,
"longitude": 289.8594,
"sign": "Capricorn",
"signLord": "Saturn",
"nakshatra": "Shravana",
"nakshatraLord": "Moon",
"pada": 3,
"starLord": "Moon",
"subLord": "Ketu",
"subSubLord": "Sun",
"kpNumber": 201
},
{
"house": 7,
"longitude": 318.4753,
"sign": "Aquarius",
"signLord": "Saturn",
"nakshatra": "Shatabhisha",
"nakshatraLord": "Rahu",
"pada": 4,
"starLord": "Rahu",
"subLord": "Moon",
"subSubLord": "Jupiter",
"kpNumber": 220
},
{
"house": 8,
"longitude": 345.444,
"sign": "Pisces",
"signLord": "Jupiter",
"nakshatra": "Uttara Bhadrapada",
"nakshatraLord": "Saturn",
"pada": 4,
"starLord": "Saturn",
"subLord": "Jupiter",
"subSubLord": "Mercury",
"kpNumber": 240
},
{
"house": 9,
"longitude": 15.6893,
"sign": "Aries",
"signLord": "Mars",
"nakshatra": "Bharani",
"nakshatraLord": "Venus",
"pada": 1,
"starLord": "Venus",
"subLord": "Sun",
"subSubLord": "Rahu",
"kpNumber": 11
},
{
"house": 10,
"longitude": 47.5736,
"sign": "Taurus",
"signLord": "Venus",
"nakshatra": "Rohini",
"nakshatraLord": "Moon",
"pada": 3,
"starLord": "Moon",
"subLord": "Saturn",
"subSubLord": "Jupiter",
"kpNumber": 33
},
{
"house": 11,
"longitude": 79.3175,
"sign": "Gemini",
"signLord": "Mercury",
"nakshatra": "Ardra",
"nakshatraLord": "Rahu",
"pada": 4,
"starLord": "Rahu",
"subLord": "Mars",
"subSubLord": "Rahu",
"kpNumber": 55
},
{
"house": 12,
"longitude": 109.8594,
"sign": "Cancer",
"signLord": "Moon",
"nakshatra": "Ashlesha",
"nakshatraLord": "Mercury",
"pada": 1,
"starLord": "Mercury",
"subLord": "Venus",
"subSubLord": "Moon",
"kpNumber": 77
}
],
"planets": [
{
"planet": "Sun",
"longitude": 78.3377,
"sign": "Gemini",
"signLord": "Mercury",
"house": 10,
"nakshatra": "Ardra",
"nakshatraLord": "Rahu",
"pada": 4,
"starLord": "Rahu",
"subLord": "Moon",
"subSubLord": "Rahu",
"kpNumber": 54,
"retrograde": false
},
{
"planet": "Moon",
"longitude": 215.4323,
"sign": "Scorpio",
"signLord": "Mars",
"house": 3,
"nakshatra": "Anuradha",
"nakshatraLord": "Saturn",
"pada": 1,
"starLord": "Saturn",
"subLord": "Saturn",
"subSubLord": "Jupiter",
"kpNumber": 149,
"retrograde": false
},
{
"planet": "Mars",
"longitude": 0.6114,
"sign": "Aries",
"signLord": "Mars",
"house": 8,
"nakshatra": "Ashwini",
"nakshatraLord": "Ketu",
"pada": 1,
"starLord": "Ketu",
"subLord": "Ketu",
"subSubLord": "Saturn",
"kpNumber": 1,
"retrograde": false
},
{
"planet": "Mercury",
"longitude": 80.1291,
"sign": "Gemini",
"signLord": "Mercury",
"house": 11,
"nakshatra": "Punarvasu",
"nakshatraLord": "Jupiter",
"pada": 1,
"starLord": "Jupiter",
"subLord": "Jupiter",
"subSubLord": "Jupiter",
"kpNumber": 56,
"retrograde": false
},
{
"planet": "Jupiter",
"longitude": 86.3841,
"sign": "Gemini",
"signLord": "Mercury",
"house": 11,
"nakshatra": "Punarvasu",
"nakshatraLord": "Jupiter",
"pada": 2,
"starLord": "Jupiter",
"subLord": "Ketu",
"subSubLord": "Saturn",
"kpNumber": 59,
"retrograde": false
},
{
"planet": "Venus",
"longitude": 47.2734,
"sign": "Taurus",
"signLord": "Venus",
"house": 9,
"nakshatra": "Rohini",
"nakshatraLord": "Moon",
"pada": 3,
"starLord": "Moon",
"subLord": "Saturn",
"subSubLord": "Rahu",
"kpNumber": 33,
"retrograde": false
},
{
"planet": "Saturn",
"longitude": 269.1613,
"sign": "Sagittarius",
"signLord": "Jupiter",
"house": 5,
"nakshatra": "Uttara Ashadha",
"nakshatraLord": "Sun",
"pada": 1,
"starLord": "Sun",
"subLord": "Mars",
"subSubLord": "Moon",
"kpNumber": 187,
"retrograde": true
}
],
"nodes": {
"rahu": {
"longitude": 285.0764,
"sign": "Capricorn",
"signLord": "Saturn",
"house": 5,
"nakshatra": "Shravana",
"pada": 2,
"starLord": "Moon",
"subLord": "Jupiter",
"subSubLord": "Sun",
"kpNumber": 198
},
"ketu": {
"longitude": 105.0764,
"sign": "Cancer",
"signLord": "Moon",
"house": 11,
"nakshatra": "Pushya",
"pada": 4,
"starLord": "Saturn",
"subLord": "Jupiter",
"subSubLord": "Jupiter",
"kpNumber": 74
}
},
"significators": {
"houseWise": [
{
"house": 1,
"significators": [
{
"level": 3,
"description": "Planets in star of owner",
"planets": [
"Saturn"
]
},
{
"level": 4,
"description": "Owner of house",
"planets": [
"Sun"
]
}
],
"all": [
"Saturn",
"Sun"
]
},
{
"house": 2,
"significators": [
{
"level": 4,
"description": "Owner of house",
"planets": [
"Mercury"
]
}
],
"all": [
"Mercury"
]
},
{
"house": 3,
"significators": [
{
"level": 1,
"description": "Planets in star of occupant",
"planets": [
"Venus",
"Rahu"
]
},
{
"level": 2,
"description": "Occupants of house",
"planets": [
"Moon"
]
},
{
"level": 4,
"description": "Owner of house",
"planets": [
"Venus"
]
}
],
"all": [
"Venus",
"Rahu",
"Moon",
"Venus"
]
},
{
"house": 4,
"significators": [
{
"level": 4,
"description": "Owner of house",
"planets": [
"Mars"
]
}
],
"all": [
"Mars"
]
},
{
"house": 5,
"significators": [
{
"level": 1,
"description": "Planets in star of occupant",
"planets": [
"Moon",
"Ketu",
"Sun"
]
},
{
"level": 2,
"description": "Occupants of house",
"planets": [
"Saturn",
"Rahu"
]
},
{
"level": 3,
"description": "Planets in star of owner",
"planets": [
"Mercury",
"Jupiter"
]
},
{
"level": 4,
"description": "Owner of house",
"planets": [
"Jupiter"
]
}
],
"all": [
"Moon",
"Ketu",
"Sun",
"Saturn",
"Rahu",
"Mercury",
"Jupiter",
"Jupiter"
]
},
{
"house": 6,
"significators": [
{
"level": 3,
"description": "Planets in star of owner",
"planets": [
"Moon",
"Ketu"
]
},
{
"level": 4,
"description": "Owner of house",
"planets": [
"Saturn"
]
}
],
"all": [
"Moon",
"Ketu",
"Saturn"
]
},
{
"house": 7,
"significators": [
{
"level": 3,
"description": "Planets in star of owner",
"planets": [
"Moon",
"Ketu"
]
},
{
"level": 4,
"description": "Owner of house",
"planets": [
"Saturn"
]
}
],
"all": [
"Moon",
"Ketu",
"Saturn"
]
},
{
"house": 8,
"significators": [
{
"level": 2,
"description": "Occupants of house",
"planets": [
"Mars"
]
},
{
"level": 3,
"description": "Planets in star of owner",
"planets": [
"Mercury",
"Jupiter"
]
},
{
"level": 4,
"description": "Owner of house",
"planets": [
"Jupiter"
]
}
],
"all": [
"Mars",
"Mercury",
"Jupiter",
"Jupiter"
]
},
{
"house": 9,
"significators": [
{
"level": 2,
"description": "Occupants of house",
"planets": [
"Venus"
]
},
{
"level": 4,
"description": "Owner of house",
"planets": [
"Mars"
]
}
],
"all": [
"Venus",
"Mars"
]
},
{
"house": 10,
"significators": [
{
"level": 1,
"description": "Planets in star of occupant",
"planets": [
"Saturn"
]
},
{
"level": 2,
"description": "Occupants of house",
"planets": [
"Sun"
]
},
{
"level": 4,
"description": "Owner of house",
"planets": [
"Venus"
]
}
],
"all": [
"Saturn",
"Sun",
"Venus"
]
},
{
"house": 11,
"significators": [
{
"level": 1,
"description": "Planets in star of occupant",
"planets": [
"Mercury",
"Jupiter",
"Mars"
]
},
{
"level": 2,
"description": "Occupants of house",
"planets": [
"Mercury",
"Jupiter",
"Ketu"
]
},
{
"level": 4,
"description": "Owner of house",
"planets": [
"Mercury"
]
}
],
"all": [
"Mercury",
"Jupiter",
"Mars",
"Mercury",
"Jupiter",
"Ketu",
"Mercury"
]
},
{
"house": 12,
"significators": [
{
"level": 3,
"description": "Planets in star of owner",
"planets": [
"Venus",
"Rahu"
]
},
{
"level": 4,
"description": "Owner of house",
"planets": [
"Moon"
]
}
],
"all": [
"Venus",
"Rahu",
"Moon"
]
}
],
"planetWise": [
{
"planet": "Sun",
"house": 10,
"starLord": "Rahu",
"subLord": "Moon",
"signifies": [
{
"level": 1,
"houses": [
5
]
},
{
"level": 2,
"houses": [
10
]
},
{
"level": 4,
"houses": [
1
]
}
],
"allHouses": [
5,
10,
1
]
},
{
"planet": "Moon",
"house": 3,
"starLord": "Saturn",
"subLord": "Saturn",
"signifies": [
{
"level": 1,
"houses": [
5
]
},
{
"level": 2,
"houses": [
3
]
},
{
"level": 3,
"houses": [
6,
7
]
},
{
"level": 4,
"houses": [
12
]
}
],
"allHouses": [
5,
3,
6,
7,
12
]
},
{
"planet": "Mars",
"house": 8,
"starLord": "Ketu",
"subLord": "Ketu",
"signifies": [
{
"level": 1,
"houses": [
11
]
},
{
"level": 2,
"houses": [
8
]
},
{
"level": 4,
"houses": [
4,
9
]
}
],
"allHouses": [
11,
8,
4,
9
]
},
{
"planet": "Mercury",
"house": 11,
"starLord": "Jupiter",
"subLord": "Jupiter",
"signifies": [
{
"level": 1,
"houses": [
11
]
},
{
"level": 2,
"houses": [
11
]
},
{
"level": 3,
"houses": [
5,
8
]
},
{
"level": 4,
"houses": [
2,
11
]
}
],
"allHouses": [
11,
11,
5,
8,
2,
11
]
},
{
"planet": "Jupiter",
"house": 11,
"starLord": "Jupiter",
"subLord": "Ketu",
"signifies": [
{
"level": 1,
"houses": [
11
]
},
{
"level": 2,
"houses": [
11
]
},
{
"level": 3,
"houses": [
5,
8
]
},
{
"level": 4,
"houses": [
5,
8
]
}
],
"allHouses": [
11,
11,
5,
8,
5,
8
]
},
{
"planet": "Venus",
"house": 9,
"starLord": "Moon",
"subLord": "Saturn",
"signifies": [
{
"level": 1,
"houses": [
3
]
},
{
"level": 2,
"houses": [
9
]
},
{
"level": 3,
"houses": [
12
]
},
{
"level": 4,
"houses": [
3,
10
]
}
],
"allHouses": [
3,
9,
12,
3,
10
]
},
{
"planet": "Saturn",
"house": 5,
"starLord": "Sun",
"subLord": "Mars",
"signifies": [
{
"level": 1,
"houses": [
10
]
},
{
"level": 2,
"houses": [
5
]
},
{
"level": 3,
"houses": [
1
]
},
{
"level": 4,
"houses": [
6,
7
]
}
],
"allHouses": [
10,
5,
1,
6,
7
]
},
{
"planet": "Rahu",
"house": 5,
"starLord": "Moon",
"subLord": "Jupiter",
"signifies": [
{
"level": 1,
"houses": [
3
]
},
{
"level": 2,
"houses": [
5
]
},
{
"level": 3,
"houses": [
12
]
}
],
"allHouses": [
3,
5,
12
]
},
{
"planet": "Ketu",
"house": 11,
"starLord": "Saturn",
"subLord": "Jupiter",
"signifies": [
{
"level": 1,
"houses": [
5
]
},
{
"level": 2,
"houses": [
11
]
},
{
"level": 3,
"houses": [
6,
7
]
}
],
"allHouses": [
5,
11,
6,
7
]
}
]
},
"houseThemes": {
"1": [
"self",
"body",
"health",
"personality",
"vitality"
],
"2": [
"wealth",
"family",
"speech",
"possessions",
"food"
],
"3": [
"siblings",
"courage",
"communication",
"short travel",
"skills"
],
"4": [
"home",
"mother",
"property",
"vehicles",
"domestic happiness"
],
"5": [
"children",
"romance",
"creativity",
"education",
"speculation"
],
"6": [
"enemies",
"disease",
"debts",
"service",
"competition"
],
"7": [
"marriage",
"partner",
"business partnership",
"contracts",
"public dealings"
],
"8": [
"longevity",
"inheritance",
"sudden events",
"occult",
"transformation"
],
"9": [
"fortune",
"father",
"dharma",
"higher education",
"long travel"
],
"10": [
"career",
"profession",
"status",
"authority",
"karma"
],
"11": [
"gains",
"income",
"friends",
"elder siblings",
"fulfilment of desires"
],
"12": [
"losses",
"expenses",
"foreign lands",
"isolation",
"moksha"
]
},
"focus": "general"
}Response fields
| Field | Type | Description |
|---|---|---|
| meta* | object | Chart metadata including birth data, ayanamsa, and house system. |
| meta.date* | string | Birth date in YYYY-MM-DD format used for this KP chart calculation. |
| meta.time* | string | Birth time in HH:MM:SS format used for Lagna and Placidus cusp calculations. |
| meta.latitude* | number | Birth location latitude in decimal degrees. Determines Placidus house cusps and Ascendant. |
| meta.longitude* | number | Birth location longitude in decimal degrees. Affects local sidereal time for house calculations. |
| meta.timezone* | number | Timezone offset from UTC in decimal hours used for time conversion. |
| meta.ayanamsa* | number | KP Newcomb ayanamsa value in degrees. Precession correction applied to convert tropical to sidereal positions. |
| meta.ayanamsaType* | string | Ayanamsa system used, echoing the ayanamsa field of the request: "kp-newcomb", "kp-old", "lahiri", "raman" or "custom". |
| meta.houseSystem* | string | House system used (Placidus, standard for KP astrology). |
| ascendant* | object | Ascendant (Lagna) details with full KP stellar hierarchy. |
| ascendant.longitude* | number | Sidereal longitude of Ascendant (Lagna) in degrees. |
| ascendant.sign* | string | Zodiac sign of the Ascendant. |
| ascendant.signLord* | string | Ruling planet of the Ascendant sign (the rashi lord). In KP this is the weakest of the four lords, ranked below the star lord and sub lord, but it still sets the broad temperament of the Lagna. |
| ascendant.nakshatra* | string | Nakshatra (star) of the Ascendant. |
Show all fieldsShow fewer fields
| Field | Type | Description |
|---|---|---|
| ascendant.nakshatraLord* | string | Lord of the Ascendant nakshatra. |
| ascendant.pada* | number | Nakshatra pada (1-4) of the Ascendant. |
| ascendant.starLord* | string | KP star lord of the Ascendant position. |
| ascendant.subLord* | string | KP sub lord of the Ascendant. crucial for KP predictions. The Ascendant sub lord determines overall life promise. |
| ascendant.subSubLord* | string | KP sub-sub lord (SSL) of the Ascendant. Third level of the Vimshottari subdivision hierarchy, used for fine-tuning predictions. |
| ascendant.kpNumber* | number | KP number (1-249) for the Ascendant degree. |
| cusps* | array of object | All 12 Placidus house cusps with KP stellar hierarchy. Cusp sub lords are the primary predictive tool in KP astrology. |
| cusps[].house* | number | House number (1-12). |
| cusps[].longitude* | number | Placidus cusp longitude in sidereal degrees. |
| cusps[].sign* | string | Zodiac sign at the cusp. |
| cusps[].signLord* | string | Lord of the zodiac sign at the cusp (house owner). |
| cusps[].nakshatra* | string | Nakshatra at the cusp degree. |
| cusps[].nakshatraLord* | string | Lord of the nakshatra at the cusp. |
| cusps[].pada* | number | Nakshatra pada (1-4) at the cusp. |
| cusps[].starLord* | string | KP star lord of the cusp. |
| cusps[].subLord* | string | KP sub lord of the cusp. the deciding factor for house-level predictions in KP astrology. |
| cusps[].subSubLord* | string | KP sub-sub lord (SSL) of the cusp. Third level of Vimshottari subdivision for fine-grained cusp analysis. |
| cusps[].kpNumber* | number | KP number (1-249) for the cusp degree. |
| planets* | array of object | Positions of all 7 visible planets with complete KP stellar breakdown. |
| planets[].planet* | string | Planet name (Sun through Saturn, 7 visible planets). |
| planets[].longitude* | number | Sidereal longitude in degrees (KP ayanamsa corrected). |
| planets[].sign* | string | Zodiac sign the planet occupies. |
| planets[].signLord* | string | Rashi lord (sign ruler). First level of the KP significator hierarchy. Its house ownership determines L4 significations. |
| planets[].house* | number | House number (1-12) based on Placidus cusps. |
| planets[].nakshatra* | string | Nakshatra the planet occupies. |
| planets[].nakshatraLord* | string | Nakshatra lord (same as star lord). |
| planets[].pada* | number | Nakshatra pada (1-4). |
| planets[].starLord* | string | KP star lord, determines primary house signification. |
| planets[].subLord* | string | KP sub lord, the decisive factor. Planet gives results of the houses signified by its sub lord. |
| planets[].subSubLord* | string | KP sub-sub lord (SSL) of the planet. Third level of Vimshottari subdivision for precise timing analysis. |
| planets[].kpNumber* | number | KP number (1-249). |
| planets[].retrograde* | boolean | True if planet is retrograde. Retrograde planets may delay or deny results in KP system. |
| nodes* | object | Lunar nodes (Rahu and Ketu) with KP stellar hierarchy. Nodes are powerful agents that amplify the significations of their dispositors. |
| nodes.rahu* | object | Rahu (North Lunar Node), shadow planet, always retrograde, acts as agent of its sign lord and star lord. |
| nodes.rahu.longitude* | number | Sidereal longitude of Rahu (North Node). |
| nodes.rahu.sign* | string | Zodiac sign Rahu occupies. |
| nodes.rahu.signLord* | string | Rashi lord of the sign Rahu occupies. Rahu has no sign of its own and acts as agent of this lord. |
| nodes.rahu.house* | number | Occupied house number (1-12) based on Placidus cusps. |
| nodes.rahu.nakshatra* | string | Nakshatra of Rahu. |
| nodes.rahu.pada* | number | Nakshatra pada (1-4) of Rahu. |
| nodes.rahu.starLord* | string | KP star lord of Rahu. |
| nodes.rahu.subLord* | string | KP sub lord of Rahu. |
| nodes.rahu.subSubLord* | string | KP sub-sub lord (SSL) of Rahu. |
| nodes.rahu.kpNumber* | number | KP number (1-249) locating Rahu in the 249-division sub-lord scheme. Each of the 249 divisions maps to a unique sign, star lord and sub lord triple, so one integer pins the position precisely enough for KP event timing. |
| nodes.ketu* | object | Ketu (South Lunar Node), shadow planet, spiritual karmic indicator. |
| nodes.ketu.longitude* | number | Sidereal longitude of Ketu (South Node). Always 180 degrees from Rahu. |
| nodes.ketu.sign* | string | Zodiac sign Ketu occupies. |
| nodes.ketu.signLord* | string | Rashi lord of the sign Ketu occupies. Ketu has no sign of its own and acts as agent of this lord. |
| nodes.ketu.house* | number | Occupied house number (1-12) based on Placidus cusps. |
| nodes.ketu.nakshatra* | string | Nakshatra of Ketu. |
| nodes.ketu.pada* | number | Nakshatra pada (1-4) of Ketu. |
| nodes.ketu.starLord* | string | KP star lord of Ketu. |
| nodes.ketu.subLord* | string | KP sub lord of Ketu. |
| nodes.ketu.subSubLord* | string | KP sub-sub lord (SSL) of Ketu. |
| nodes.ketu.kpNumber* | number | KP number (1-249) locating Ketu in the 249-division sub-lord scheme. Each of the 249 divisions maps to a unique sign, star lord and sub lord triple, so one integer pins the position precisely enough for KP event timing. |
| significators* | object | KP significators for event prediction and timing. Shows which planets signify each house (house-wise) and which houses each planet signifies (planet-wise). Strength order: Level 1 (planets in star of occupant) > Level 2 (occupants) > Level 3 (planets in star of owner) > Level 4 (house owner). |
| significators.houseWise* | array of object | |
| significators.houseWise[].house* | number | House number 1-12 |
| significators.houseWise[].significators* | array of object | |
| significators.houseWise[].significators[].level* | number | KP significator strength level (1-4). L1: planets in star of occupant (strongest). L2: occupant itself. L3: planets in star of owner. L4: sign owner. Lower number = stronger signification for this house. |
| significators.houseWise[].significators[].description* | string | Human-readable label for this KP significator level. |
| significators.houseWise[].significators[].planets* | array of string | Planets signifying this house at this strength level. |
| significators.houseWise[].all* | array of string | The four levels flattened, strongest first, repeats included: a planet that reaches the house at two levels appears once per level, so the length counts level hits. The levels beside it are the per-level view. |
| significators.planetWise* | array of object | |
| significators.planetWise[].planet* | string | Vedic graha (planet) being analyzed for its house significations. |
| significators.planetWise[].signifies* | array of object |
Supported options
lang
focus
ayanamsa
nodeType
Call it in your language.
Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.
import { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.vedicAstrology.generateKpChart({ body: { date: '1990-07-04', time: '10:12:00', latitude: 28.6139, longitude: 77.209 } })Install: npm install @roxyapi/sdk
from roxy_sdk import create_roxy
roxy = create_roxy("YOUR_API_KEY")
result = roxy.vedic_astrology.generate_kp_chart(date='1990-07-04', time='10:12:00', latitude=28.6139, longitude=77.209)Install: pip install roxy-sdk
use function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->vedicAstrology->generateKpChart(date: '1990-07-04', time: '10:12:00', latitude: 28.6139, longitude: 77.209);Install: composer require roxyapi/sdk
using RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.VedicAstrology.Kp.Chart.PostAsync(new() { /* request fields above */ });Install: dotnet add package RoxyApi.Sdk
import roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.VedicAstrology.GenerateKpChart(ctx, nil, roxyapi.GenerateKpChartJSONRequestBody{ /* request fields above */ })Install: go get github.com/RoxyAPI/sdk-go
curl -X POST "https://roxyapi.com/api/v2/vedic-astrology/kp/chart" \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"1990-07-04","time":"10:12:00","latitude":28.6139,"longitude":77.209}'Prefer to try before you write code? Run this Vedic Astrology endpoint live in the API playground and inspect a real production response.
More KP Astrology endpoints
The KP Astrology API bundles these related endpoints under one key.
Get KP-Newcomb ayanamsa - Dynamic daily calculation
Get the KP-Newcomb (Krishnamurti) ayanamsa for any instant, computed continuously from Newcomb precession theory rather than looked up in a preset table, so it tracks the exact moment you ask for instead of the calendar year. Supply date alone for midnight UTC, or add time and timezone to pin a birth moment exactly. This is the precession offset subtracted from a tropical longitude to obtain the sidereal one, and it is what makes a KP chart reproduce the reference software your practitioners already use. Returns the same value every KP endpoint applies internally. Use it as a dynamic KP Newcomb ayanamsa calculator when you need the Krishnamurti ayanamsa for today, for a birth moment, or for any instant a chart is being rectified against.
Try it liveGet KP Placidus house cusps with sub-lords
Calculate unequal Placidus house cusps with ruling sign-lord, nakshatra-lord, and sub-lord for each cusp. Dynamic KP-Newcomb or custom ayanamsa support. Used in KP horary astrology, cusp sub-lord analysis, and birth chart rectification. Returns all 12 house cusps with KP sub-division details. Use it as a Placidus house cusp calculator that also carries the star lord and sub lord of each cusp, which is what Krishnamurti Paddhati horary work reads first.
Try it liveDaily finance score from four KP sub lord layers - KP Daily Finance API
A Krishnamurti Paddhati daily finance reading for one native on one date. Four KP layers are each scored against the money houses and weighed into one number: the cusp sub lords of the gain and loss houses (structural promise), the four running Vimshottari lords at the reading moment (timing), the ruling planets of that moment (the pulse), and the sub lord windows the Moon passes through across the civil day (the hour hand), with the best and worst windows named. Weights cusps 30, dasha 40, rulingPlanets 15, moonWindows 15. Every input is the shipped KP arithmetic: Placidus cusps, the 249 sub lord table, the four tier significator rule, the Vimshottari chain to the sookshma level, all in the one ayanamsa you choose. Every row prints its planet, its standing against the two sets and its score, so the number can be audited rather than trusted. The house groups, the classification, the inversion on the loss cusps, the retrograde penalty, the level weights and the layer weights are a KP practitioner convention adopted as the published convention of this route: no classical KP text weighs these four layers against each other, and every table behind the number is printed so the result can be checked line by line rather than trusted. The score measures what the method outputs for the day, never the probability of a gain or a loss. Override the two house groups to run your own school.
Try it liveCast a KP horary (Prashna) chart from a number 1-249 - KP Horary API
Cast a Krishnamurti Paddhati horary chart, also called Prashna, from a number between 1 and 249 given by the querent plus the moment and place the question is judged. NO BIRTH DETAILS ARE NEEDED, which is what makes horary the KP answer when birth time is unknown or unreliable. The number maps to one of the 249 KP sub divisions and sets the Ascendant; the twelve Placidus cusps follow from that Ascendant at the given latitude, and every planetary position comes from the real sky at the moment of the question. Returns the Ascendant with its sub lord, all twelve cusps with star lord and sub lord, the nine grahas placed against those cusps, the five ruling planets for validating the chart, and four-level significators for judging which houses each graha supports. KP horary API, Prashna kundali calculator, 249 horary number chart, Krishnamurti Paddhati horary, cusp sub lord question answering.
Try it liveGet KP planetary positions with sub-lords
Get planetary positions with detailed KP star-lord and sub-lord calculations for precise event timing and significator analysis. Returns all 9 planets (Sun through Ketu) with nakshatra, star-lord, sub-lord, and KP horary numbers (1-249). Essential for KP astrology software, significator analysis, and event prediction. Use it as a star lord and sub lord calculator wherever Krishnamurti Paddhati planet positions drive the reading.
Try it liveGet KP planets at time intervals
Calculate positions of all 9 planets (Sun through Saturn, Rahu, Ketu) at regular time intervals with full KP hierarchy: sign lord, star lord, sublord, and sub-sublord. Returns longitude, zodiac sign, nakshatra, sublord, sub-sublord, and KP number (1-249) for each planet at each timestamp. Ideal for tracking planetary motion, finding optimal muhurta windows, analyzing transit patterns, and building KP ephemeris tables. Maximum range of 7 days with 15-minute to 24-hour intervals.
Try it liveFind KP rasi ingress times
Track when planets enter new zodiac signs (rasi) with precise ingress timestamps. Essential for Vedic astrology transit analysis, muhurta selection, and predictive horoscope readings. Returns exact times when planets cross sign boundaries (0, 30, 60 degrees etc). Use for tracking Sun sankranti dates, Moon sign changes for panchang, or outer planet transits for yearly predictions.
Try it liveGet KP ruling planets with optional significators
Calculate the 5 ruling planets at any moment using Krishnamurti Paddhati horary astrology. Returns Day Lord, Moon Sign/Star/Sub Lord, Lagna Sign/Star/Sub Lord. Optionally provide birth data (birthDate, birthTime) to include significators showing which houses each ruling planet signifies in the birth chart, which is essential for KP prediction.
Try it liveGet KP ruling planets with significators at intervals
Calculate ruling planets and their KP significators at regular time intervals using Krishnamurti Paddhati prashna (horary) astrology. For each interval, a full Placidus house chart is erected and significators are computed using the 4-level KP hierarchy: Level 1 (strongest) planets in star of house occupant, Level 2 occupants, Level 3 planets in star of house owner, Level 4 house owner. Returns Day Lord (sunrise-based Hindu Vara), Moon Sign/Star/Sub/Sub-Sub Lords, Lagna Sign/Star/Sub/Sub-Sub Lords, unique ruling planets set, and per-ruling-planet house significations. No birth data needed, significators come from each moments sky chart. Use for birth time rectification, muhurta selection, and KP horary number analysis.
Try it liveFind KP sublord changes
Track when planets cross KP sublord boundaries (1-249 divisions) for precise Krishnamurti Paddhati event timing. Returns exact timestamps when a planet transitions between sublords, essential for prashna kundali analysis and dasha predictions. Use this to find favorable windows when benefic sublords are active. Supports Sun, Moon, Mars, Mercury, Jupiter, Venus, and Saturn tracking over any window up to 365 days.
Try it liveRemote MCP for AI agents
Every Vedic Astrology endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.
claude mcp add --transport http \
roxy-vedic-astrology https://roxyapi.com/mcp/vedic-astrology \
--header "X-API-Key: YOUR_KEY"Tool name for POST /vedic-astrology/kp/chart: post_vedic_astrology_kp_chart. Full MCP setup guide
What you can build
Kundli generation and PDF report services - combine D1/D9 charts, planetary positions, Dasha timelines, yoga detection, and dosha analysis into automated birth chart reports
Matrimonial matchmaking platforms - automate Gun Milan compatibility scoring, the South Indian ten porutham sheet with its Rajju and Vedha vetoes, Papasamyam malefic balance, Manglik dosha checks, Navamsa spouse analysis, and generate match reports with remedies for Shaadi.com-style features
Daily horoscope and prediction apps - one call composes the gochara verdicts, the panchang limbs with their validity windows, the running Dasha chain and the per-native tarabala and chandrabala into a single dated reading with a reproducible strength score, so a consumer-app daily screen is one request rather than five stitched together
AI astrology chatbots and virtual consultants - power conversational AI with structured Vedic calculations, compatibility queries, Dasha predictions, and remedy suggestions via ChatGPT plugins or MCP integration
Spiritual wellness and calendar apps - integrate Panchang for Hindu festival dates, fasting calendars, temple muhurat selection, and Nakshatra-based meditation schedules
KP horary and event prediction apps - build stellar astrology software with significator analysis, cusp sub-lords, and 249-level precision for answering when/yes-no questions
Drop-in UI components and no-code widgets.
Render KP Astrology API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The KP Astrology API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.
KP planets table widget snippet
KP ruling planets widget snippet
KP finance card widget snippet
The complete UI libraryExplore Roxy UI
Show all KP Astrology UI componentsShow fewer KP Astrology UI components
| Element | Renders |
|---|---|
| <roxy-kp-chart> | Ascendant, cusps, planets and nodes with KP stellar hierarchy and house meanings |
| <roxy-kp-planets-table> | Sub-lord and sub-sub-lord columns |
| <roxy-kp-ruling-planets> | Day lord, Moon/Lagna hierarchies, ruling planets, significators with house meanings |
| <roxy-kp-finance-card> | KP daily finance reading with the cusp sub lords, the running dasha lords, the ruling planets and the Moon sub lord windows each scored against the gain and loss houses, weighed into one band for the day |
Related capabilities
KP Astrology API FAQ
What does the KP Astrology API return?
Generate authentic Krishnamurti Paddhati birth charts with Placidus house cusps, star-lord and sub-lord calculations. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.
How do I authenticate with the KP Astrology API?
Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.
Does the KP Astrology API support multiple languages?
Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.
Do I need coordinates to call the KP Astrology API?
No. Call GET /location/search with a city name first, then pass latitude, longitude, and timezone from the first result into the request. Never ask users to type coordinates. Timezone accepts a decimal offset or an IANA name.
Is the KP Astrology API available over Remote MCP for AI agents?
Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/vedic-astrology over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.
How is the KP Astrology API billed?
Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 18 domains, so the KP Astrology API is included at no extra cost.
What focus values does the KP Astrology API accept?
The focus parameter accepts general, finance. Case-insensitive where it is a path value.
Start using KP Astrology API today.
Kundli, panchang and KP charts that state the ayanamsa they used and the classical rule behind each verdict.
All 18 domains included with every plan. Every endpoint, MCP server, SDK, and templates.
Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.
View Pricing & Get API Key