Vedic Astrology and Kundli MCP Server by RoxyAPI MCP

get_vedic_astrology_avasthas

List all 17 avastha states - Planetary State Reference

Reference list of every avastha (planetary state) across the three classical systems: the five Baladi age states, the three Jagradadi waking states, and the nine Deeptadi dispositional states. Each carries a short label and what the state means for the results the graha can deliver. Use it to turn the bare state names a birth chart returns into readable output, filtered by system if you only need one. Avastha meaning API, Baladi avastha, Jagradadi, Deeptadi, planetary state Vedic astrology.

Read only

Input schema

{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'system': {'enum': ['baladi', 'jagradadi', 'deeptadi'], 'type': 'string', 'example': 'deeptadi', 'description': 'Return only the states of one system: "baladi" (5), "jagradadi" (3) or "deeptadi" (9). Omit for all 17.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}}}

get_vedic_astrology_avasthas_id

Get avastha by ID - Planetary State Detail

Look up a single avastha state by its slug, which is the lowercased state name a Vedic birth chart returns in `awastha`, `jagradadi` or `deeptadi`. Returns the system it belongs to, a short label, and what the state means for the results the graha delivers.

Read only

Input schema

{'type': 'object', 'examples': [{'id': 'dipta'}], 'required': ['id'], 'properties': {'id': {'enum': ['bala', 'kumara', 'yuva', 'vriddha', 'mrita', 'jagrat', 'swapna', 'sushupti', 'dipta', 'svastha', 'pramudita', 'shanta', 'dina', 'duhkhita', 'vikala', 'khala', 'kopa'], 'type': 'string', 'example': 'dipta', 'description': 'Avastha slug. Baladi: bala, kumara, yuva, vriddha, mrita. Jagradadi: jagrat, swapna, sushupti. Deeptadi: dipta, svastha, pramudita, shanta, dina, duhkhita, vikala, khala, kopa.'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}}}

Output schema

{'type': 'object', 'required': ['id', 'name', 'system', 'meaning', 'interpretation'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'system': {'enum': ['baladi', 'jagradadi', 'deeptadi'], 'type': 'string'}, 'meaning': {'type': 'string'}, 'interpretation': {'type': 'string'}}}

get_vedic_astrology_kp_ayanamsa

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.

Read only

Input schema

{'type': 'object', 'examples': [{}], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '2025-12-26', 'description': 'Date for ayanamsa calculation in YYYY-MM-DD format. Defaults to today if not provided. Ayanamsa changes by ~0.01 degrees per month due to the precession of Earth.'}, 'time': {'type': 'string', 'format': 'time', 'example': '09:00:00', 'description': 'Time of day in 24-hour HH:MM:SS format, interpreted in the timezone below. Omit for midnight UTC. The ayanamsa moves about 0.14 arcseconds across a day, so supplying the time matters only when reconciling a chart against reference software to the arcsecond.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'timezone': {'type': 'string', 'example': 'Asia/Kolkata', 'description': 'IANA name (e.g. "Asia/Kolkata", "America/New_York"), decimal hours (e.g. 5.5 for IST, -5 for EST), or a fixed UTC offset (e.g. "+05:30"). IANA resolved to the offset in force at the given date and the time field above. Defaults to 0 (UTC).'}}}

Output schema

{'type': 'object', 'required': ['date', 'instant', 'ayanamsa', 'type', 'formula', 'calculated'], 'properties': {'date': {'type': 'string'}, 'type': {'type': 'string'}, 'formula': {'type': 'string'}, 'instant': {'type': 'string'}, 'ayanamsa': {'type': 'number'}, 'calculated': {'type': 'string'}}}

get_vedic_astrology_nakshatras

List all 27 Nakshatras - Lunar Mansions Reference

Get the complete list of 27 nakshatras (lunar mansions) in Vedic astrology. Returns names, zodiac ranges, ruling planets, presiding deities, symbols, personality characteristics, and traditional remedies (mantras, gemstones, rituals) for each nakshatra from Ashwini to Revati. Essential for nakshatra lookup tables, dasha period calculations, muhurta selection, and astrology app reference data.

Read only

Input schema

{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}}}

get_vedic_astrology_nakshatras_id

Get Nakshatra by ID - Lunar Mansion Detail

Get detailed information for a single nakshatra (lunar mansion) by its ID slug, one of the 27 nakshatras of Vedic astrology. Returns name, zodiac range, ruling planet, presiding deity, symbol, personality characteristics, and traditional remedies including mantras, gemstones, and rituals.

Read only

Input schema

{'type': 'object', 'examples': [{'id': 'ashwini'}], 'required': ['id'], 'properties': {'id': {'enum': ['ashwini', 'bharani', 'krittika', 'rohini', 'mrigashira', 'ardra', 'punarvasu', 'pushya', 'ashlesha', 'magha', 'purva-phalguni', 'uttara-phalguni', 'hasta', 'chitra', 'swati', 'vishakha', 'anuradha', 'jyeshtha', 'moola', 'purva-ashadha', 'uttara-ashadha', 'shravana', 'dhanishta', 'shatabhisha', 'purva-bhadrapada', 'uttara-bhadrapada', 'revati'], 'type': 'string', 'example': 'ashwini', 'description': 'Nakshatra ID slug. Examples: ashwini, bharani, krittika, rohini, mrigashira, ardra, punarvasu, pushya, ashlesha, magha, etc.'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}}}

Output schema

{'type': 'object', 'required': ['id', 'name', 'number', 'range', 'lord', 'deity', 'symbol', 'characteristics', 'remedies'], 'properties': {'id': {'type': 'string'}, 'lord': {'type': 'string'}, 'name': {'type': 'string'}, 'deity': {'type': 'string'}, 'range': {'type': 'string'}, 'number': {'type': 'number'}, 'symbol': {'type': 'string'}, 'remedies': {'type': 'object', 'required': ['mantras', 'gemstones', 'rituals'], 'properties': {'mantras': {'type': 'string'}, 'rituals': {'type': 'string'}, 'gemstones': {'type': 'string'}}}, 'characteristics': {'type': 'string'}}}

get_vedic_astrology_rashis

List all 12 Rashis - Vedic Zodiac Signs Reference

Get the complete list of 12 rashis (zodiac signs) in Vedic astrology. Returns Sanskrit names, Western equivalents, sidereal date ranges, symbols, governing Adityas, and personality characteristics for each rashi. Reference data for Mesha through Meen. Essential for zodiac sign lookup tables, astrology apps, and rashi-based UI components.

Read only

Input schema

{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}}}

get_vedic_astrology_rashis_id

Get Rashi by ID - Vedic Zodiac Sign Detail

Get detailed information for a single rashi (zodiac sign) by its Vedic ID slug. Returns Sanskrit name, Western equivalent, sidereal date range, symbol, governing Aditya, and personality characteristics.

Read only

Input schema

{'type': 'object', 'examples': [{'id': 'mesha'}], 'required': ['id'], 'properties': {'id': {'enum': ['mesha', 'vrishabha', 'mithun', 'karka', 'simha', 'kanya', 'tula', 'vrischika', 'dhanu', 'makar', 'kumbha', 'meen'], 'type': 'string', 'example': 'mesha', 'description': 'Rashi ID slug. One of: mesha, vrishabha, mithun, karka, simha, kanya, tula, vrischika, dhanu, makar, kumbha, meen.'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}}}

Output schema

{'type': 'object', 'required': ['id', 'name', 'vedicName', 'dateRange', 'symbol', 'energy', 'characteristics'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'energy': {'type': 'string'}, 'symbol': {'type': 'string'}, 'dateRange': {'type': 'string'}, 'vedicName': {'type': 'string'}, 'characteristics': {'type': 'string'}}}

get_vedic_astrology_yoga

List all planetary yogas - 301 entry Vedic Yoga Glossary

Browse the 301-entry Vedic planetary-yoga glossary. Returns id and name for every cataloged yoga (Raja, Dhana, Pancha Mahapurusha, Nabhasa, Chandra-Mangala, and more). This is a dictionary lookup, not chart-driven detection: it does not inspect a birth chart. Use GET /yoga/{id} for the full glossary entry, or POST /yoga/detect to run all 48 detection rules against a specific kundli. Ideal for yoga-browser UIs, search, and progressive data loading.

Read only

Input schema

{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'family': {'enum': ['classical', 'asraya', 'dala', 'akriti', 'sankhya'], 'type': 'string', 'example': 'akriti', 'description': 'Filter the catalog to one Nabhasa family: asraya (3), dala (2), akriti (20) or sankhya (7). Omit for the full catalog. `classical` is accepted but matches nothing here, because it is a detection-verdict value for single-combination yogas rather than a catalog grouping.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}}}

Output schema

{'type': 'object', 'required': ['yogas', 'total'], 'properties': {'total': {'type': 'number'}, 'yogas': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'family': {'enum': ['classical', 'asraya', 'dala', 'akriti', 'sankhya'], 'type': 'string'}}}}}}

get_vedic_astrology_yoga_id

Get yoga details by ID - Vedic Yoga Glossary Entry

Look up the dictionary entry for a specific named yoga from the 301-entry Vedic planetary-yoga glossary. Returns formation conditions, life results, and quality classification (Positive/Negative/Both). This is a glossary lookup against the static catalog; it does NOT analyze a birth chart. For chart-driven present/absent verdicts on the 48 detection-grade yogas (Gajakesari, the Pancha Mahapurusha set, all 32 Nabhasa distribution yogas, and the wealth and poverty verdicts) call POST /yoga/detect with birth data.

Read only

Input schema

{'type': 'object', 'examples': [{'id': 'gajakesari'}], 'required': ['id'], 'properties': {'id': {'enum': ['gajakesari', 'sunapha', 'anapha', 'dhurdhura', 'kemadruma', 'chandramangala', 'adhi', 'chatussagara', 'vasumathi', 'rajalakshana', 'vanchanachorabheethi', 'sakata', 'amala', 'parvata', 'kahala', 'vesi', 'vasi', 'obhayachari', 'hamsa', 'malavya', 'sasa', 'ruchaka', 'bhadra', 'budhaaditya', 'mahabhagya', 'pushkala', 'lakshmi', 'gauri', 'bharathi', 'chapa', 'sreenatha', 'lagnamalika', 'dhanamalika', 'vikramamalika', 'sukhamalika', 'putramalika', 'satrumalika', 'kalatramalika', 'randhramalika', 'bhagyamalika', 'karmamalika', 'labhamalika', 'vrayamalika', 'sankha', 'bheri', 'mridanga', 'parijatha', 'gaja', 'kalanidhi', 'amsavatara', 'hariharabrahma', 'kusuma', 'matsya', 'kurma', 'devendra', 'makuta', 'chandika', 'jaya', 'vidyut', 'gandharva', 'siva', 'vishnu', 'brahma', 'indra', 'ravi', 'garuda', 'go', 'gola', 'thrilochana', 'kulavardhana', 'yupa', 'ishu', 'sakti', 'danda', 'nav', 'kuta', 'chhatra', 'chapa-2', 'ardhachandra', 'chandra', 'gada', 'sakata-2', 'vihaga', 'vajra', 'yava', 'sringhataka', 'hala', 'kamala', 'vapee', 'samudra', 'vallaki', 'damni', 'pasa', 'kedara', 'sula', 'yuga', 'gola-2', 'rajju', 'musala', 'nala', 'srik', 'mala', 'sarpa', 'duryoga', 'daridra', 'harsha', 'sarala', 'vimala', 'sareerasoukhya', 'dehapushti', 'dehakashta', 'rogagrastha', 'krisanga', 'krisanga-2', 'dehasthoulya', 'dehasthoulya-2', 'dehasthoulya-3', 'sadasanchara', 'dhana', 'dhana-2', 'dhana-3', 'dhana-4', 'dhana-5', 'dhana-6', 'dhana-7', 'dhana-8', 'dhana-9', 'dhana-10', 'dhana-11', 'bahudravyarjana', 'swaveeryaddhana', 'swaveeryaddhana-2', 'swaveeryaddhana-3', 'madhyavayasidhana', 'anthyavayasidhana', 'balyadhana', 'bhratrumooladdhanaprapti', 'bhratrumooladdhanaprapti-2', 'matrumooladdhana', 'putramooladdhana', 'satrumooladdhana', 'kalatramooladdhana', 'amarananthadhana', 'ayatnadhanalabha', 'daridra-2', 'daridra-3', 'daridra-4', 'daridra-5', 'daridra-6', 'daridra-7', 'daridra-8', 'daridra-9', 'daridra-10', 'daridra-11', 'yukthisamanwithavagmi', 'yukthisamanwithavagmi-2', 'parihasaka', 'asatyavadi', 'jada', 'bhaskara', 'marud', 'saraswathi', 'budha', 'mooka', 'netranasa', 'andha', 'sumukha', 'sumukha-2', 'durmukha', 'durmukha-2', 'bhojanasoukhya', 'annadana', 'parannabhojana', 'sraddhannabhuktha', 'sarpaganda', 'vakchalana', 'vishaprayoga', 'bhratruvriddhi', 'sodaranasa', 'ekabhagini', 'dwadasasahodara', 'sapthasankhyasahodara', 'parakrama', 'yuddhapraveena', 'yuddhatpoorvadridhachitta', 'yuddhatpaschaddrudha', 'satkathadisravana', 'uttamagriha', 'vichitrasaudhaprakara', 'ayatnagrihaprapta', 'ayatnagrihaprapta-2', 'grihanasa', 'grihanasa-2', 'bandhupujya', 'bandhupujya-2', 'bandhubhisthyaktha', 'matrudeerghayur', 'matrudeerghayur-2', 'matrunasa', 'matrunasa-2', 'matrugami', 'sahodareesangama', 'kapata', 'kapata-2', 'kapata-3', 'nishkapata', 'nishkapata-2', 'matrusatrutwa', 'matrusneha', 'vahana', 'vahana-2', 'anapathya', 'sarpasapa', 'sarpasapa-2', 'sarpasapa-3', 'sarpasapa-4', 'pitrusapasutakshaya', 'matrusapasutakshaya', 'bhratrusapasutakshaya', 'pretasapa', 'bahuputra', 'bahuputra-2', 'dattaputra', 'dattaputra-2', 'aputra', 'ekaputra', 'suputra', 'kalanirdesatputra', 'kalanirdesatputra-2', 'kalanirdesatputranasa', 'kalanirdesatputranasa-2', 'buddhimaturya', 'theevrabuddhi', 'buddhijada', 'thrikalagnana', 'putrasukha', 'jara', 'jarajaputra', 'bahustree', 'satkalatra', 'bhagachumbana', 'bhagya', 'jananatpurvampitrumarana', 'dhatrutwa', 'apakeerti', 'raja', 'raja-2', 'raja-3', 'raja-4', 'raja-5', 'raja-6', 'raja-7', 'raja-8', 'raja-9', 'raja-10', 'raja-11', 'raja-12', 'raja-13', 'raja-14', 'raja-15', 'raja-16', 'raja-17', 'raja-18', 'raja-19', 'galakarna', 'vrana', 'sisnavyadhi', 'kalatrashanda', 'kushtaroga', 'kushtaroga-2', 'kshayaroga', 'bandhana', 'karascheda', 'sirachcheda', 'durmarana', 'yuddhemarana', 'sanghatakamarana', 'sanghatakamarana-2', 'peenasaroga', 'pittaroga', 'vikalangapatni', 'putrakalatraheena', 'bharyasahavyabhichara', 'vamsacheda', 'guhyaroga', 'angaheena', 'swetakushta', 'pisachagrastha', 'andha-2', 'andha-3', 'vatharoga', 'matibhramana', 'matibhramana-2', 'matibhramana-3', 'matibhramana-4', 'khalwata', 'nishturabhashi', 'rajabhrashta', 'raja-20', 'raja-21', 'gohanta'], 'type': 'string', 'example': 'gajakesari', 'description': 'Yoga identifier (lowercase, hyphenated)'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}}}

Output schema

{'type': 'object', 'required': ['id', 'name', 'description', 'result', 'quality'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'family': {'enum': ['classical', 'asraya', 'dala', 'akriti', 'sankhya'], 'type': 'string'}, 'result': {'type': 'string'}, 'quality': {'enum': ['Positive', 'Negative', 'Both'], 'type': 'string'}, 'description': {'type': 'string'}}}

post_vedic_astrology_arudha

Get the twelve Arudha padas - Arudha Lagna Calculator API

Calculate the Arudha Lagna (AL) and all twelve Arudha padas of Jaimini astrology from birth details. An Arudha pada is the perceived or projected form of a bhava, so where the Lagna shows what a person is, the Arudha Lagna shows the image and status the world attaches to them. Returns each pada with the bhava lord and the count that produced it, the sign it lands in, its house from the Lagna, and a flag showing whether the classical exception moved it. Includes the Upapada (UL) read for marriage. Arudha Lagna calculator API, Jaimini pada, Upapada Lagna, Vedic astrology public image.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'lagnaRashi', 'arudhaLagna', 'upapada', 'padas'], 'properties': {'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'padas': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'abbreviation', 'name', 'house', 'bhavaRashi', 'lord', 'lordRashi', 'rashi', 'houseFromLagna', 'exceptionApplied', 'meaning', 'significations'], 'properties': {'id': {'type': 'string'}, 'lord': {'type': 'string'}, 'name': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'rashi': {'type': 'string'}, 'meaning': {'type': 'string'}, 'lordRashi': {'type': 'string'}, 'bhavaRashi': {'type': 'string'}, 'abbreviation': {'type': 'string'}, 'houseFromLagna': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'significations': {'type': 'string'}, 'exceptionApplied': {'type': 'boolean'}}}}, 'upapada': {'type': 'string'}, 'lagnaRashi': {'type': 'string'}, 'arudhaLagna': {'type': 'string'}}}

post_vedic_astrology_ashtakavarga

Get Ashtakavarga (planetary strength) analysis - Ashtakavarga Calculator API

Calculate complete Ashtakavarga analysis per Brihat Parashara Hora Shastra (BPHS). Returns Bhinnashtakavarga (BAV), Sarvashtakavarga (SAV, total 337), Reduced Ashtakavarga (Trikona + Ekadipati Shodhana per Ch. 67-68), and Shodhya Pinda planetary strength (Rashi Pinda + Graha Pinda per Ch. 69). Essential for transit prediction timing, house strength analysis, dasha result evaluation, and planetary strength comparison. Ashtakavarga calculator API, bindu rekha points, Shodhya Pinda, Vedic astrology.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'bhinnashtakavarga', 'sarvashtakavarga', 'reducedBhinnashtakavarga', 'reducedSarvashtakavarga', 'shodhyaPinda', 'signs'], 'properties': {'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'signs': {'type': 'array', 'items': {'enum': ['Aries', 'Taurus', 'Gemini', 'Cancer', 'Leo', 'Virgo', 'Libra', 'Scorpio', 'Sagittarius', 'Capricorn', 'Aquarius', 'Pisces'], 'type': 'string'}}, 'shodhyaPinda': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'rashiPinda', 'grahaPinda', 'shodhyaPinda'], 'properties': {'planet': {'type': 'string'}, 'grahaPinda': {'type': 'number'}, 'rashiPinda': {'type': 'number'}, 'shodhyaPinda': {'type': 'number'}}}}, 'sarvashtakavarga': {'type': 'object', 'required': ['bindus', 'total'], 'properties': {'total': {'type': 'number'}, 'bindus': {'type': 'array', 'items': {'type': 'number'}}}}, 'bhinnashtakavarga': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'bindus', 'total'], 'properties': {'total': {'type': 'number'}, 'bindus': {'type': 'array', 'items': {'type': 'number'}}, 'planet': {'type': 'string'}}}}, 'reducedSarvashtakavarga': {'type': 'object', 'required': ['bindus', 'total'], 'properties': {'total': {'type': 'number'}, 'bindus': {'type': 'array', 'items': {'type': 'number'}}}}, 'reducedBhinnashtakavarga': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'bindus', 'total'], 'properties': {'total': {'type': 'number'}, 'bindus': {'type': 'array', 'items': {'type': 'number'}}, 'planet': {'type': 'string'}}}}}}

post_vedic_astrology_aspects

Get planetary aspects (Drishti) - Mutual aspects between all planets

Calculate all planetary aspects (Drishti) for a given time. Returns full aspects (7th house for all planets) and special aspects (Mars 4th/8th, Jupiter 5th/9th, Saturn 3rd/10th). Includes aspect table grouped by planet, mutual aspects, and individual aspect details with orb calculation. Essential for birth chart analysis, compatibility checking, and transit predictions. Planetary aspects API, drishti calculator, vedic astrology aspects, graha drishti.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '2026-02-03', 'time': '12:00:00', 'latitude': 17.385044, 'longitude': 78.486671}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '2026-02-03', 'description': 'Date in YYYY-MM-DD format. Planetary positions are calculated for this date to determine mutual aspects (drishti).'}, 'time': {'type': 'string', 'format': 'time', 'example': '12:00:00', 'description': 'Time in HH:MM:SS format (24-hour). Exact time affects fast-moving planets (Moon, Mercury) and aspect orbs.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'latitude': {'type': 'number', 'example': 17.385044, 'maximum': 90, 'minimum': -90, 'description': 'Observer latitude in decimal degrees. Used for Lagna calculation which affects house-based aspect analysis.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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).'}, 'longitude': {'type': 'number', 'example': 78.486671, 'maximum': 180, 'minimum': -180, 'description': 'Observer longitude in decimal degrees. Affects local sidereal time for positional calculations.'}, 'coordinateSystem': {'enum': ['sidereal', 'tropical'], 'type': 'string', 'default': 'sidereal', 'example': 'sidereal', 'description': 'Coordinate system for longitude output. "sidereal" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. "tropical" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to "sidereal".'}}}

Output schema

{'type': 'object', 'required': ['datetime', 'planets', 'aspects', 'aspectTable', 'mutualAspects'], 'properties': {'aspects': {'type': 'array', 'items': {'type': 'object', 'required': ['aspectingPlanet', 'aspectedPlanet', 'aspectType', 'strength', 'orb'], 'properties': {'orb': {'type': 'number'}, 'strength': {'type': 'number'}, 'aspectType': {'enum': ['conjunction', '7th', '4th', '8th', '5th', '9th', '3rd', '10th'], 'type': 'string'}, 'aspectedPlanet': {'type': 'string'}, 'aspectingPlanet': {'type': 'string'}}}}, 'planets': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'longitude', 'sign'], 'properties': {'name': {'type': 'string'}, 'sign': {'type': 'string'}, 'longitude': {'type': 'number'}}}}, 'datetime': {'type': 'string'}, 'aspectTable': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'aspects'], 'properties': {'planet': {'type': 'string'}, 'aspects': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'aspectType', 'strength'], 'properties': {'planet': {'type': 'string'}, 'strength': {'type': 'number'}, 'aspectType': {'type': 'string'}}}}}}}, 'mutualAspects': {'type': 'array', 'items': {'type': 'object', 'required': ['planet1', 'planet2', 'aspectType'], 'properties': {'planet1': {'type': 'string'}, 'planet2': {'type': 'string'}, 'aspectType': {'type': 'string'}}}}}}

post_vedic_astrology_aspects_lunar

Monthly Lunar Aspects - Moon aspect events with all planets for a month

Track all lunar aspect events for a given month including major and minor aspects. The Moon traverses approximately 13 degrees per day, forming 22 aspect types with each planet. 5 major (conjunction, opposition, trine, square, sextile) and 17 minor (vigintile, semi-sextile, undecile, semi-quintile, novile, semi-square, septile, quintile, binovile, centile, biseptile, tredecile, sesqui-square, bi-quintile, quincunx, triseptile, quadranovile). Returns exact date and time of each Moon aspect event with ternary search refinement to the minute. Omit year and month to get the month in progress, so a published lunar calendar stays current without a redeploy. Essential for muhurta selection, daily panchang analysis, and chandra gochar predictions. Monthly lunar aspects API, Moon transit calendar, chandra drishti ephemeris, minor lunar aspects.

Read only

Input schema

{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'year': {'type': 'integer', 'example': 2026, 'maximum': 2649, 'minimum': 1551, 'description': 'Year for monthly analysis (1551 to 2649). Defaults to the current year (UTC).'}, 'month': {'type': 'integer', 'example': 2, 'maximum': 12, 'minimum': 1, 'description': 'Month number (1-12). Defaults to the current month (UTC).'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 0, 'example': 5.5, 'description': '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 once, at the start of the window, and that offset applies to every time in the response. Output times are converted to this timezone. Defaults to 0 (UTC).'}, 'coordinateSystem': {'enum': ['sidereal', 'tropical'], 'type': 'string', 'default': 'sidereal', 'example': 'sidereal', 'description': 'Coordinate system for longitude output. "sidereal" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. "tropical" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to "sidereal".'}}}

Output schema

{'type': 'object', 'required': ['year', 'month', 'timezone', 'events'], 'properties': {'year': {'type': 'number'}, 'month': {'type': 'number'}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'aspect', 'date', 'time', 'datetime', 'orb', 'distance', 'moonLongitude', 'planetLongitude'], 'properties': {'orb': {'type': 'number'}, 'date': {'type': 'string'}, 'time': {'type': 'string'}, 'aspect': {'type': 'string'}, 'planet': {'type': 'string'}, 'datetime': {'type': 'string'}, 'distance': {'type': 'number'}, 'moonLongitude': {'type': 'number'}, 'planetLocalized': {'type': 'string'}, 'planetLongitude': {'type': 'number'}}}}, 'timezone': {'type': 'number'}}}

post_vedic_astrology_aspects_monthly

Monthly Planetary Aspects - Major and minor aspect events for a month

Calculate all planetary aspect events (excluding Moon) for a given month. Detects 22 aspect types. 5 major (conjunction, opposition, trine, square, sextile) and 17 minor (vigintile, semi-sextile, undecile, semi-quintile, novile, semi-square, septile, quintile, binovile, centile, biseptile, tredecile, sesqui-square, bi-quintile, quincunx, triseptile, quadranovile). Returns exact date and time of closest approach using ternary search refinement. Uses degree-based aspect methodology on sidereal positions (Lahiri ayanamsa). Omit year and month to get the month in progress, so a published aspect calendar stays current without a redeploy. For Moon-specific aspects, use the /aspects/lunar endpoint. Essential for transit timing, muhurta selection, and monthly astrological forecasting. Monthly planetary aspects API, graha drishti calendar, mutual aspect ephemeris, minor aspects.

Read only

Input schema

{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'year': {'type': 'integer', 'example': 2026, 'maximum': 2649, 'minimum': 1551, 'description': 'Year for monthly analysis (1551 to 2649). Defaults to the current year (UTC).'}, 'month': {'type': 'integer', 'example': 2, 'maximum': 12, 'minimum': 1, 'description': 'Month number (1-12). Defaults to the current month (UTC).'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 0, 'example': 5.5, 'description': '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 once, at the start of the window, and that offset applies to every time in the response. Output times are converted to this timezone. Defaults to 0 (UTC).'}, 'coordinateSystem': {'enum': ['sidereal', 'tropical'], 'type': 'string', 'default': 'sidereal', 'example': 'sidereal', 'description': 'Coordinate system for longitude output. "sidereal" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. "tropical" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to "sidereal".'}}}

Output schema

{'type': 'object', 'required': ['year', 'month', 'timezone', 'events'], 'properties': {'year': {'type': 'number'}, 'month': {'type': 'number'}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['planet1', 'planet2', 'aspect', 'date', 'time', 'datetime', 'orb', 'distance', 'planet1Longitude', 'planet2Longitude'], 'properties': {'orb': {'type': 'number'}, 'date': {'type': 'string'}, 'time': {'type': 'string'}, 'aspect': {'type': 'string'}, 'planet1': {'type': 'string'}, 'planet2': {'type': 'string'}, 'datetime': {'type': 'string'}, 'distance': {'type': 'number'}, 'planet1Localized': {'type': 'string'}, 'planet1Longitude': {'type': 'number'}, 'planet2Localized': {'type': 'string'}, 'planet2Longitude': {'type': 'number'}}}}, 'timezone': {'type': 'number'}}}

post_vedic_astrology_bhava_bala

Get Bhava Bala (house strength) for all twelve houses - Bhava Bala Calculator API

Calculate Bhava Bala (house strength) for all twelve bhavas per Brihat Parashara Hora Shastra (BPHS) and BV Raman Graha and Bhava Balas. Returns the three classical components (Bhavadhipati Bala from the house lord Shadbala, Bhava Digbala from the rashi class and direction, Bhava Drishti Bala from aspects on the bhava madhya) plus totals in virupas and rupas and a strength ranking. Bhavas are built on unequal Sripati mid-cusps, so a house near a sign boundary is measured where it actually falls. Shadbala measures which graha is strong, Bhava Bala measures which life area is strong, and reading both together is how a practitioner separates a strong planet in a weak house from a weak planet in a strong one. Bhava Bala calculator API, house strength Vedic astrology, bhava bala virupas, Bhavadhipati Bala, Bhava Digbala, Sripati bhava madhya.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'houseSystem', 'bhavas', 'houseThemes', 'focus'], 'properties': {'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'bhavas': {'type': 'array', 'items': {'type': 'object', 'required': ['house', 'rashi', 'madhya', 'lord', 'bhavadhipatiBala', 'digBala', 'drishtiBala', 'totalVirupas', 'totalRupas', 'rank'], 'properties': {'lord': {'type': 'string'}, 'rank': {'type': 'number'}, 'house': {'type': 'number'}, 'rashi': {'type': 'string'}, 'madhya': {'type': 'number'}, 'digBala': {'type': 'number'}, 'totalRupas': {'type': 'number'}, 'drishtiBala': {'type': 'number'}, 'totalVirupas': {'type': 'number'}, 'bhavadhipatiBala': {'type': 'number'}}}}, 'houseSystem': {'type': 'string'}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}}}

post_vedic_astrology_bhav_chalit

Get the Bhav Chalit (Chalit Kundli) cusp-based house chart - Bhav Chalit API

Calculate the Bhav Chalit chart, also written Bhava Chalit or Chalit Kundli, placing every graha by unequal Sripati bhava cusps instead of by whole sign. The Rashi (D1) chart treats a whole sign as a house, so a graha a degree from a sign boundary is shown in a house it does not actually occupy; the Chalit chart resolves that by measuring from the bhava sandhis, which is why practitioners check it before reading house results, house lordship strength or transit effects. Returns the twelve bhava boundaries with their madhyas and spans, every graha in both frames, and a moved flag on the placements that differ. Bhav Chalit API, Chalit Kundli calculator, bhava chalit chart, Sripati house cusps, cusp based house chart Vedic astrology.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'houseSystem', 'ascendant', 'midheaven', 'bhavas', 'grahas', 'movedCount', 'houseThemes', 'focus'], 'properties': {'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'bhavas': {'type': 'array', 'items': {'type': 'object', 'required': ['house', 'start', 'madhya', 'end', 'span', 'rashi', 'grahas'], 'properties': {'end': {'type': 'number'}, 'span': {'type': 'number'}, 'house': {'type': 'number'}, 'rashi': {'type': 'string'}, 'start': {'type': 'number'}, 'grahas': {'type': 'array', 'items': {'type': 'string'}}, 'madhya': {'type': 'number'}}}}, 'grahas': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'rashi', 'bhava', 'rashiHouse', 'moved'], 'properties': {'bhava': {'type': 'number'}, 'graha': {'type': 'string'}, 'moved': {'type': 'boolean'}, 'rashi': {'type': 'string'}, 'longitude': {'type': 'number'}, 'rashiHouse': {'type': 'number'}}}}, 'ascendant': {'type': 'number'}, 'midheaven': {'type': 'number'}, 'movedCount': {'type': 'number'}, 'houseSystem': {'type': 'string'}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}}}

post_vedic_astrology_birth_chart

Get birth chart (D1 Rashi chart) - Kundli Calculator API

Calculate complete Vedic birth chart (Janam Kundli, natal chart) with all 9 planetary positions (Sun through Ketu) plus Ascendant (Lagna). Kundli calculator API for astrology apps, matrimonial sites. Returns accurate graha positions grouped by zodiac signs (rashis) with nakshatra details and pada. Perfect for kundli generation, horoscope matching, and Vedic astrology software integration.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'avasthaInfo': {'type': 'boolean', 'default': False, 'example': True, 'description': 'Set true to include a localized meaning and one-sentence classical interpretation beside each graha avastha state, under avasthaInfo on that graha in meta. Defaults to false, so an existing integration is byte-identical until it opts in. Saves a second call to GET /avasthas and the client-side join that would otherwise be needed to turn Yuva or Swapna into readable text.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}, 'modernPlanets': {'type': 'boolean', 'default': False, 'example': True, 'description': 'Set true to also return Uranus, Neptune and Pluto, under the Sanskrit names Arun, Varun and Yam that Indian software prints for them. They arrive in a separate modernPlanets array, NOT inside meta, because classical Jyotish is defined over nine grahas: the moderns rule no sign, so they have no dignity, avastha, combustion or aspect strength and it would be fabrication to report one. Each carries longitude, rashi, degree in sign, nakshatra with pada and lord, and retrograde status. Defaults to false, so an existing integration is byte-identical until it opts in.'}}}

Output schema

{'type': 'object', 'required': ['aries', 'taurus', 'gemini', 'cancer', 'leo', 'virgo', 'libra', 'scorpio', 'sagittarius', 'capricorn', 'aquarius', 'pisces', 'frame', 'houses', 'combustion', 'planetaryWar', 'interpretations', 'meta'], 'properties': {'leo': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'meta': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['graha', 'rashi', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'rashi': {'type': 'string'}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'avasthaInfo': {'type': 'object', 'properties': {'awastha': {'type': 'object', 'required': ['meaning', 'interpretation'], 'properties': {'meaning': {'type': 'string'}, 'interpretation': {'type': 'string'}}}, 'deeptadi': {'type': 'object', 'required': ['meaning', 'interpretation'], 'properties': {'meaning': {'type': 'string'}, 'interpretation': {'type': 'string'}}}, 'jagradadi': {'type': 'object', 'required': ['meaning', 'interpretation'], 'properties': {'meaning': {'type': 'string'}, 'interpretation': {'type': 'string'}}}}}, 'isRetrograde': {'type': 'boolean'}}}}, 'aries': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'libra': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'virgo': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'yogas': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'description', 'result', 'quality', 'family', 'present'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'family': {'enum': ['classical', 'asraya', 'dala', 'akriti', 'sankhya'], 'type': 'string'}, 'result': {'type': 'string'}, 'present': {'type': 'boolean'}, 'quality': {'enum': ['Positive', 'Negative', 'Both'], 'type': 'string'}, 'evidence': {'type': 'string'}, 'description': {'type': 'string'}, 'suppressedBy': {'enum': ['classical', 'asraya', 'dala', 'akriti', 'sankhya'], 'type': 'string'}}}}, 'cancer': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'gemini': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'houses': {'type': 'array', 'items': {'type': 'object', 'required': ['number'], 'properties': {'name': {'type': 'string'}, 'number': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'themes': {'type': 'array', 'items': {'type': 'string'}}, 'description': {'type': 'string'}}}}, 'pisces': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'taurus': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'scorpio': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'aquarius': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'capricorn': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'combustion': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'distanceFromSun', 'orb'], 'properties': {'orb': {'type': 'number'}, 'planet': {'type': 'string'}, 'distanceFromSun': {'type': 'number'}}}}, 'sagittarius': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'deeptadi': {'enum': ['Dipta', 'Svastha', 'Pramudita', 'Shanta', 'Dina', 'Duhkhita', 'Vikala', 'Khala', 'Kopa'], 'type': 'string'}, 'jagradadi': {'enum': ['Jagrat', 'Swapna', 'Sushupti'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}, 'planetaryWar': {'type': 'array', 'items': {'type': 'object', 'required': ['planet1', 'planet2', 'distance', 'winner'], 'properties': {'winner': {'type': 'string'}, 'planet1': {'type': 'string'}, 'planet2': {'type': 'string'}, 'distance': {'type': 'number'}}}}, 'modernPlanets': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'sanskritName', 'longitude', 'rashi', 'degreeInRashi', 'nakshatra', 'isRetrograde'], 'properties': {'rashi': {'type': 'string'}, 'planet': {'enum': ['Uranus', 'Neptune', 'Pluto'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}, 'sanskritName': {'enum': ['Arun', 'Varun', 'Yam'], 'type': 'string'}, 'degreeInRashi': {'type': 'number'}}}}, 'interpretations': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['rashi', 'nakshatra'], 'properties': {'rashi': {'type': 'string'}, 'nakshatra': {'type': 'string'}}}}}}

post_vedic_astrology_chara_karakas

Get Chara Karakas including Atmakaraka - Jaimini Karaka Calculator API

Calculate the Chara Karakas of Jaimini astrology from birth details: the movable significators assigned by ranking each graha on how far it has advanced into its sign. The highest becomes the Atmakaraka, the soul significator and the strongest influence in the chart, and the rest take the Amatya, Bhratri, Matri, Pitri, Putra, Gnati and Dara offices in descending order. Supports both the eight-karaka scheme, where Rahu is included with its degree reversed, and the seven-karaka scheme that excludes the nodes, because the two can name a different Atmakaraka for the same chart. Atmakaraka calculator API, Darakaraka, Jaimini chara karaka, Vedic astrology soul significator.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'scheme': {'enum': ['seven', 'eight'], 'type': 'string', 'default': 'eight', 'example': 'eight', 'description': 'Which Chara Karaka scheme to rank. "eight" includes Rahu, counting its degree in reverse because it moves retrograde, and returns eight offices including Pitrikaraka. "seven" ranks only the seven classical grahas and drops Pitrikaraka. Ketu is excluded from both, since it always mirrors the Rahu degree exactly. The two schemes can produce a different Atmakaraka for the same chart, so select the one your reference software uses. Defaults to "eight".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'scheme', 'atmakaraka', 'darakaraka', 'karakas'], 'properties': {'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'scheme': {'enum': ['seven', 'eight'], 'type': 'string'}, 'karakas': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'abbreviation', 'graha', 'rashi', 'degreeInRashi', 'rankingDegree', 'isReversed', 'meaning', 'significations'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'graha': {'type': 'string'}, 'rashi': {'type': 'string'}, 'meaning': {'type': 'string'}, 'isReversed': {'type': 'boolean'}, 'abbreviation': {'type': 'string'}, 'degreeInRashi': {'type': 'number'}, 'rankingDegree': {'type': 'number'}, 'significations': {'type': 'string'}}}}, 'atmakaraka': {'type': 'string'}, 'darakaraka': {'type': 'string'}}}

post_vedic_astrology_compatibility

Calculate compatibility score - Gun Milan API (Ashtakoot Matching)

Calculate detailed Ashtakoot compatibility (Gun Milan) for kundli matching between two people. Returns accurate 36-point Guna Milan scale with breakdown across all 8 kootas (Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi), Nadi and Bhakoot dosha detection with classical cancellation analysis per Muhurta Martanda and BPHS rules, and marriage recommendation. Perfect for kundli matching for marriage, matrimonial platforms, horoscope compatibility, and Vedic matchmaking services.

Read only

Input schema

{'type': 'object', 'examples': [{'person1': {'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}, 'person2': {'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}}], 'required': ['person1', 'person2'], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'person1': {'type': 'object', 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}}, 'description': 'Birth data of the first person (typically the boy/groom in traditional Ashtakoot matching). Date, time, and location determine Moon nakshatra for koota scoring.'}, 'person2': {'type': 'object', 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}}, 'description': 'Birth data of the second person (typically the girl/bride in traditional Ashtakoot matching). Moon nakshatra compared against person 1 across all 8 kootas.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'total', 'maxScore', 'percentage', 'isCompatible', 'recommendation', 'doshas', 'doshaCancellations', 'breakdown'], 'properties': {'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'total': {'type': 'number'}, 'doshas': {'type': 'array', 'items': {'type': 'string'}}, 'maxScore': {'type': 'number'}, 'breakdown': {'type': 'array', 'items': {'type': 'object', 'required': ['category', 'score', 'maxScore', 'person1', 'person2', 'description'], 'properties': {'score': {'type': 'number'}, 'person1': {'type': 'string'}, 'person2': {'type': 'string'}, 'category': {'type': 'string'}, 'maxScore': {'type': 'number'}, 'description': {'type': 'string'}}}}, 'percentage': {'type': 'number'}, 'isCompatible': {'type': 'boolean'}, 'recommendation': {'type': 'string'}, 'doshaCancellations': {'type': 'array', 'items': {'type': 'object', 'required': ['dosha', 'reason'], 'properties': {'dosha': {'type': 'string'}, 'reason': {'type': 'string'}}}}}}

post_vedic_astrology_compatibility_dashakoot

Calculate ten porutham match - Dashakoot South Indian Kundli Matching API

Calculate the South Indian ten porutham marriage match (Dashakoot, also called Dasa Porutham) for two birth records. Returns a pass or fail on each of Dina, Gana, Mahendra, Stree Deergha, Yoni, Rasi, Rasyadhipati, Vasya, Rajju and Vedha, a total out of ten, and Rajju and Vedha as explicit hard vetoes that disqualify a match whatever the rest of the sheet reads. This is a different system from the 36 point Ashtakoot Gun Milan on POST /vedic-astrology/compatibility and the two are never reconciled, so a Tamil, Malayalam or Telugu matrimonial desk can read the sheet it actually uses. Direction matters: person1 is the groom and person2 is the bride, because five of the ten poruthams count from the bride birth star to the groom birth star.

Read only

Input schema

{'type': 'object', 'examples': [{'person1': {'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}, 'person2': {'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}}], 'required': ['person1', 'person2'], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'person1': {'type': 'object', 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}}, 'description': 'Birth data of the GROOM. Direction is load bearing in this system: Dina, Mahendra, Stree Deergha, Rasi and Vasya all count from the bride toward the groom, so sending the two people the wrong way round returns a different and wrong sheet without any error.'}, 'person2': {'type': 'object', 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}}, 'description': 'Birth data of the BRIDE. Five of the ten poruthams count FROM this birth star, so this field is not interchangeable with person1. Date, time and location determine the Moon nakshatra and Moon rashi every porutham reads.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'total', 'maxTotal', 'verdict', 'recommendation', 'rajju', 'vedha', 'breakdown'], 'properties': {'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'rajju': {'type': 'object', 'required': ['active', 'reason'], 'properties': {'active': {'type': 'boolean'}, 'reason': {'type': 'string'}}}, 'total': {'type': 'number'}, 'vedha': {'type': 'object', 'required': ['active', 'reason'], 'properties': {'active': {'type': 'boolean'}, 'reason': {'type': 'string'}}}, 'verdict': {'enum': ['recommended', 'marginal', 'rejected'], 'type': 'string'}, 'maxTotal': {'type': 'number'}, 'breakdown': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'points', 'maxPoints', 'verdict', 'person1', 'person2', 'note'], 'properties': {'name': {'enum': ['Dina', 'Gana', 'Mahendra', 'Stree Deergha', 'Yoni', 'Rasi', 'Rasyadhipati', 'Vasya', 'Rajju', 'Vedha'], 'type': 'string'}, 'note': {'type': 'string'}, 'points': {'type': 'number'}, 'person1': {'type': 'string'}, 'person2': {'type': 'string'}, 'verdict': {'enum': ['matched', 'unmatched'], 'type': 'string'}, 'maxPoints': {'type': 'number'}}}}, 'recommendation': {'type': 'string'}}}

post_vedic_astrology_compatibility_papasamyam

Compare malefic affliction - Papasamyam Kundli Matching API

Calculate Papasamyam, the balance of malefic (papa) points between two birth charts, for Vedic marriage matching. Counts Mars, Saturn, Sun and Rahu sitting in the afflicting bhavas 1, 2, 4, 7, 8 and 12 read from three reference points in each chart, the Lagna weighted 1, the Moon weighted 0.5 and Venus weighted 0.25, and returns both totals with the graha, the bhava and the weight behind every point. The verdict is a comparison and never a judgement on one person: the bride total must be equal to or below the groom total, so a heavily afflicted groom matched with a comparably afflicted bride reads as balanced while an unafflicted groom matched with an afflicted bride does not. Use it beside Gun Milan and the ten porutham sheet on a matrimonial platform, since a koota score says nothing about malefic balance.

Read only

Input schema

{'type': 'object', 'examples': [{'person1': {'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}, 'person2': {'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}}], 'required': ['person1', 'person2'], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'person1': {'type': 'object', 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}}, 'description': 'Birth data of the GROOM. The comparison is directional, so this field is not interchangeable with person2: the match reads as balanced only when the bride carries no more affliction than the groom, and swapping the two people can flip the verdict.'}, 'person2': {'type': 'object', 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}}, 'description': 'Birth data of the BRIDE. Date, time and location determine the Lagna, the Moon and Venus, which are the three points every papa point is counted from.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'person1', 'person2', 'verdict', 'recommendation'], 'properties': {'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'person1': {'type': 'object', 'required': ['total', 'byReference'], 'properties': {'total': {'type': 'number'}, 'byReference': {'type': 'array', 'items': {'type': 'object', 'required': ['reference', 'weight', 'afflictions'], 'properties': {'weight': {'type': 'number'}, 'reference': {'enum': ['Lagna', 'Moon', 'Venus'], 'type': 'string'}, 'afflictions': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'house'], 'properties': {'graha': {'enum': ['Mars', 'Saturn', 'Sun', 'Rahu'], 'type': 'string'}, 'house': {'type': 'number'}}}}}}}}}, 'person2': {'type': 'object', 'required': ['total', 'byReference'], 'properties': {'total': {'type': 'number'}, 'byReference': {'type': 'array', 'items': {'type': 'object', 'required': ['reference', 'weight', 'afflictions'], 'properties': {'weight': {'type': 'number'}, 'reference': {'enum': ['Lagna', 'Moon', 'Venus'], 'type': 'string'}, 'afflictions': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'house'], 'properties': {'graha': {'enum': ['Mars', 'Saturn', 'Sun', 'Rahu'], 'type': 'string'}, 'house': {'type': 'number'}}}}}}}}}, 'verdict': {'enum': ['balanced', 'unbalanced'], 'type': 'string'}, 'recommendation': {'type': 'string'}}}

post_vedic_astrology_daily

Daily Reading - Composed Gochara, Panchanga and Dasha for one native on one day

The composed Vedic daily reading for one native on one date, in one call. Runs classical Gochara as the gate pipeline the texts describe: the house each transiting graha makes from the natal Moon (Janma Rashi), the vedha pair that can cancel it, the Ashtakavarga bindu gate that decides whether it is delivered, and the Phaladeepika XXVI.30 to XXVI.32 nullifiers, so every graha lands in ONE cited state rather than a bar of a chart. Joined to the panchanga day, which runs sunrise to sunrise with a validity window on every limb, plus tarabala and chandrabala resolved for THIS native as windows rather than as one value, the running Vimshottari chain three levels deep, and a KP finance net over the wealth and loss houses. Ships a hand-reproducible strength score with its arithmetic published in the field itself, and states plainly which part is classical and which part is a RoxyAPI counting convention. Positions are computed in the Lahiri sidereal frame; the KP significators behind the finance area use the KP-Newcomb frame, as they do on every KP route.

Read only

Input schema

{'type': 'object', 'examples': [{'latitude': 28.8944, 'birthDate': '1984-11-03', 'birthTime': '01:35:00', 'longitude': 76.5894}], 'required': ['birthDate', 'birthTime', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '2026-06-21', 'description': 'Civil date to read, in YYYY-MM-DD format. Defaults to today (UTC). The panchanga day it names runs from sunrise at the birth coordinates to the next sunrise, not from midnight, so a reading for this date covers the night that follows it.'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'latitude': {'type': 'number', 'example': 28.8944, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Sets the natal house cusps behind the Ashtakavarga scorecard and the KP significators, and the sunrise that opens the panchanga day.'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': 'Lunar node type for Rahu and Ketu. "mean" uses the smooth mean node, which is the traditional Vedic default and what printed panchangs use. "true" uses the osculating node, which swings up to 1.5 degrees either side of mean and can therefore move a node into a different rashi and change its gochara house. Defaults to "mean".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': 'Timezone: IANA name (e.g. "Asia/Kolkata", "America/New_York") OR decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). IANA strings are resolved to the DST-correct offset for the date being read. Interprets the birth time and the civil date below. Defaults to 5.5.'}, 'birthDate': {'type': 'string', 'format': 'date', 'example': '1984-11-03', 'description': 'Birth date in YYYY-MM-DD format. Fixes the Janma Rashi and Janma Nakshatra every part of this reading is counted from, and the natal Ashtakavarga the bindu gate reads.'}, 'birthTime': {'type': 'string', 'format': 'time', 'example': '01:35:00', 'description': 'Birth time in HH:MM:SS format (24-hour). The Moon moves about half a degree an hour, so an error here moves the Janma Rashi and Janma Nakshatra and therefore every gochara house count, the tarabala and the chandrabala in this response.'}, 'longitude': {'type': 'number', 'example': 76.5894, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local sidereal time for the natal cusps and the sunrise the reading is composed at.'}}}

Output schema

{'type': 'object', 'required': ['frames', 'date', 'dayStart', 'dayEnd', 'subject', 'panchanga', 'grahas', 'tara', 'chandrabala', 'dasha', 'areas', 'score', 'verdict', 'tally', 'evaluated', 'degraded', 'houseThemes', 'focus'], 'properties': {'date': {'type': 'string'}, 'tara': {'type': 'array', 'items': {'type': 'object', 'required': ['validFrom', 'validTo', 'timescale', 'moonNakshatra', 'number', 'name', 'quality'], 'properties': {'name': {'enum': ['Janma', 'Sampat', 'Vipat', 'Kshema', 'Pratyari', 'Sadhaka', 'Vadha', 'Mitra', 'Parama Mitra'], 'type': 'string'}, 'number': {'type': 'number'}, 'quality': {'enum': ['favourable', 'unfavourable', 'neutral'], 'type': 'string'}, 'validTo': {'type': 'string'}, 'timescale': {'enum': ['hours', 'days', 'months', 'years'], 'type': 'string'}, 'validFrom': {'type': 'string'}, 'moonNakshatra': {'type': 'string'}}}}, 'areas': {'type': 'object', 'required': ['finance'], 'properties': {'finance': {'type': 'object', 'required': ['score', 'band', 'positive', 'negative', 'drivers', 'cautions', 'composite', 'natal'], 'properties': {'band': {'enum': ['very-strong', 'strong', 'moderate', 'weak', None], 'type': ['string', 'null']}, 'natal': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'quality', 'present', 'evidence'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'present': {'type': 'boolean'}, 'quality': {'enum': ['Positive', 'Negative', 'Both'], 'type': 'string'}, 'evidence': {'type': 'string'}}}}, 'score': {'type': ['number', 'null']}, 'drivers': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['graha', 'house', 'level', 'grade', 'dashaLevels'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'graha': {'type': 'string'}, 'house': {'type': 'number'}, 'level': {'type': 'integer', 'maximum': 4, 'minimum': 1}, 'dashaLevels': {'type': 'array', 'items': {'enum': ['mahadasha', 'antardasha', 'pratyantardasha'], 'type': 'string'}}}}}, 'cautions': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['graha', 'house', 'level', 'grade', 'dashaLevels'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'graha': {'type': 'string'}, 'house': {'type': 'number'}, 'level': {'type': 'integer', 'maximum': 4, 'minimum': 1}, 'dashaLevels': {'type': 'array', 'items': {'enum': ['mahadasha', 'antardasha', 'pratyantardasha'], 'type': 'string'}}}}}, 'negative': {'type': ['number', 'null']}, 'positive': {'type': ['number', 'null']}, 'composite': {'type': ['object', 'null'], 'required': ['score', 'band', 'layers'], 'properties': {'band': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number'}, 'layers': {'type': 'array', 'items': {'type': 'object', 'required': ['layer', 'score', 'band'], 'properties': {'band': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'layer': {'enum': ['day', 'finance', 'natal'], 'type': 'string'}, 'score': {'type': 'number'}}}}}}}}}}, 'dasha': {'type': 'array', 'items': {'type': 'object', 'required': ['level', 'lord', 'startDate', 'endDate', 'timescale'], 'properties': {'lord': {'type': 'string'}, 'level': {'enum': ['mahadasha', 'antardasha', 'pratyantardasha'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'timescale': {'enum': ['hours', 'days', 'months', 'years'], 'type': 'string'}}}}, 'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'score': {'type': 'number'}, 'tally': {'type': 'array', 'items': {'type': 'object', 'required': ['state', 'count'], 'properties': {'count': {'type': 'number'}, 'state': {'enum': ['favourable', 'underdelivered', 'obstructed', 'void', 'aggravated', 'unfavourable'], 'type': 'string'}}}}, 'dayEnd': {'type': 'string'}, 'frames': {'type': 'object', 'required': ['natal', 'transit', 'kp'], 'properties': {'kp': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees', 'at', 'governs'], 'properties': {'at': {'type': 'string'}, 'governs': {'type': 'array', 'items': {'enum': ['subject', 'grahas', 'panchanga', 'tara', 'chandrabala', 'dasha', 'areas.finance'], 'type': 'string'}}, 'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'natal': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees', 'at', 'governs'], 'properties': {'at': {'type': 'string'}, 'governs': {'type': 'array', 'items': {'enum': ['subject', 'grahas', 'panchanga', 'tara', 'chandrabala', 'dasha', 'areas.finance'], 'type': 'string'}}, 'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'transit': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees', 'at', 'governs'], 'properties': {'at': {'type': 'string'}, 'governs': {'type': 'array', 'items': {'enum': ['subject', 'grahas', 'panchanga', 'tara', 'chandrabala', 'dasha', 'areas.finance'], 'type': 'string'}}, 'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}}}, 'grahas': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'sign', 'longitude', 'houseFromMoon', 'timescale', 'favourable', 'favourableHouses', 'vedhaHouse', 'obstructedBy', 'vedhaExempt', 'binduCount', 'kaksha', 'dignity', 'combust', 'aspectedByBenefic', 'aspectedByMalefic', 'aspectedByEnemy', 'state', 'stateSource'], 'properties': {'sign': {'type': 'string'}, 'graha': {'type': 'string'}, 'state': {'enum': ['favourable', 'underdelivered', 'obstructed', 'void', 'aggravated', 'unfavourable'], 'type': 'string'}, 'kaksha': {'type': 'object', 'required': ['number', 'lord', 'startDegree', 'endDegree', 'bindu', 'binduCount'], 'properties': {'lord': {'type': 'string'}, 'bindu': {'type': ['boolean', 'null']}, 'number': {'type': 'number'}, 'endDegree': {'type': 'number'}, 'binduCount': {'type': ['number', 'null']}, 'startDegree': {'type': 'number'}}}, 'combust': {'type': ['boolean', 'null']}, 'dignity': {'enum': ['exalted', 'own', 'debilitated', 'enemy', 'neutral', None], 'type': ['string', 'null']}, 'longitude': {'type': 'number'}, 'timescale': {'enum': ['hours', 'days', 'months', 'years'], 'type': 'string'}, 'binduCount': {'type': ['number', 'null']}, 'favourable': {'type': 'boolean'}, 'vedhaHouse': {'type': ['number', 'null']}, 'stateSource': {'type': 'string'}, 'vedhaExempt': {'type': 'array', 'items': {'type': 'string'}}, 'obstructedBy': {'type': 'array', 'items': {'type': 'string'}}, 'houseFromMoon': {'type': 'number'}, 'aspectedByEnemy': {'type': 'array', 'items': {'type': 'string'}}, 'favourableHouses': {'type': 'array', 'items': {'type': 'number'}}, 'aspectedByBenefic': {'type': 'array', 'items': {'type': 'string'}}, 'aspectedByMalefic': {'type': 'array', 'items': {'type': 'string'}}}}}, 'subject': {'type': 'object', 'required': ['janmaRashi', 'janmaNakshatra', 'janmaNakshatraNumber', 'moonLongitude'], 'properties': {'janmaRashi': {'type': 'string'}, 'moonLongitude': {'type': 'number'}, 'janmaNakshatra': {'type': 'string'}, 'janmaNakshatraNumber': {'type': 'number'}}}, 'verdict': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'dayStart': {'type': 'string'}, 'degraded': {'type': 'array', 'items': {'type': 'object', 'required': ['component', 'reason'], 'properties': {'reason': {'enum': ['sun-does-not-rise', 'polar-latitude'], 'type': 'string'}, 'component': {'enum': ['dayStart', 'dayEnd', 'areas.finance.score'], 'type': 'string'}}}}, 'evaluated': {'type': 'number'}, 'panchanga': {'type': 'object', 'required': ['vara', 'varaSanskrit', 'paksha', 'tithi', 'nakshatra', 'yoga', 'karana'], 'properties': {'vara': {'type': 'string'}, 'yoga': {'type': 'object', 'required': ['number', 'name', 'validTo', 'next', 'timescale'], 'properties': {'name': {'type': 'string'}, 'next': {'type': 'string'}, 'number': {'type': 'number'}, 'validTo': {'type': 'string'}, 'timescale': {'enum': ['hours', 'days', 'months', 'years'], 'type': 'string'}}}, 'tithi': {'type': 'object', 'required': ['number', 'name', 'validTo', 'next', 'timescale'], 'properties': {'name': {'type': 'string'}, 'next': {'type': 'string'}, 'number': {'type': 'number'}, 'validTo': {'type': 'string'}, 'timescale': {'enum': ['hours', 'days', 'months', 'years'], 'type': 'string'}}}, 'karana': {'type': 'object', 'required': ['number', 'name', 'validTo', 'next', 'timescale'], 'properties': {'name': {'type': 'string'}, 'next': {'type': 'string'}, 'number': {'type': 'number'}, 'validTo': {'type': 'string'}, 'timescale': {'enum': ['hours', 'days', 'months', 'years'], 'type': 'string'}}}, 'paksha': {'type': 'string'}, 'nakshatra': {'type': 'object', 'required': ['number', 'name', 'validTo', 'next', 'timescale'], 'properties': {'name': {'type': 'string'}, 'next': {'type': 'string'}, 'number': {'type': 'number'}, 'validTo': {'type': 'string'}, 'timescale': {'enum': ['hours', 'days', 'months', 'years'], 'type': 'string'}}}, 'varaSanskrit': {'type': 'string'}}}, 'chandrabala': {'type': 'array', 'items': {'type': 'object', 'required': ['validFrom', 'validTo', 'timescale', 'moonSign', 'houseFromMoon', 'favourable', 'ashtamaChandra'], 'properties': {'validTo': {'type': 'string'}, 'moonSign': {'type': 'string'}, 'timescale': {'enum': ['hours', 'days', 'months', 'years'], 'type': 'string'}, 'validFrom': {'type': 'string'}, 'favourable': {'type': 'boolean'}, 'houseFromMoon': {'type': 'number'}, 'ashtamaChandra': {'type': 'boolean'}}}}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}}}

post_vedic_astrology_dasha_current

Get current Mahadasha, Antardasha, Pratyantardasha, Sookshma, Prana - Dasha Calculator API

Calculate all five running Vimshottari Dasha levels with remaining time in each. The levels are Mahadasha, Antardasha, Pratyantardasha, Sookshma, and Prana. Accurate dasha calculator API for life phase prediction and planetary period analysis. Returns the dasha timeline with start/end dates for every level, ready for a current DBA readout down to hour-level timing. Pass datetime to read the five lords at any moment instead of now, which is what a reading prepared for tomorrow or a backtest over a past day needs. Set significators true to add the KP star lord, sub lord, signified houses and strength grade of each running lord, plus the houses they have in common. Essential for understanding current planetary influences, dasha transitions, and timing events in Vedic astrology. 120-year dasha system based on moon nakshatra at birth, with selectable Lahiri or KP ayanamsa.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.'}, 'datetime': {'type': 'string', 'format': 'date-time', 'example': '2026-08-23T13:47:46Z', 'description': 'ISO 8601 datetime (YYYY-MM-DDTHH:MM:SS) to read the running periods at, for a reading prepared for a future day, a backtest, or a chart cast for a past moment. Defaults to the current instant. Interpreted as local time in the request timezone (a trailing Z is accepted but ignored); with timezone 0 it is UTC.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': 'Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}, 'significators': {'type': 'boolean', 'default': False, 'example': False, 'description': 'Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.'}}}

Output schema

{'type': 'object', 'required': ['moonNakshatra', 'nakshatraName', 'nakshatraLord', 'moonLongitude', 'ayanamsa', 'ayanamsaType', 'mahadasha', 'antardasha', 'pratyantardasha', 'sookshmaDasha', 'pranaDasha', 'remainingInMahadasha', 'remainingInAntardasha', 'remainingInPratyantardasha', 'remainingInSookshma', 'remainingInPrana'], 'properties': {'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'ayanamsa': {'type': 'number'}, 'mahadasha': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}}}, 'antardasha': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears', 'mahadashaLord'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}}}, 'pranaDasha': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears', 'mahadashaLord', 'antardashaLord', 'pratyantardashaLord', 'sookshmaLord'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'sookshmaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'durationYears': {'type': 'number'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'antardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}, 'pratyantardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}}}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'ayanamsaType': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string'}, 'commonHouses': {'type': 'object', 'required': ['allLevels', 'dashaBhuktiAntara'], 'properties': {'allLevels': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'dashaBhuktiAntara': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'moonLongitude': {'type': 'number'}, 'moonNakshatra': {'type': 'integer', 'maximum': 27, 'minimum': 1}, 'nakshatraLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'nakshatraName': {'type': 'string'}, 'sookshmaDasha': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears', 'mahadashaLord', 'antardashaLord', 'pratyantardashaLord'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'antardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}, 'pratyantardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}}}, 'pratyantardasha': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears', 'mahadashaLord', 'antardashaLord'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'antardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}}}, 'remainingInPrana': {'type': 'object', 'required': ['years', 'months', 'days', 'totalDays'], 'properties': {'days': {'type': 'number'}, 'years': {'type': 'number'}, 'months': {'type': 'number'}, 'totalDays': {'type': 'number'}}}, 'remainingInSookshma': {'type': 'object', 'required': ['years', 'months', 'days', 'totalDays'], 'properties': {'days': {'type': 'number'}, 'years': {'type': 'number'}, 'months': {'type': 'number'}, 'totalDays': {'type': 'number'}}}, 'remainingInMahadasha': {'type': 'object', 'required': ['years', 'months', 'days', 'totalDays'], 'properties': {'days': {'type': 'number'}, 'years': {'type': 'number'}, 'months': {'type': 'number'}, 'totalDays': {'type': 'number'}}}, 'remainingInAntardasha': {'type': 'object', 'required': ['years', 'months', 'days', 'totalDays'], 'properties': {'days': {'type': 'number'}, 'years': {'type': 'number'}, 'months': {'type': 'number'}, 'totalDays': {'type': 'number'}}}, 'remainingInPratyantardasha': {'type': 'object', 'required': ['years', 'months', 'days', 'totalDays'], 'properties': {'days': {'type': 'number'}, 'years': {'type': 'number'}, 'months': {'type': 'number'}, 'totalDays': {'type': 'number'}}}}}

post_vedic_astrology_dasha_major

Get all 9 Mahadasha periods (120-year cycle)

Returns the complete Vimshottari dasha cycle from birth, all 9 Mahadasha periods across the full 120 year span. Each period carries its ruling graha, exact start and end dates, and the houses it signifies, with the birth dasha balance and Moon nakshatra that anchor the sequence. This is the top level timeline a Vedic astrology report opens with, and the entry point for drilling into Antardasha and finer sub periods.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': 'Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}, 'significators': {'type': 'boolean', 'default': False, 'example': False, 'description': 'Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.'}}}

Output schema

{'type': 'object', 'required': ['moonNakshatra', 'nakshatraName', 'nakshatraLord', 'moonLongitude', 'ayanamsa', 'ayanamsaType', 'birthDashaBalance', 'mahadashas', 'totalYears'], 'properties': {'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'ayanamsa': {'type': 'number'}, 'mahadashas': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}}}}, 'totalYears': {'type': 'number'}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'ayanamsaType': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string'}, 'moonLongitude': {'type': 'number'}, 'moonNakshatra': {'type': 'integer', 'maximum': 27, 'minimum': 1}, 'nakshatraLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'nakshatraName': {'type': 'string'}, 'birthDashaBalance': {'type': 'object', 'required': ['years', 'months', 'days', 'totalDays'], 'properties': {'days': {'type': 'number'}, 'years': {'type': 'number'}, 'months': {'type': 'number'}, 'totalDays': {'type': 'number'}}}}}

post_vedic_astrology_dasha_sub_mahadasha

Get all Antardashas (sub-periods) for a specific Mahadasha

Returns the 9 Antardasha sub periods inside a chosen Mahadasha, each proportional to the Vimshottari years of its lord. Every period carries its ruling graha, exact start and end dates, and the houses it signifies, alongside the parent Mahadasha it sits in. Use it to narrow a multi year Mahadasha down to the months that matter for event prediction, muhurta selection, and dasha timeline UIs.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209, 'mahadasha': 'Jupiter'}], 'required': ['mahadasha', 'date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': 'Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'mahadasha': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string', 'example': 'Jupiter', 'description': 'Mahadasha planet name, case-insensitive (e.g., jupiter, Jupiter, JUPITER all work). Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}, 'significators': {'type': 'boolean', 'default': False, 'example': False, 'description': 'Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.'}}}

Output schema

{'type': 'object', 'required': ['mahadashaLord', 'moonLongitude', 'ayanamsa', 'ayanamsaType', 'mahadashaPeriod', 'antardashas'], 'properties': {'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'ayanamsa': {'type': 'number'}, 'antardashas': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears', 'mahadashaLord'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}}}, 'maxItems': 9, 'minItems': 1}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'ayanamsaType': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'moonLongitude': {'type': 'number'}, 'mahadashaPeriod': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}}}}}

post_vedic_astrology_dasha_sub_mahadasha_antardasha

Get all Pratyantardashas (antara periods) for a Mahadasha and Antardasha

Pratyantardasha calculator API for Vedic astrology. Returns the 9 Pratyantardasha (antara) periods inside a chosen Antardasha, the third level of the Vimshottari dasha hierarchy. Use it to drill from a Mahadasha into month level timing for event prediction, muhurta selection, and dasha timeline UIs. Each period is proportional to the Vimshottari years of its lord.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209, 'mahadasha': 'Saturn', 'antardasha': 'Venus'}], 'required': ['mahadasha', 'antardasha', 'date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': 'Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'mahadasha': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string', 'example': 'Saturn', 'description': 'Mahadasha planet name, case-insensitive (e.g. saturn, Saturn, SATURN all work). Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury.'}, 'antardasha': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string', 'example': 'Venus', 'description': 'Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive. Every Mahadasha contains all 9 lords, so a repeat such as saturn/saturn is valid.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}, 'significators': {'type': 'boolean', 'default': False, 'example': False, 'description': 'Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.'}}}

Output schema

{'type': 'object', 'required': ['mahadashaLord', 'antardashaLord', 'moonLongitude', 'ayanamsa', 'ayanamsaType', 'antardashaPeriod', 'pratyantardashas'], 'properties': {'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'ayanamsa': {'type': 'number'}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'ayanamsaType': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'moonLongitude': {'type': 'number'}, 'antardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'antardashaPeriod': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears', 'mahadashaLord'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}}}, 'pratyantardashas': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears', 'mahadashaLord', 'antardashaLord'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'antardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}}}, 'maxItems': 9, 'minItems': 1}}}

post_vedic_astrology_dasha_sub_mahadasha_antardasha_pratyantardasha

Get all Sookshma dashas for a Mahadasha, Antardasha and Pratyantardasha

Sookshma dasha API. Returns the 9 Sookshma periods inside a chosen Pratyantardasha, the fourth and finest level of the Vimshottari dasha hierarchy. Completes a full vimshottari drill down from the 120-year cycle to day level timing, typically 3 to 30 days per period. Built for dasha drill down tables, current DBA readouts, and precise event timing in Vedic astrology software.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209, 'mahadasha': 'Saturn', 'antardasha': 'Venus', 'pratyantardasha': 'Rahu'}], 'required': ['mahadasha', 'antardasha', 'pratyantardasha', 'date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': 'Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'mahadasha': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string', 'example': 'Saturn', 'description': 'Mahadasha planet name, case-insensitive. Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury.'}, 'antardasha': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string', 'example': 'Venus', 'description': 'Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}, 'significators': {'type': 'boolean', 'default': False, 'example': False, 'description': 'Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.'}, 'pratyantardasha': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string', 'example': 'Rahu', 'description': 'Pratyantardasha (antara) planet name inside that Antardasha, case-insensitive.'}}}

Output schema

{'type': 'object', 'required': ['mahadashaLord', 'antardashaLord', 'pratyantardashaLord', 'moonLongitude', 'ayanamsa', 'ayanamsaType', 'pratyantardashaPeriod', 'sookshmaDashas'], 'properties': {'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'ayanamsa': {'type': 'number'}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'ayanamsaType': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'moonLongitude': {'type': 'number'}, 'antardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'sookshmaDashas': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears', 'mahadashaLord', 'antardashaLord', 'pratyantardashaLord'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'antardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}, 'pratyantardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}}}, 'maxItems': 9, 'minItems': 1}, 'pratyantardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'pratyantardashaPeriod': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears', 'mahadashaLord', 'antardashaLord'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'antardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}}}}}

post_vedic_astrology_dasha_sub_mahadasha_antardasha_pratyantardasha_sookshma

Get all Prana dashas for a Mahadasha, Antardasha, Pratyantardasha and Sookshma

Prana dasha API for Vedic astrology. Returns the 9 Prana periods inside a chosen Sookshma dasha, the fifth and finest level of the Vimshottari dasha hierarchy. Completes the full vimshottari drill down from the 120-year cycle to hour level timing, typically 20 minutes to 4 days per period depending on the parent Mahadasha. Built for five column dasha drill down tables, muhurta selection, and pinpointing the trigger moment inside an event window already found at the Sookshma level.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'sookshma': 'Jupiter', 'longitude': 77.209, 'mahadasha': 'Saturn', 'antardasha': 'Venus', 'pratyantardasha': 'Rahu'}], 'required': ['mahadasha', 'antardasha', 'pratyantardasha', 'sookshma', 'date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': 'Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".'}, 'sookshma': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string', 'example': 'Jupiter', 'description': 'Sookshma dasha planet name inside that Pratyantardasha, case-insensitive. Every full period contains all 9 lords, so a repeat such as saturn/saturn/saturn/saturn is valid.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'mahadasha': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string', 'example': 'Saturn', 'description': 'Mahadasha planet name, case-insensitive. Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury.'}, 'antardasha': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string', 'example': 'Venus', 'description': 'Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}, 'significators': {'type': 'boolean', 'default': False, 'example': False, 'description': 'Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.'}, 'pratyantardasha': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string', 'example': 'Rahu', 'description': 'Pratyantardasha (antara) planet name inside that Antardasha, case-insensitive.'}}}

Output schema

{'type': 'object', 'required': ['mahadashaLord', 'antardashaLord', 'pratyantardashaLord', 'sookshmaLord', 'moonLongitude', 'ayanamsa', 'ayanamsaType', 'sookshmaPeriod', 'pranaDashas'], 'properties': {'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'ayanamsa': {'type': 'number'}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'pranaDashas': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears', 'mahadashaLord', 'antardashaLord', 'pratyantardashaLord', 'sookshmaLord'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'sookshmaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'durationYears': {'type': 'number'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'antardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}, 'pratyantardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}}}, 'maxItems': 9, 'minItems': 1}, 'ayanamsaType': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string'}, 'sookshmaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'moonLongitude': {'type': 'number'}, 'antardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'sookshmaPeriod': {'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'durationYears', 'mahadashaLord', 'antardashaLord', 'pratyantardashaLord'], 'properties': {'planet': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'durationYears': {'type': 'number'}, 'mahadashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'significators': {'type': 'object', 'required': ['house', 'starLord', 'signifies', 'signifiedHouses', 'strongHouses', 'strength'], 'properties': {'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'strength': {'type': 'object', 'required': ['score', 'grade', 'label'], 'properties': {'grade': {'enum': ['A', 'B', 'C', 'D'], 'type': 'string'}, 'label': {'enum': ['very-strong', 'strong', 'moderate', 'weak'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}, 'signifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'strongHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}, 'signifiedHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}}}}, 'antardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'interpretation': {'type': 'string'}, 'nominalStartDate': {'type': 'string'}, 'pratyantardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}}}, 'pratyantardashaLord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}}}

post_vedic_astrology_divisional_chart

Get divisional chart (Varga) - D2 to D60 Calculator

Calculate any Vedic divisional chart (Varga) from D2 Hora to D60 Shashtiamsa. Divisional charts divide each zodiac sign into smaller segments to reveal detailed insights about specific life areas: wealth (D2), siblings (D3), property (D4), children (D7), marriage (D9), career (D10), parents (D12), vehicles (D16), spirituality (D20), education (D24), strength (D27), misfortunes (D30), merit (D40), character (D45), and past life karma (D60). Based on Brihat Parashara Hora Shastra (BPHS) Shodasha Varga system. Detects Vargottama planets (same sign in D1 and selected chart).

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'division': 10, 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude', 'division'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'division': {'type': 'integer', 'example': 10, 'description': 'Divisional chart number. Each division reveals a specific life area. Supported: 2 (Hora, wealth), 3 (Drekkana, siblings), 4 (Chaturthamsa, property), 7 (Saptamsa, children), 9 (Navamsa, marriage), 10 (Dasamsa, career), 12 (Dwadasamsa, parents), 16 (Shodasamsa, vehicles), 20 (Vimsamsa, spirituality), 24 (Chaturvimsamsa, education), 27 (Bhamsa, strength), 30 (Trimsamsa, misfortunes), 40 (Khavedamsa, merit), 45 (Akshavedamsa, character), 60 (Shashtiamsa, past life karma).'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['division', 'frame', 'chart', 'vargottama'], 'properties': {'chart': {'type': 'object', 'required': ['meta', 'aries'], 'properties': {'meta': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['graha', 'rashi', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'rashi': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}, 'aries': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}}, 'additionalProperties': {}}, 'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'division': {'type': 'object', 'required': ['number', 'name', 'sanskritName', 'degreesPerDivision', 'significance'], 'properties': {'name': {'type': 'string'}, 'number': {'type': 'integer'}, 'sanskritName': {'type': 'string'}, 'significance': {'type': 'string'}, 'degreesPerDivision': {'type': 'string'}}}, 'vargottama': {'type': 'array', 'items': {'type': 'string'}}}}

post_vedic_astrology_dosha_kalsarpa

Check Kalsarpa Dosha - Kalsarpa Yoga Calculator API

Detect Kalsarpa dosha (Kalsarpa yoga) when all 7 planets are hemmed between Rahu-Ketu axis. Accurate kalsarpa dosha calculator identifying 12 types (Ananta, Kulik, Vasuki, Shankhapala, Padma, Mahapadma, Takshak, Karkotak, Shankhachud, Ghatak, Vishdhar, Sheshnag). Returns severity and effects based on Rahu house position. Essential for Vedic astrology dosha analysis, birth chart evaluation, and matrimonial compatibility. Considered significant dosha affecting life obstacles and spiritual growth.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'present', 'description'], 'properties': {'type': {'type': 'string'}, 'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'effects': {'type': 'object', 'required': ['duration', 'career', 'health', 'relationships', 'mindset', 'positive'], 'properties': {'career': {'type': 'string'}, 'health': {'type': 'string'}, 'mindset': {'type': 'string'}, 'duration': {'type': 'string'}, 'positive': {'type': 'string'}, 'relationships': {'type': 'string'}}}, 'present': {'type': 'boolean'}, 'remedies': {'type': 'array', 'items': {'type': 'string'}}, 'severity': {'enum': ['Mild', 'Moderate', 'Severe'], 'type': 'string'}, 'description': {'type': 'string'}}}

post_vedic_astrology_dosha_manglik

Check Manglik Dosha - Mangal Dosha Calculator API

Detect Manglik dosha (Kuja dosha, Mars dosha) based on Mars position in inauspicious houses (1, 2, 4, 7, 8, 12) from Lagna. Accurate mangal dosha calculator for matrimonial compatibility checks in Vedic astrology. Returns severity levels (Mild/Moderate/Severe) and cancellation factors. Essential for kundli matching for marriage, manglik compatibility, and marriage astrology in matrimonial sites. Includes exceptions that reduce manglik dosha effects.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'present', 'description'], 'properties': {'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'effects': {'type': 'object', 'required': ['marriage', 'personality', 'timing', 'relationships'], 'properties': {'timing': {'type': 'string'}, 'marriage': {'type': 'string'}, 'personality': {'type': 'string'}, 'relationships': {'type': 'string'}}}, 'present': {'type': 'boolean'}, 'remedies': {'type': 'array', 'items': {'type': 'string'}}, 'severity': {'enum': ['Mild', 'Moderate', 'Severe'], 'type': 'string'}, 'exceptions': {'type': 'array', 'items': {'type': 'string'}}, 'description': {'type': 'string'}}}

post_vedic_astrology_dosha_sadhesati

Check Sadhesati - Sade Sati Calculator API (Saturn Transit)

Calculate Sadhesati (Sade Sati) periods when Saturn transits 12th, 1st, and 2nd houses from natal Moon. Accurate sade sati calculator with current status and phase identification (Rising/Peak/Setting). Shani sadhesati 7.5 year period tracker. Returns Saturn transit dates and effects on life. Essential for Saturn transit analysis, sadhesati remedies timing, and understanding challenging Saturn periods in Vedic astrology. Important for timing major life decisions.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'present', 'description'], 'properties': {'type': {'type': 'string'}, 'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'effects': {'type': 'object', 'required': ['general', 'phases'], 'properties': {'phases': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'general': {'type': 'string'}}}, 'present': {'type': 'boolean'}, 'remedies': {'type': 'array', 'items': {'type': 'string'}}, 'severity': {'enum': ['Mild', 'Moderate', 'Severe'], 'type': 'string'}, 'description': {'type': 'string'}}}

post_vedic_astrology_ecliptic_crossings

Ecliptic Crossings - When planets cross the ecliptic plane

Find all ecliptic plane crossings for visible planets during a given year. An ecliptic crossing occurs when a planetary celestial latitude passes through 0 degrees, crossing from one side of the ecliptic to the other. Ascending crossings (south to north) correspond to the ascending node, descending crossings (north to south) to the descending node. Moon crosses ~2 times per month, outer planets cross less frequently. Returns exact date, time, direction, longitude and zodiac sign in the requested coordinateSystem, sidereal by default. Ecliptic crossing API, planetary node crossing, ascending descending node ephemeris.

Read only

Input schema

{'type': 'object', 'examples': [{'year': 2026}], 'required': ['year'], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'year': {'type': 'integer', 'example': 2026, 'maximum': 2649, 'minimum': 1551, 'description': 'Year to scan for ecliptic crossings (1551 to 2649).'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 0, 'example': 5.5, 'description': '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 once, at the start of the window, and that offset applies to every time in the response. Output times are converted to this timezone. Defaults to 0 (UTC).'}, 'coordinateSystem': {'enum': ['sidereal', 'tropical'], 'type': 'string', 'default': 'sidereal', 'example': 'sidereal', 'description': 'Coordinate system for longitude output. "sidereal" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. "tropical" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to "sidereal".'}}}

Output schema

{'type': 'object', 'required': ['year', 'timezone', 'events'], 'properties': {'year': {'type': 'number'}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'date', 'time', 'datetime', 'direction', 'longitude', 'sign'], 'properties': {'date': {'type': 'string'}, 'sign': {'type': 'string'}, 'time': {'type': 'string'}, 'planet': {'type': 'string'}, 'datetime': {'type': 'string'}, 'direction': {'enum': ['ascending', 'descending'], 'type': 'string'}, 'longitude': {'type': 'number'}, 'signLocalized': {'type': 'string'}, 'planetLocalized': {'type': 'string'}}}}, 'timezone': {'type': 'number'}}}

post_vedic_astrology_heliacal

Heliacal rising and setting (udaya and asta) - Graha Asta Calculator API

Calculate heliacal rising (udaya) and setting (asta) of the six visible grahas for any date and place, by the Surya Siddhanta rule. Returns whether each graha currently clears the solar glare, its separation from the Sun in classical degrees of time, and the dates its visibility last changed and next changes. This is the calculation behind Guru Asta and Shukra Asta, the periods classical muhurta withholds marriage and other auspicious ceremonies. Unlike a birth chart combustion flag it is location aware, because the angle the ecliptic makes with the local horizon decides how long a graha lingers after the Sun. Graha asta API, Guru Asta Shukra Asta dates, heliacal rising calculator, planetary combustion muhurta.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '2026-07-25', 'latitude': 19.076, 'longitude': 72.8777}], 'required': ['date', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '2026-07-25', 'description': 'Local calendar date to judge, in YYYY-MM-DD format. There is deliberately no time field: heliacal visibility is a once-a-day verdict read at that day sunrise or sunset, so a clock time could only pick a different day.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'latitude': {'type': 'number', 'example': 19.076, 'maximum': 60, 'minimum': -60, 'description': 'Observer latitude in decimal degrees, restricted to -60 to 60. Visibility depends on the observer, unlike the longitude orb every chart API reports, because the angle the ecliptic makes with the horizon decides how long a graha lingers after the Sun. Beyond this band the classical rule stops describing solar glare and starts describing polar horizon geometry, so it is declined rather than answered wrongly.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': 'Timezone: IANA name (e.g. "Asia/Kolkata", "Europe/London") OR decimal hours from UTC. Fixes which local day the date refers to, and every datetime in the response is returned in it. Defaults to 5.5.'}, 'longitude': {'type': 'number', 'example': 72.8777, 'maximum': 180, 'minimum': -180, 'description': 'Observer longitude in decimal degrees. Sets local sunrise and sunset, which are the instants the verdict is read at. Example: Mumbai 72.8777, Delhi 77.2090, London -0.1278.'}}}

Output schema

{'type': 'object', 'required': ['date', 'grahas'], 'properties': {'date': {'type': 'string'}, 'grahas': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'visible', 'horizon', 'timeDegrees', 'kalamsa', 'retrograde', 'longitudeSeparation', 'lastEvent', 'nextEvent'], 'properties': {'graha': {'type': 'string'}, 'horizon': {'enum': ['east', 'west'], 'type': 'string'}, 'kalamsa': {'type': 'number'}, 'visible': {'type': 'boolean'}, 'lastEvent': {'type': ['object', 'null'], 'required': ['type', 'horizon', 'datetime', 'timeDegrees', 'kalamsa'], 'properties': {'type': {'enum': ['udaya', 'asta'], 'type': 'string'}, 'horizon': {'enum': ['east', 'west'], 'type': 'string'}, 'kalamsa': {'type': 'number'}, 'datetime': {'type': 'string'}, 'timeDegrees': {'type': 'number'}}}, 'nextEvent': {'type': ['object', 'null'], 'required': ['type', 'horizon', 'datetime', 'timeDegrees', 'kalamsa'], 'properties': {'type': {'enum': ['udaya', 'asta'], 'type': 'string'}, 'horizon': {'enum': ['east', 'west'], 'type': 'string'}, 'kalamsa': {'type': 'number'}, 'datetime': {'type': 'string'}, 'timeDegrees': {'type': 'number'}}}, 'retrograde': {'type': 'boolean'}, 'timeDegrees': {'type': 'number'}, 'longitudeSeparation': {'type': 'number'}}}}}}

post_vedic_astrology_kp_chart

Generate complete KP birth chart

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.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. CRITICAL for accurate Lagna and house calculations.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'kp-newcomb', 'example': 'kp-newcomb', 'description': '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".'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': '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".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['meta', 'ascendant', 'cusps', 'planets', 'nodes', 'significators', 'houseThemes', 'focus'], 'properties': {'meta': {'type': 'object', 'required': ['date', 'time', 'latitude', 'longitude', 'timezone', 'ayanamsa', 'ayanamsaType', 'houseSystem'], 'properties': {'date': {'type': 'string'}, 'time': {'type': 'string'}, 'ayanamsa': {'type': 'number'}, 'latitude': {'type': 'number'}, 'timezone': {'type': 'number'}, 'longitude': {'type': 'number'}, 'houseSystem': {'type': 'string'}, 'ayanamsaType': {'type': 'string'}}}, 'cusps': {'type': 'array', 'items': {'type': 'object', 'required': ['house', 'longitude', 'sign', 'signLord', 'nakshatra', 'nakshatraLord', 'pada', 'starLord', 'subLord', 'subSubLord', 'kpNumber'], 'properties': {'pada': {'type': 'number'}, 'sign': {'type': 'string'}, 'house': {'type': 'number'}, 'subLord': {'type': 'string'}, 'kpNumber': {'type': 'number'}, 'signLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'string'}, 'subSubLord': {'type': 'string'}, 'nakshatraLord': {'type': 'string'}}}}, 'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'nodes': {'type': 'object', 'required': ['rahu', 'ketu'], 'properties': {'ketu': {'type': 'object', 'required': ['longitude', 'sign', 'signLord', 'house', 'nakshatra', 'pada', 'starLord', 'subLord', 'subSubLord', 'kpNumber'], 'properties': {'pada': {'type': 'number'}, 'sign': {'type': 'string'}, 'house': {'type': 'number'}, 'subLord': {'type': 'string'}, 'kpNumber': {'type': 'number'}, 'signLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'string'}, 'subSubLord': {'type': 'string'}}}, 'rahu': {'type': 'object', 'required': ['longitude', 'sign', 'signLord', 'house', 'nakshatra', 'pada', 'starLord', 'subLord', 'subSubLord', 'kpNumber'], 'properties': {'pada': {'type': 'number'}, 'sign': {'type': 'string'}, 'house': {'type': 'number'}, 'subLord': {'type': 'string'}, 'kpNumber': {'type': 'number'}, 'signLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'string'}, 'subSubLord': {'type': 'string'}}}}}, 'planets': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'longitude', 'sign', 'signLord', 'house', 'nakshatra', 'nakshatraLord', 'pada', 'starLord', 'subLord', 'subSubLord', 'kpNumber', 'retrograde'], 'properties': {'pada': {'type': 'number'}, 'sign': {'type': 'string'}, 'house': {'type': 'number'}, 'planet': {'type': 'string'}, 'subLord': {'type': 'string'}, 'kpNumber': {'type': 'number'}, 'signLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'string'}, 'retrograde': {'type': 'boolean'}, 'subSubLord': {'type': 'string'}, 'nakshatraLord': {'type': 'string'}}}}, 'ascendant': {'type': 'object', 'required': ['longitude', 'sign', 'signLord', 'nakshatra', 'nakshatraLord', 'pada', 'starLord', 'subLord', 'subSubLord', 'kpNumber'], 'properties': {'pada': {'type': 'number'}, 'sign': {'type': 'string'}, 'subLord': {'type': 'string'}, 'kpNumber': {'type': 'number'}, 'signLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'string'}, 'subSubLord': {'type': 'string'}, 'nakshatraLord': {'type': 'string'}}}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'significators': {'type': 'object', 'required': ['houseWise', 'planetWise'], 'properties': {'houseWise': {'type': 'array', 'items': {'type': 'object', 'required': ['house', 'significators', 'all'], 'properties': {'all': {'type': 'array', 'items': {'type': 'string'}}, 'house': {'type': 'number'}, 'significators': {'type': 'array', 'items': {'type': 'object', 'required': ['level', 'description', 'planets'], 'properties': {'level': {'type': 'number'}, 'planets': {'type': 'array', 'items': {'type': 'string'}}, 'description': {'type': 'string'}}}}}}}, 'planetWise': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'signifies', 'allHouses'], 'properties': {'planet': {'type': 'string'}, 'allHouses': {'type': 'array', 'items': {'type': 'number'}}, 'signifies': {'type': 'array', 'items': {'type': 'object', 'required': ['level', 'houses'], 'properties': {'level': {'type': 'number'}, 'houses': {'type': 'array', 'items': {'type': 'number'}}}}}}}}}}}}

post_vedic_astrology_kp_cusps

Get 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.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'kp-newcomb', 'example': 'kp-newcomb', 'description': '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".'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['ayanamsa', 'houseSystem', 'cusps', 'houseThemes', 'focus'], 'properties': {'cusps': {'type': 'array', 'items': {'type': 'object', 'required': ['house', 'longitude', 'sign', 'signLord', 'nakshatra', 'nakshatraLord', 'pada', 'starLord', 'subLord', 'subSubLord', 'kpNumber'], 'properties': {'pada': {'type': 'number'}, 'sign': {'type': 'string'}, 'house': {'type': 'number'}, 'subLord': {'type': 'string'}, 'kpNumber': {'type': 'number'}, 'signLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'string'}, 'subSubLord': {'type': 'string'}, 'nakshatraLord': {'type': 'string'}}}}, 'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'ayanamsa': {'type': 'number'}, 'houseSystem': {'type': 'string'}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}}}

post_vedic_astrology_kp_daily_finance

Daily 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.

Read only

Input schema

{'type': 'object', 'examples': [{'latitude': 28.6139, 'birthDate': '1990-06-15', 'birthTime': '07:30:00', 'longitude': 77.209}], 'required': ['birthDate', 'birthTime', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '2026-09-14', 'description': 'Civil date to read, YYYY-MM-DD in the request timezone. Defaults to today (UTC). The Moon windows cover this date from midnight to midnight.'}, 'time': {'type': 'string', 'format': 'time', 'example': '12:00:00', 'description': 'Reading moment on that date, HH:MM:SS local. The ruling planets and the running sookshma lord are read at this instant. Defaults to 12:00:00; pass a market open or any hour for an intraday read.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'weights': {'type': 'object', 'default': {'cusps': 30, 'dasha': 40, 'moonWindows': 15, 'rulingPlanets': 15}, 'example': {'cusps': 30, 'dasha': 40, 'moonWindows': 15, 'rulingPlanets': 15}, 'required': ['cusps', 'dasha', 'rulingPlanets', 'moonWindows'], 'properties': {'cusps': {'type': 'number', 'example': 30, 'maximum': 100, 'minimum': 0, 'description': 'Percent of the final score the cusps layer carries.'}, 'dasha': {'type': 'number', 'example': 40, 'maximum': 100, 'minimum': 0, 'description': 'Percent of the final score the dasha layer carries.'}, 'moonWindows': {'type': 'number', 'example': 15, 'maximum': 100, 'minimum': 0, 'description': 'Percent of the final score the moonWindows layer carries.'}, 'rulingPlanets': {'type': 'number', 'example': 15, 'maximum': 100, 'minimum': 0, 'description': 'Percent of the final score the rulingPlanets layer carries.'}}, 'description': 'Layer weights in percent, all four required, summing to 100. Defaults to the convention, cusps 30, dasha 40, rulingPlanets 15, moonWindows 15. Seventy percent of the default sits on the cusps and the outer dasha levels, which hold for months, so a chart reads inside a narrow band all month and the bands separate charts more than days. Move weight onto rulingPlanets and moonWindows for a reading that turns with the day.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman'], 'type': 'string', 'default': 'kp-newcomb', 'example': 'kp-newcomb', 'description': 'Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to "kp-newcomb".'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth latitude in decimal degrees. Sets the Placidus cusps; also the place the ruling planets and the Moon windows are read at.'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': '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".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': 'Timezone as an IANA name (Asia/Kolkata) or decimal hours from UTC. Applies to the birth time, to the reading date and time, and to every local timestamp in the response. IANA names resolve to the offset in force on the date being read.'}, 'birthDate': {'type': 'string', 'format': 'date', 'example': '1990-06-15', 'description': 'Birth date, YYYY-MM-DD. Fixes the Placidus cusps, the four tier significators and the Vimshottari balance every layer reads.'}, 'birthTime': {'type': 'string', 'format': 'time', 'example': '07:30:00', 'description': 'Birth time, HH:MM:SS, 24 hour, local to the birth place. The cusp sub lords move about one sub every four minutes of clock time, so this is the input the whole reading is most sensitive to.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth longitude in decimal degrees, east positive.'}, 'gainHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'default': [2, 11], 'example': [2, 11], 'maxItems': 12, 'minItems': 1, 'description': 'Houses whose significators count as gain, 1 to 12. Defaults to the convention, 2 and 11. Override it to run your own school: the two lists may not share a house.'}, 'lossHouses': {'type': 'array', 'items': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'default': [6, 8, 12], 'example': [6, 8, 12], 'maxItems': 12, 'minItems': 1, 'description': 'Houses whose significators count as loss, 1 to 12. Defaults to the convention, 6 and 8 and 12. Override it to run your own school: the two lists may not share a house.'}}}

Output schema

{'type': 'object', 'required': ['date', 'readingAt', 'ayanamsaDegrees', 'houses', 'significators', 'layers', 'score', 'band', 'bestWindow', 'worstWindows'], 'properties': {'band': {'enum': ['strong', 'favourable', 'mixed', 'caution', 'unfavourable'], 'type': 'string'}, 'date': {'type': 'string'}, 'score': {'type': 'number'}, 'houses': {'type': 'object', 'required': ['gain', 'loss'], 'properties': {'gain': {'type': 'array', 'items': {'type': 'number'}}, 'loss': {'type': 'array', 'items': {'type': 'number'}}}}, 'layers': {'type': 'object', 'required': ['cusps', 'dasha', 'rulingPlanets', 'moonWindows'], 'properties': {'cusps': {'type': 'object', 'required': ['layer', 'weight', 'score', 'rows'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['inGain', 'inLoss', 'verdict', 'house', 'longitude', 'signLord', 'starLord', 'subLord', 'inverted', 'score'], 'properties': {'house': {'type': 'number'}, 'score': {'type': 'number'}, 'inGain': {'type': 'boolean'}, 'inLoss': {'type': 'boolean'}, 'subLord': {'type': 'string'}, 'verdict': {'enum': ['favourable', 'mixed', 'unfavourable', 'neutral'], 'type': 'string'}, 'inverted': {'type': 'boolean'}, 'signLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'longitude': {'type': 'number'}}}}, 'layer': {'enum': ['cusps'], 'type': 'string'}, 'score': {'type': 'number'}, 'weight': {'type': 'number'}}}, 'dasha': {'type': 'object', 'required': ['layer', 'weight', 'score', 'rows'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['inGain', 'inLoss', 'verdict', 'level', 'lord', 'startDate', 'endDate', 'retrograde', 'score', 'weight'], 'properties': {'lord': {'type': 'string'}, 'level': {'enum': ['mahadasha', 'antardasha', 'pratyantardasha', 'sookshmaDasha'], 'type': 'string'}, 'score': {'type': 'number'}, 'inGain': {'type': 'boolean'}, 'inLoss': {'type': 'boolean'}, 'weight': {'type': 'number'}, 'endDate': {'type': 'string'}, 'verdict': {'enum': ['favourable', 'mixed', 'unfavourable', 'neutral'], 'type': 'string'}, 'startDate': {'type': 'string'}, 'retrograde': {'type': 'boolean'}}}}, 'layer': {'enum': ['dasha'], 'type': 'string'}, 'score': {'type': 'number'}, 'weight': {'type': 'number'}}}, 'moonWindows': {'type': 'object', 'required': ['layer', 'weight', 'score', 'rows'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['inGain', 'inLoss', 'verdict', 'from', 'to', 'subLord', 'score'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'score': {'type': 'number'}, 'inGain': {'type': 'boolean'}, 'inLoss': {'type': 'boolean'}, 'subLord': {'type': 'string'}, 'verdict': {'enum': ['favourable', 'mixed', 'unfavourable', 'neutral'], 'type': 'string'}}}}, 'layer': {'enum': ['moonWindows'], 'type': 'string'}, 'score': {'type': 'number'}, 'weight': {'type': 'number'}}}, 'rulingPlanets': {'type': 'object', 'required': ['layer', 'weight', 'score', 'rows'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['inGain', 'inLoss', 'verdict', 'planet', 'retrograde', 'score'], 'properties': {'score': {'type': 'number'}, 'inGain': {'type': 'boolean'}, 'inLoss': {'type': 'boolean'}, 'planet': {'type': 'string'}, 'verdict': {'enum': ['favourable', 'mixed', 'unfavourable', 'neutral'], 'type': 'string'}, 'retrograde': {'type': 'boolean'}}}}, 'layer': {'enum': ['rulingPlanets'], 'type': 'string'}, 'score': {'type': 'number'}, 'weight': {'type': 'number'}}}}}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman'], 'type': 'string', 'default': 'kp-newcomb'}, 'readingAt': {'type': 'string'}, 'bestWindow': {'type': ['object', 'null'], 'required': ['inGain', 'inLoss', 'verdict', 'from', 'to', 'subLord', 'score'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'score': {'type': 'number'}, 'inGain': {'type': 'boolean'}, 'inLoss': {'type': 'boolean'}, 'subLord': {'type': 'string'}, 'verdict': {'enum': ['favourable', 'mixed', 'unfavourable', 'neutral'], 'type': 'string'}}}, 'worstWindows': {'type': 'array', 'items': {'type': 'object', 'required': ['inGain', 'inLoss', 'verdict', 'from', 'to', 'subLord', 'score'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'score': {'type': 'number'}, 'inGain': {'type': 'boolean'}, 'inLoss': {'type': 'boolean'}, 'subLord': {'type': 'string'}, 'verdict': {'enum': ['favourable', 'mixed', 'unfavourable', 'neutral'], 'type': 'string'}}}}, 'significators': {'type': 'object', 'required': ['gain', 'loss', 'byHouse'], 'properties': {'gain': {'type': 'array', 'items': {'type': 'string'}}, 'loss': {'type': 'array', 'items': {'type': 'string'}}, 'byHouse': {'type': 'array', 'items': {'type': 'object', 'required': ['house', 'group', 'significators'], 'properties': {'group': {'enum': ['gain', 'loss'], 'type': 'string'}, 'house': {'type': 'number'}, 'significators': {'type': 'array', 'items': {'type': 'string'}}}}}}}, 'ayanamsaDegrees': {'type': 'number'}}}

post_vedic_astrology_kp_horary

Cast 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.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '2026-03-08', 'time': '14:30:00', 'latitude': 19.076, 'longitude': 72.8777, 'horaryNumber': 108}], 'required': ['horaryNumber', 'date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '2026-03-08', 'description': 'Date the question was taken up for judgment, YYYY-MM-DD. Not a birth date: a horary chart needs no birth details at all, which is the point of the method.'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '14:30:00', 'description': 'Time the question was taken up for judgment, 24-hour HH:MM:SS. In KP practice this is the moment the astrologer receives and understands the question, not the moment the querent first thought of it. It sets every planetary position and all twelve cusps except the Ascendant.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'kp-newcomb', 'example': 'kp-newcomb', 'description': '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".'}, 'latitude': {'type': 'number', 'example': 19.076, 'maximum': 90, 'minimum': -90, 'description': 'Latitude where the question is judged, decimal degrees. The house cusps are Placidus and therefore latitude dependent, so this is the place of judgment, not the querent birthplace.'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': '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".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': 'Timezone: IANA name (e.g. "Asia/Kolkata") OR decimal hours from UTC. Defaults to 5.5.'}, 'longitude': {'type': 'number', 'example': 72.8777, 'maximum': 180, 'minimum': -180, 'description': 'Longitude where the question is judged, decimal degrees.'}, 'horaryNumber': {'type': 'integer', 'example': 108, 'maximum': 249, 'minimum': 1, 'description': 'Horary number from 1 to 249, given by the querent while focused on their question. It maps to one of the 249 KP sub divisions of the zodiac, and that division sets the Ascendant of the chart. The querent should give the first number that comes to mind and use it once for that question; the astrologer never chooses it. Numbers outside 1 to 249 are rejected rather than wrapped, because a wrapped number would silently answer a different question.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['horaryNumber', 'questionTime', 'ayanamsaType', 'ayanamsaDegrees', 'ascendant', 'cusps', 'planets', 'rulingPlanets', 'significators', 'houseThemes', 'focus'], 'properties': {'cusps': {'type': 'array', 'items': {'type': 'object', 'required': ['house', 'longitude', 'sign', 'star', 'starLord', 'subLord', 'kpNumber'], 'properties': {'sign': {'type': 'string'}, 'star': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'subLord': {'type': 'string'}, 'kpNumber': {'type': 'integer'}, 'starLord': {'type': 'string'}, 'longitude': {'type': 'number'}}}}, 'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'planets': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'longitude', 'house', 'isRetrograde', 'subSubLord', 'sign', 'star', 'starLord', 'subLord', 'kpNumber'], 'properties': {'sign': {'type': 'string'}, 'star': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'planet': {'type': 'string'}, 'subLord': {'type': 'string'}, 'kpNumber': {'type': 'integer'}, 'starLord': {'type': 'string'}, 'longitude': {'type': 'number'}, 'subSubLord': {'type': 'string'}, 'isRetrograde': {'type': 'boolean'}}}}, 'ascendant': {'type': 'object', 'required': ['longitude', 'degreeInSign', 'sign', 'star', 'starLord', 'subLord', 'kpNumber', 'spanFrom', 'spanTo'], 'properties': {'sign': {'type': 'string'}, 'star': {'type': 'string'}, 'spanTo': {'type': 'number'}, 'subLord': {'type': 'string'}, 'kpNumber': {'type': 'integer'}, 'spanFrom': {'type': 'number'}, 'starLord': {'type': 'string'}, 'longitude': {'type': 'number'}, 'degreeInSign': {'type': 'number'}}}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'ayanamsaType': {'type': 'string'}, 'horaryNumber': {'type': 'integer'}, 'questionTime': {'type': 'string'}, 'rulingPlanets': {'type': 'object', 'required': ['dayLord', 'moonSignLord', 'moonStarLord', 'moonSublord', 'moonSubSublord', 'lagnaSignLord', 'lagnaStarLord', 'lagnaSublord', 'lagnaSubSublord', 'rulingPlanets'], 'properties': {'dayLord': {'type': 'string'}, 'moonSublord': {'type': 'string'}, 'lagnaSublord': {'type': 'string'}, 'moonSignLord': {'type': 'string'}, 'moonStarLord': {'type': 'string'}, 'lagnaSignLord': {'type': 'string'}, 'lagnaStarLord': {'type': 'string'}, 'rulingPlanets': {'type': 'array', 'items': {'type': 'string'}}, 'moonSubSublord': {'type': 'string'}, 'lagnaSubSublord': {'type': 'string'}}}, 'significators': {'type': 'object', 'required': ['houseWise', 'planetWise'], 'properties': {'houseWise': {'type': 'array', 'items': {'type': 'object', 'required': ['house', 'significators', 'all'], 'properties': {'all': {'type': 'array', 'items': {'type': 'string'}}, 'house': {'type': 'number'}, 'significators': {'type': 'array', 'items': {'type': 'object', 'required': ['level', 'description', 'planets'], 'properties': {'level': {'type': 'number'}, 'planets': {'type': 'array', 'items': {'type': 'string'}}, 'description': {'type': 'string'}}}}}}}, 'planetWise': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'signifies', 'allHouses'], 'properties': {'planet': {'type': 'string'}, 'allHouses': {'type': 'array', 'items': {'type': 'number'}}, 'signifies': {'type': 'array', 'items': {'type': 'object', 'required': ['level', 'houses'], 'properties': {'level': {'type': 'number'}, 'houses': {'type': 'array', 'items': {'type': 'number'}}}}}}}}}}, 'ayanamsaDegrees': {'type': 'number'}}}

post_vedic_astrology_kp_planets

Get 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.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'kp-newcomb', 'example': 'kp-newcomb', 'description': '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".'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': '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".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['ayanamsa', 'planets'], 'properties': {'planets': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'longitude', 'sign', 'signLord', 'nakshatra', 'nakshatraNumber', 'nakshatraLord', 'pada', 'starLord', 'subLord', 'subSubLord', 'kpNumber', 'retrograde'], 'properties': {'pada': {'type': 'number'}, 'sign': {'type': 'string'}, 'planet': {'type': 'string'}, 'subLord': {'type': 'string'}, 'kpNumber': {'type': 'number'}, 'signLord': {'type': 'string'}, 'starLord': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'string'}, 'retrograde': {'type': 'boolean'}, 'subSubLord': {'type': 'string'}, 'nakshatraLord': {'type': 'string'}, 'nakshatraNumber': {'type': 'number'}}}}, 'ayanamsa': {'type': 'number'}}}

post_vedic_astrology_kp_planets_interval

Get 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.

Read only

Input schema

{'type': 'object', 'examples': [{'latitude': 28.6139, 'longitude': 77.209, 'endDatetime': '2025-01-15T23:59:00Z', 'startDatetime': '2025-01-15T00:00:00Z', 'intervalMinutes': 60}], 'required': ['startDatetime', 'endDatetime', 'intervalMinutes', 'latitude', 'longitude'], 'properties': {'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman'], 'type': 'string', 'default': 'kp-newcomb', 'example': 'kp-newcomb', 'description': 'Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to "kp-newcomb".'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Observer latitude in decimal degrees (for future Lagna calculations)'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': '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".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 0, 'example': 5.5, 'description': 'IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC. IANA resolved to the DST-correct offset for the startDatetime date. When non-zero, all datetimes are treated as local time in this timezone (Z suffix is ignored). Defaults to 0 (UTC).'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Observer longitude in decimal degrees (for future Lagna calculations)'}, 'endDatetime': {'type': 'string', 'format': 'date-time', 'example': '2025-01-15T23:59:00Z', 'description': 'End datetime in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Maximum 7 days from start. Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.'}, 'startDatetime': {'type': 'string', 'format': 'date-time', 'example': '2025-01-15T00:00:00Z', 'description': 'Start datetime in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.'}, 'intervalMinutes': {'type': 'number', 'example': 60, 'maximum': 1440, 'minimum': 15, 'description': 'Time between calculations in minutes. Range: 15 (quarter-hourly) to 1440 (daily).'}}}

Output schema

{'type': 'object', 'required': ['startDatetime', 'endDatetime', 'intervalMinutes', 'totalIntervals', 'ayanamsa', 'ayanamsaValue', 'intervals'], 'properties': {'ayanamsa': {'type': 'string'}, 'intervals': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'time', 'datetime', 'planets'], 'properties': {'date': {'type': 'string'}, 'time': {'type': 'string'}, 'planets': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['longitude', 'degreeInSign', 'sign', 'signLord', 'nakshatra', 'nakshatraLord', 'sublord', 'subSublord', 'kpNumber', 'isRetrograde'], 'properties': {'sign': {'type': 'string'}, 'sublord': {'type': 'string'}, 'kpNumber': {'type': 'number'}, 'signLord': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'string'}, 'subSublord': {'type': 'string'}, 'degreeInSign': {'type': 'number'}, 'isRetrograde': {'type': 'boolean'}, 'nakshatraLord': {'type': 'string'}}}}, 'datetime': {'type': 'string'}}}}, 'endDatetime': {'type': 'string'}, 'ayanamsaValue': {'type': 'number'}, 'startDatetime': {'type': 'string'}, 'totalIntervals': {'type': 'number'}, 'intervalMinutes': {'type': 'number'}}}

post_vedic_astrology_kp_rasi_changes

Find 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.

Read only

Input schema

{'type': 'object', 'examples': [{'planet': 'Sun', 'endDate': '2025-12-31', 'startDate': '2025-01-01'}], 'required': ['planet', 'startDate', 'endDate'], 'properties': {'planet': {'enum': ['Sun', 'Moon', 'Mars', 'Mercury', 'Jupiter', 'Venus', 'Saturn'], 'type': 'string', 'example': 'Sun', 'description': 'Planet to track (case-insensitive). Valid values: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'endDate': {'type': 'string', 'format': 'date', 'example': '2025-12-31', 'description': 'Last day of the search, inclusive (YYYY-MM-DD), a calendar day in `timezone`. Not before startDate, at most 365 days after it.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman'], 'type': 'string', 'default': 'kp-newcomb', 'example': 'kp-newcomb', 'description': 'Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to "kp-newcomb".'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': '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".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 0, 'example': 5.5, 'description': 'IANA name (e.g. "America/New_York", "Europe/London"), a fixed offset like "+05:30", OR decimal hours from UTC. One offset is taken from startDate (DST-correct for that date) and used for the whole range, so a window crossing a daylight-saving change is read on the earlier offset throughout; send a fixed offset if you need that explicit. The two dates are read as calendar days in this timezone and output times are converted to it, so one date with 5.5 is that whole Indian day. Defaults to 0 (UTC).'}, 'startDate': {'type': 'string', 'format': 'date', 'example': '2025-01-01', 'description': 'First day of the search (YYYY-MM-DD), a calendar day in `timezone`.'}}}

Output schema

{'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'totalChanges', 'changes'], 'properties': {'planet': {'type': 'string'}, 'changes': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'time', 'datetime', 'fromSign', 'fromSignLord', 'toSign', 'toSignLord'], 'properties': {'date': {'type': 'string'}, 'time': {'type': 'string'}, 'toSign': {'type': 'string'}, 'datetime': {'type': 'string'}, 'fromSign': {'type': 'string'}, 'toSignLord': {'type': 'string'}, 'fromSignLord': {'type': 'string'}}}}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'totalChanges': {'type': 'number'}}}

post_vedic_astrology_kp_ruling_planets

Get 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.

Read only

Input schema

{'type': 'object', 'examples': [{'latitude': 28.6139, 'longitude': 77.209}], 'required': ['latitude', 'longitude'], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'datetime': {'type': 'string', 'format': 'date-time', 'example': '2025-01-15T10:30:00Z', 'description': 'ISO 8601 datetime (YYYY-MM-DDTHH:MM:SS) for ruling planets. Defaults to current time. Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Observer latitude in decimal degrees'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': '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".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': 'Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC. IANA resolved to the DST-correct offset based on birthDate or datetime. Defaults to 5.5.'}, 'birthDate': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date (YYYY-MM-DD) to calculate significators. If provided with birthTime, response includes which houses each ruling planet signifies.'}, 'birthTime': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time (HH:MM:SS) for significator calculation. Required if birthDate is provided.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Observer longitude in decimal degrees'}}}

Output schema

{'type': 'object', 'required': ['datetime', 'location', 'dayLord', 'moonSignLord', 'moonStarLord', 'moonSublord', 'moonSubSublord', 'lagnaSignLord', 'lagnaStarLord', 'lagnaSublord', 'lagnaSubSublord', 'rulingPlanets'], 'properties': {'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'dayLord': {'type': 'string'}, 'datetime': {'type': 'string'}, 'location': {'type': 'object', 'required': ['latitude', 'longitude', 'timezone'], 'properties': {'latitude': {'type': 'number'}, 'timezone': {'type': 'number'}, 'longitude': {'type': 'number'}}}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'moonSublord': {'type': 'string'}, 'lagnaSublord': {'type': 'string'}, 'moonSignLord': {'type': 'string'}, 'moonStarLord': {'type': 'string'}, 'lagnaSignLord': {'type': 'string'}, 'lagnaStarLord': {'type': 'string'}, 'rulingPlanets': {'type': 'array', 'items': {'type': 'string'}}, 'significators': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'signifies'], 'properties': {'planet': {'type': 'string'}, 'signifies': {'type': 'array', 'items': {'type': 'number'}}}}}, 'moonSubSublord': {'type': 'string'}, 'lagnaSubSublord': {'type': 'string'}}}

post_vedic_astrology_kp_ruling_planets_interval

Get 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.

Read only

Input schema

{'type': 'object', 'examples': [{'latitude': 17.385044, 'longitude': 78.486671, 'endDatetime': '2026-02-03T01:00:00Z', 'startDatetime': '2026-02-03T00:00:00Z', 'intervalMinutes': 5}], 'required': ['startDatetime', 'endDatetime', 'intervalMinutes', 'latitude', 'longitude'], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'focus': {'enum': ['general', 'finance'], 'type': 'string', 'default': 'general', 'example': 'general', 'description': '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".'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman'], 'type': 'string', 'default': 'kp-newcomb', 'example': 'kp-newcomb', 'description': 'Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to "kp-newcomb".'}, 'latitude': {'type': 'number', 'example': 17.385044, 'maximum': 90, 'minimum': -90, 'description': 'Observer latitude in decimal degrees'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': '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".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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 once, at the start of the window, and that offset applies to every time in the response. When non-zero, all datetimes are treated as local time in this timezone (Z suffix is ignored). Output times are also converted to this timezone. Defaults to 5.5 (IST).'}, 'longitude': {'type': 'number', 'example': 78.486671, 'maximum': 180, 'minimum': -180, 'description': 'Observer longitude in decimal degrees'}, 'endDatetime': {'type': 'string', 'format': 'date-time', 'example': '2026-02-03T01:00:00Z', 'description': 'End of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.'}, 'startDatetime': {'type': 'string', 'format': 'date-time', 'example': '2026-02-03T00:00:00Z', 'description': 'Start of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.'}, 'intervalMinutes': {'type': 'integer', 'example': 5, 'maximum': 1440, 'minimum': 1, 'description': 'Interval between calculations in minutes (1-1440). Use 1-5 for birth time rectification.'}}}

Output schema

{'type': 'object', 'required': ['startDatetime', 'endDatetime', 'intervalMinutes', 'location', 'totalIntervals', 'intervals', 'houseThemes', 'focus'], 'properties': {'focus': {'enum': ['general', 'finance'], 'type': 'string'}, 'location': {'type': 'object', 'required': ['latitude', 'longitude', 'timezone'], 'properties': {'latitude': {'type': 'number'}, 'timezone': {'type': 'number'}, 'longitude': {'type': 'number'}}}, 'intervals': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'time', 'datetime', 'dayLord', 'moonSignLord', 'moonStarLord', 'moonSublord', 'moonSubSublord', 'lagnaSignLord', 'lagnaStarLord', 'lagnaSublord', 'lagnaSubSublord', 'rulingPlanets', 'significators', 'moonSignLordSignifies', 'moonStarLordSignifies', 'moonSublordSignifies', 'moonSignifies'], 'properties': {'date': {'type': 'string'}, 'time': {'type': 'string'}, 'dayLord': {'type': 'string'}, 'datetime': {'type': 'string'}, 'moonSublord': {'type': 'string'}, 'lagnaSublord': {'type': 'string'}, 'moonSignLord': {'type': 'string'}, 'moonStarLord': {'type': 'string'}, 'lagnaSignLord': {'type': 'string'}, 'lagnaStarLord': {'type': 'string'}, 'moonSignifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'rulingPlanets': {'type': 'array', 'items': {'type': 'string'}}, 'significators': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'signifies'], 'properties': {'planet': {'type': 'string'}, 'signifies': {'type': 'array', 'items': {'type': 'number'}}}}}, 'moonSubSublord': {'type': 'string'}, 'lagnaSubSublord': {'type': 'string'}, 'moonSublordSignifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'moonSignLordSignifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}, 'moonStarLordSignifies': {'type': 'object', 'required': ['L1', 'L2', 'L3', 'L4'], 'properties': {'L1': {'type': 'array', 'items': {'type': 'integer'}}, 'L2': {'type': 'array', 'items': {'type': 'integer'}}, 'L3': {'type': 'array', 'items': {'type': 'integer'}}, 'L4': {'type': 'array', 'items': {'type': 'integer'}}}}}}}, 'endDatetime': {'type': 'string'}, 'houseThemes': {'type': 'object', 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'startDatetime': {'type': 'string'}, 'totalIntervals': {'type': 'number'}, 'intervalMinutes': {'type': 'number'}}}

post_vedic_astrology_kp_sublord_changes

Find 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.

Read only

Input schema

{'type': 'object', 'examples': [{'planet': 'Moon', 'endDate': '2025-01-31', 'startDate': '2025-01-01'}], 'required': ['planet', 'startDate', 'endDate'], 'properties': {'planet': {'enum': ['Sun', 'Moon', 'Mars', 'Mercury', 'Jupiter', 'Venus', 'Saturn'], 'type': 'string', 'example': 'Moon', 'description': 'Planet to track (case-insensitive). Valid values: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'endDate': {'type': 'string', 'format': 'date', 'example': '2025-01-31', 'description': 'Last day of the search, inclusive (YYYY-MM-DD), a calendar day in `timezone`. Not before startDate, at most 365 days after it.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman'], 'type': 'string', 'default': 'kp-newcomb', 'example': 'kp-newcomb', 'description': 'Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to "kp-newcomb".'}, 'nodeType': {'enum': ['mean', 'true'], 'type': 'string', 'default': 'mean', 'example': 'mean', 'description': '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".'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 0, 'example': 5.5, 'description': 'IANA name (e.g. "America/New_York", "Europe/London"), a fixed offset like "+05:30", OR decimal hours from UTC. One offset is taken from startDate (DST-correct for that date) and used for the whole range, so a window crossing a daylight-saving change is read on the earlier offset throughout; send a fixed offset if you need that explicit. The two dates are read as calendar days in this timezone and output times are converted to it, so one date with 5.5 is that whole Indian day. Defaults to 0 (UTC).'}, 'startDate': {'type': 'string', 'format': 'date', 'example': '2025-01-01', 'description': 'First day of the search (YYYY-MM-DD), a calendar day in `timezone`.'}}}

Output schema

{'type': 'object', 'required': ['planet', 'startDate', 'endDate', 'totalChanges', 'changes'], 'properties': {'planet': {'type': 'string'}, 'changes': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'time', 'datetime', 'fromKp', 'toKp', 'fromSublord', 'toSublord', 'fromNakshatraLord', 'toNakshatraLord'], 'properties': {'date': {'type': 'string'}, 'time': {'type': 'string'}, 'toKp': {'type': 'number'}, 'fromKp': {'type': 'number'}, 'datetime': {'type': 'string'}, 'toSublord': {'type': 'string'}, 'fromSublord': {'type': 'string'}, 'toNakshatraLord': {'type': 'string'}, 'fromNakshatraLord': {'type': 'string'}}}}, 'endDate': {'type': 'string'}, 'startDate': {'type': 'string'}, 'totalChanges': {'type': 'number'}}}

post_vedic_astrology_navamsa

Get Navamsa chart (D9) - Marriage Compatibility Calculator

Calculate Navamsa (D9 divisional chart) for marriage compatibility analysis, spouse prediction, and spiritual life assessment. Navamsa calculator API reveals planetary strength in married life. Each planetary position is divided into 9 parts for accurate marriage astrology. Detects Vargottama planets (exalted status). Essential for matrimonial matching, relationship prediction, and marital harmony analysis in Vedic astrology.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['chart', 'frame', 'vargottama', 'vargottamaExplanation'], 'properties': {'chart': {'type': 'object', 'required': ['meta', 'aries'], 'properties': {'meta': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['graha', 'rashi', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'rashi': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}, 'aries': {'type': 'object', 'required': ['rashi', 'signs'], 'properties': {'rashi': {'type': 'string'}, 'signs': {'type': 'array', 'items': {'type': 'object', 'required': ['graha', 'longitude', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key', 'lord'], 'properties': {'key': {'type': 'number'}, 'lord': {'enum': ['Ketu', 'Venus', 'Sun', 'Moon', 'Mars', 'Rahu', 'Jupiter', 'Saturn', 'Mercury'], 'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}}}, 'isRetrograde': {'type': 'boolean'}}}}}}}, 'additionalProperties': {}}, 'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'vargottama': {'type': 'array', 'items': {'type': 'string'}}, 'vargottamaExplanation': {'type': 'string'}}}

post_vedic_astrology_panchang_basic

Get basic Panchang - Tithi Nakshatra Yoga Karana Calculator

Calculate Panchang elements (Hindu calendar) for any date: Tithi (lunar day), Nakshatra (lunar mansion), Yoga, and Karana. Daily panchang API for determining auspicious timings (muhurta), festival dates, and planetary influences. Tithi calculator with Shukla/Krishna paksha. Accurate nakshatra today with ruling planet. Essential for Hindu calendar integration, muhurta selection, and Vedic timekeeping in astrology apps.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '2025-12-17', 'time': '12:00:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '2025-12-17', 'description': 'Date in YYYY-MM-DD format. Panchang elements (Tithi, Nakshatra, Yoga, Karana) are calculated for this date.'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '12:00:00', 'description': 'Time in HH:MM:SS format (24-hour). Determines the exact Moon and Sun positions for tithi and nakshatra calculation.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Observer latitude in decimal degrees. Determines sunrise/sunset times which define the Vara (weekday) and muhurta boundaries.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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).'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Observer longitude in decimal degrees. Affects local time calculations for sunrise/sunset-dependent panchang elements.'}}}

Output schema

{'type': 'object', 'required': ['tithi', 'nakshatra', 'yoga', 'karana', 'sunLongitude', 'moonLongitude'], 'properties': {'yoga': {'type': 'object', 'required': ['number', 'name'], 'properties': {'name': {'type': 'string'}, 'number': {'type': 'integer', 'maximum': 27, 'minimum': 1}, 'characteristics': {'type': 'string'}}}, 'tithi': {'type': 'object', 'required': ['number', 'name', 'paksha', 'percent'], 'properties': {'name': {'type': 'string'}, 'deity': {'type': 'string'}, 'number': {'type': 'integer', 'maximum': 30, 'minimum': 1}, 'paksha': {'enum': ['Shukla', 'Krishna'], 'type': 'string'}, 'element': {'type': 'string'}, 'percent': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'rulingPlanet': {'type': 'string'}}}, 'karana': {'type': 'object', 'required': ['number', 'name'], 'properties': {'name': {'type': 'string'}, 'type': {'type': 'string'}, 'number': {'type': 'integer'}, 'characteristics': {'type': 'string'}}}, 'nakshatra': {'type': 'object', 'required': ['number', 'name', 'lord', 'pada'], 'properties': {'lord': {'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'integer', 'maximum': 4, 'minimum': 1}, 'deity': {'type': 'string'}, 'number': {'type': 'integer', 'maximum': 27, 'minimum': 1}, 'symbol': {'type': 'string'}, 'characteristics': {'type': 'string'}}}, 'sunLongitude': {'type': 'number'}, 'moonLongitude': {'type': 'number'}}}

post_vedic_astrology_panchang_choghadiya

Get Choghadiya - 8 Muhurta divisions of day and night

Calculate Choghadiya (Chaughadia) muhurta timings for any date and location. Divides day (sunrise to sunset) and night (sunset to next sunrise) into 8 equal auspicious/inauspicious periods. Each period ruled by a planet: Udveg (Sun, bad), Amrit (Moon, good), Rog (Mars, bad), Labh (Mercury, good), Shubh (Jupiter, good), Char (Venus, good), Kaal (Saturn, bad). Essential for muhurta selection, daily planning, and traditional Hindu timekeeping. Choghadiya calculator API, daily muhurat timings, auspicious time finder.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '2026-02-03', 'latitude': 17.385044, 'longitude': 78.486671}], 'required': ['date', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '2026-02-03', 'description': 'Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected. Calculations that read planetary positions support 1550-01-02 to 2650-01-22; outside that span they answer 400 with code date_out_of_range, and a calculation that reads a window around the date (a sunrise search, a run of days) may answer the same 400 for a date within a few days of either end.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'latitude': {'type': 'number', 'example': 17.385044, 'maximum': 90, 'minimum': -90, 'description': 'Observer latitude in decimal degrees. Determines sunrise and sunset times which define day/night boundaries for muhurta calculations.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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. Used for accurate sunrise/sunset calculation and output time formatting. Essential for correct Choghadiya periods outside IST. Defaults to 5.5 (IST).'}, 'longitude': {'type': 'number', 'example': 78.486671, 'maximum': 180, 'minimum': -180, 'description': 'Observer longitude in decimal degrees. Affects local time calculations for sunrise, sunset, and muhurta period boundaries.'}}}

Output schema

{'type': 'object', 'required': ['date', 'dayChoghadiya', 'nightChoghadiya'], 'properties': {'date': {'type': 'string'}, 'dayChoghadiya': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'lord', 'effect', 'start', 'end'], 'properties': {'end': {'type': 'string'}, 'lord': {'type': 'string'}, 'name': {'enum': ['Udveg', 'Amrit', 'Rog', 'Labh', 'Shubh', 'Char', 'Kaal'], 'type': 'string'}, 'start': {'type': 'string'}, 'effect': {'enum': ['Good', 'Bad'], 'type': 'string'}}}}, 'nightChoghadiya': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'lord', 'effect', 'start', 'end'], 'properties': {'end': {'type': 'string'}, 'lord': {'type': 'string'}, 'name': {'enum': ['Udveg', 'Amrit', 'Rog', 'Labh', 'Shubh', 'Char', 'Kaal'], 'type': 'string'}, 'start': {'type': 'string'}, 'effect': {'enum': ['Good', 'Bad'], 'type': 'string'}}}}}}

post_vedic_astrology_panchang_detailed

Get detailed Panchang with Rahu Kaal, Yamaganda, Gulika

Complete daily panchang with all five limbs (Tithi, Nakshatra, Yoga, Karana, Vara) plus sunrise, sunset, moonrise, moonset times. Includes inauspicious periods (Rahu Kaal, Yamaganda, Gulika Kaal) and auspicious windows (Abhijit Muhurta, Brahma Muhurta). Current planetary hora with start/end times. Essential for muhurta selection, daily horoscope apps, Hindu calendar integration, and electional astrology. Accurate calculations based on observer location.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '2026-02-03', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '2026-02-03', 'description': 'Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected. Calculations that read planetary positions support 1550-01-02 to 2650-01-22; outside that span they answer 400 with code date_out_of_range, and a calculation that reads a window around the date (a sunrise search, a run of days) may answer the same 400 for a date within a few days of either end.'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Observer latitude in decimal degrees. Determines sunrise and sunset times which define day/night boundaries for muhurta calculations.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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. Send the timezone that matches the coordinates: sunrise, sunset and every muhurta boundary are found by searching forward from local midnight, so the default anchors the search to an Indian day. Omitting it for a location outside IST returns a correctly ordered set of periods for the wrong window, shifted by the difference between 5.5 and the real offset. Defaults to 5.5 (IST).'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Observer longitude in decimal degrees. Affects local time calculations for sunrise, sunset, and muhurta period boundaries.'}}}

Output schema

{'type': 'object', 'required': ['date', 'location', 'vara', 'sunrise', 'sunset', 'moonrise', 'moonset', 'moonSign', 'sunSign', 'sunNakshatra', 'tithi', 'nakshatra', 'yoga', 'karana', 'hora', 'rahuKaal', 'yamaganda', 'gulika', 'abhijitMuhurta', 'brahmaMuhurta', 'vijayaMuhurta', 'nishitaMuhurta', 'godhuliMuhurta', 'pratahSandhya', 'sayahnaSandhya', 'durMuhurta', 'varjyam', 'amritKalam', 'chandrabalam', 'tarabalam', 'panchaka', 'bhadra', 'transitions'], 'properties': {'date': {'type': 'string'}, 'hora': {'type': 'object', 'required': ['current', 'number', 'start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}, 'number': {'type': 'number'}, 'current': {'type': 'string'}}}, 'vara': {'type': 'object', 'required': ['name', 'sanskritName', 'lord'], 'properties': {'lord': {'type': 'string'}, 'name': {'type': 'string'}, 'sanskritName': {'type': 'string'}}}, 'yoga': {'type': 'object', 'required': ['number', 'name'], 'properties': {'name': {'type': 'string'}, 'number': {'type': 'integer', 'maximum': 27, 'minimum': 1}, 'characteristics': {'type': 'string'}}}, 'tithi': {'type': 'object', 'required': ['number', 'name', 'paksha', 'percent'], 'properties': {'name': {'type': 'string'}, 'deity': {'type': 'string'}, 'number': {'type': 'integer', 'maximum': 30, 'minimum': 1}, 'paksha': {'enum': ['Shukla', 'Krishna'], 'type': 'string'}, 'element': {'type': 'string'}, 'percent': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'rulingPlanet': {'type': 'string'}}}, 'bhadra': {'type': 'object', 'required': ['active', 'startsAt', 'endsAt'], 'properties': {'active': {'type': 'boolean'}, 'endsAt': {'type': ['string', 'null']}, 'startsAt': {'type': ['string', 'null']}}}, 'gulika': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}, 'karana': {'type': 'object', 'required': ['number', 'name'], 'properties': {'name': {'type': 'string'}, 'type': {'type': 'string'}, 'number': {'type': 'integer'}, 'characteristics': {'type': 'string'}}}, 'sunset': {'type': 'string'}, 'moonset': {'type': ['string', 'null']}, 'sunSign': {'type': 'object', 'required': ['name', 'sanskritName'], 'properties': {'name': {'type': 'string'}, 'sanskritName': {'type': 'string'}}}, 'sunrise': {'type': 'string'}, 'varjyam': {'type': 'array', 'items': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}}, 'location': {'type': 'object', 'required': ['latitude', 'longitude', 'timezone'], 'properties': {'latitude': {'type': 'number'}, 'timezone': {'type': 'number'}, 'longitude': {'type': 'number'}}}, 'moonSign': {'type': 'object', 'required': ['name', 'sanskritName'], 'properties': {'name': {'type': 'string'}, 'sanskritName': {'type': 'string'}}}, 'moonrise': {'type': ['string', 'null']}, 'panchaka': {'type': 'object', 'required': ['active', 'type', 'startsAt', 'endsAt'], 'properties': {'type': {'type': ['string', 'null']}, 'active': {'type': 'boolean'}, 'endsAt': {'type': ['string', 'null']}, 'startsAt': {'type': ['string', 'null']}}}, 'rahuKaal': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}, 'nakshatra': {'type': 'object', 'required': ['number', 'name', 'lord', 'pada'], 'properties': {'lord': {'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'integer', 'maximum': 4, 'minimum': 1}, 'deity': {'type': 'string'}, 'number': {'type': 'integer', 'maximum': 27, 'minimum': 1}, 'symbol': {'type': 'string'}, 'characteristics': {'type': 'string'}}}, 'tarabalam': {'type': 'object', 'required': ['favorableNakshatras', 'unfavorableNakshatras'], 'properties': {'favorableNakshatras': {'type': 'array', 'items': {'type': 'string'}}, 'unfavorableNakshatras': {'type': 'array', 'items': {'type': 'string'}}}}, 'yamaganda': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}, 'amritKalam': {'type': 'array', 'items': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}}, 'durMuhurta': {'type': 'array', 'items': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}}, 'transitions': {'type': 'object', 'required': ['tithi', 'yoga', 'karana', 'nakshatra', 'moonSign'], 'properties': {'yoga': {'type': 'object', 'required': ['endsAt', 'next'], 'properties': {'next': {'type': 'string'}, 'endsAt': {'type': 'string'}}}, 'tithi': {'type': 'object', 'required': ['endsAt', 'next'], 'properties': {'next': {'type': 'string'}, 'endsAt': {'type': 'string'}}}, 'karana': {'type': 'object', 'required': ['endsAt', 'next'], 'properties': {'next': {'type': 'string'}, 'endsAt': {'type': 'string'}}}, 'moonSign': {'type': 'object', 'required': ['current', 'changesAt', 'next'], 'properties': {'next': {'type': 'string'}, 'current': {'type': 'string'}, 'changesAt': {'type': 'string'}}}, 'nakshatra': {'type': 'object', 'required': ['endsAt', 'next', 'nextPada'], 'properties': {'next': {'type': 'string'}, 'endsAt': {'type': 'string'}, 'nextPada': {'type': 'number'}}}}}, 'chandrabalam': {'type': 'object', 'required': ['favorableRashis', 'ashtamaChandraRashi'], 'properties': {'favorableRashis': {'type': 'array', 'items': {'type': 'string'}}, 'ashtamaChandraRashi': {'type': 'string'}}}, 'sunNakshatra': {'type': 'object', 'required': ['number', 'name', 'lord', 'pada'], 'properties': {'lord': {'type': 'string'}, 'name': {'type': 'string'}, 'pada': {'type': 'integer', 'maximum': 4, 'minimum': 1}, 'number': {'type': 'integer', 'maximum': 27, 'minimum': 1}}}, 'brahmaMuhurta': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}, 'pratahSandhya': {'type': ['object', 'null'], 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}, 'vijayaMuhurta': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}, 'abhijitMuhurta': {'type': ['object', 'null'], 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}, 'godhuliMuhurta': {'type': ['object', 'null'], 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}, 'nishitaMuhurta': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}, 'sayahnaSandhya': {'type': ['object', 'null'], 'required': ['start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}}}}}

post_vedic_astrology_panchang_hora

Get Hora - 24 Planetary Hours (12 day + 12 night)

Calculate all 24 Hora (planetary hour) periods for any date and location. Day is divided into 12 equal horas from sunrise to sunset, night into 12 equal horas from sunset to next sunrise. Each hora is ruled by a planet in the Chaldean sequence starting from the day lord. Hora timings API, planetary hours calculator, Vedic hora chart, electional astrology timing.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '2026-02-03', 'latitude': 17.385044, 'longitude': 78.486671}], 'required': ['date', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '2026-02-03', 'description': 'Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected. Calculations that read planetary positions support 1550-01-02 to 2650-01-22; outside that span they answer 400 with code date_out_of_range, and a calculation that reads a window around the date (a sunrise search, a run of days) may answer the same 400 for a date within a few days of either end.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'latitude': {'type': 'number', 'example': 17.385044, 'maximum': 90, 'minimum': -90, 'description': 'Observer latitude in decimal degrees. Determines sunrise and sunset times which define day/night boundaries for muhurta calculations.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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. Used for accurate sunrise/sunset calculation and output time formatting. Essential for correct Hora periods outside IST. Defaults to 5.5 (IST).'}, 'longitude': {'type': 'number', 'example': 78.486671, 'maximum': 180, 'minimum': -180, 'description': 'Observer longitude in decimal degrees. Affects local time calculations for sunrise, sunset, and muhurta period boundaries.'}}}

Output schema

{'type': 'object', 'required': ['date', 'dayHoras', 'nightHoras'], 'properties': {'date': {'type': 'string'}, 'dayHoras': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'number', 'start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}, 'number': {'type': 'number'}, 'planet': {'type': 'string'}}}}, 'nightHoras': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'number', 'start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}, 'number': {'type': 'number'}, 'planet': {'type': 'string'}}}}}}

post_vedic_astrology_parallels

Declination Parallels - Planets at same or opposite declination

Calculate planetary declinations and find parallels (same declination) and contraparallels (opposite declination). Parallels are considered equivalent to conjunctions in strength, contraparallels to oppositions. Returns declination for each planet and all parallel/contraparallel aspects. Declination parallels API, planetary declination calculator, contraparallel aspects.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '2026-02-03', 'time': '12:00:00', 'latitude': 17.385044, 'longitude': 78.486671}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'orb': {'type': 'number', 'default': 1.5, 'example': 1.5, 'maximum': 3, 'minimum': 0.5, 'description': 'Orb in degrees for parallel/contraparallel detection. Defaults to 1.5°.'}, 'date': {'type': 'string', 'format': 'date', 'example': '2026-02-03', 'description': 'Date in YYYY-MM-DD format. Planetary declinations are calculated for this date to find parallel and contraparallel aspects.'}, 'time': {'type': 'string', 'format': 'time', 'example': '12:00:00', 'description': 'Time in HH:MM:SS format (24-hour). Exact time affects declination values, especially for the fast-moving Moon.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'latitude': {'type': 'number', 'example': 17.385044, 'maximum': 90, 'minimum': -90, 'description': 'Birth latitude in decimal degrees, part of the birth record. Declinations are geocentric, as every published ephemeris prints them, so it does not move them.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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).'}, 'longitude': {'type': 'number', 'example': 78.486671, 'maximum': 180, 'minimum': -180, 'description': 'Birth longitude in decimal degrees, part of the birth record. Declinations are geocentric, so it does not move them; the instant comes from date, time and timezone.'}}}

Output schema

{'type': 'object', 'required': ['datetime', 'planets', 'parallels'], 'properties': {'planets': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'declination', 'rightAscension'], 'properties': {'name': {'type': 'string'}, 'declination': {'type': 'number'}, 'rightAscension': {'type': 'number'}}}}, 'datetime': {'type': 'string'}, 'parallels': {'type': 'array', 'items': {'type': 'object', 'required': ['planet1', 'planet2', 'type', 'orb', 'dec1', 'dec2'], 'properties': {'orb': {'type': 'number'}, 'dec1': {'type': 'number'}, 'dec2': {'type': 'number'}, 'type': {'enum': ['parallel', 'contraparallel'], 'type': 'string'}, 'planet1': {'type': 'string'}, 'planet2': {'type': 'string'}}}}}}

post_vedic_astrology_parallels_monthly

Monthly Declination Parallels - Parallel and contraparallel events for a month

Find all declination parallel and contraparallel events between the 7 visible planets for a given month. Parallels occur when two planets share the same celestial declination (equivalent to conjunction in strength). Contraparallels occur at opposite declinations (equivalent to opposition). Scanned daily at noon UTC. Omit year and month to get the month in progress, so a published parallel calendar stays current without a redeploy. Essential for advanced transit analysis and hidden aspect discovery. Monthly declination parallels API, planetary parallel ephemeris, contraparallel event calendar.

Read only

Input schema

{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'year': {'type': 'integer', 'example': 2026, 'maximum': 2649, 'minimum': 1551, 'description': 'Year for monthly parallel analysis (1551 to 2649). Defaults to the current year (UTC).'}, 'month': {'type': 'integer', 'example': 2, 'maximum': 12, 'minimum': 1, 'description': 'Month number (1-12) for parallel analysis. Defaults to the current month (UTC).'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 0, 'example': 5.5, 'description': '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 once, at the start of the window, and that offset applies to every time in the response. Output times are converted to this timezone. Defaults to 0 (UTC).'}}}

Output schema

{'type': 'object', 'required': ['year', 'month', 'events'], 'properties': {'year': {'type': 'number'}, 'month': {'type': 'number'}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['planet1', 'planet2', 'type', 'date', 'time', 'datetime', 'orb', 'dec1', 'dec2'], 'properties': {'orb': {'type': 'number'}, 'date': {'type': 'string'}, 'dec1': {'type': 'number'}, 'dec2': {'type': 'number'}, 'time': {'type': 'string'}, 'type': {'enum': ['parallel', 'contraparallel'], 'type': 'string'}, 'planet1': {'type': 'string'}, 'planet2': {'type': 'string'}, 'datetime': {'type': 'string'}, 'planet1Localized': {'type': 'string'}, 'planet2Localized': {'type': 'string'}}}}}}

post_vedic_astrology_planetary_positions

Get planetary positions - Graha Positions API

Get simplified planetary positions (graha positions) for all 9 planets (Sun through Ketu) plus Ascendant (Lagna). Real-time planet transit calculator for Vedic astrology. Navagraha positions API with nakshatra, pada, and rashi details. Includes house number placement using Whole Sign house system from Lagna. Faster response for basic planetary data without full chart structure. Perfect for planetary alignment tracking, daily transit updates, and astrology widgets.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['graha', 'rashi', 'longitude', 'house', 'nakshatra', 'isRetrograde'], 'properties': {'graha': {'type': 'string'}, 'house': {'type': 'number'}, 'rashi': {'type': 'string'}, 'awastha': {'enum': ['Bala', 'Kumara', 'Yuva', 'Vriddha', 'Mrita'], 'type': 'string'}, 'latitude': {'type': 'number'}, 'isCombust': {'type': 'boolean'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'object', 'required': ['name', 'pada', 'key'], 'properties': {'key': {'type': 'number'}, 'name': {'type': 'string'}, 'pada': {'type': 'number'}, 'deity': {'type': 'string'}, 'symbol': {'type': 'string'}, 'characteristics': {'type': 'string'}}}, 'isRetrograde': {'type': 'boolean'}, 'rashiDetails': {'type': 'object', 'properties': {'energy': {'type': 'string'}, 'symbol': {'type': 'string'}, 'vedicName': {'type': 'string'}, 'characteristics': {'type': 'string'}}}, 'combustionDistance': {'type': 'number'}}}}

post_vedic_astrology_planetary_positions_monthly

Monthly Ephemeris - Daily sidereal planetary positions for a month

Get daily sidereal ecliptic positions for all 9 Vedic planets (Navagraha) for an entire month. Returns longitude, zodiac sign, degree within sign, and retrograde status for each planet on each day. Calculated at noon UTC. Omit year and month to get the month in progress, so a published ephemeris page stays current without a redeploy. Essential for ephemeris generation, transit tracking, and planetary movement visualization. Monthly planetary ephemeris API, sidereal position table, daily graha gochara positions, ecliptic longitude calculator.

Read only

Input schema

{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'year': {'type': 'integer', 'example': 2026, 'maximum': 2649, 'minimum': 1551, 'description': 'Year for monthly ephemeris (1551 to 2649). Defaults to the current year (UTC).'}, 'month': {'type': 'integer', 'example': 2, 'maximum': 12, 'minimum': 1, 'description': 'Month number (1-12) for ephemeris. Defaults to the current month (UTC).'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'coordinateSystem': {'enum': ['sidereal', 'tropical'], 'type': 'string', 'default': 'sidereal', 'example': 'sidereal', 'description': 'Coordinate system for longitude output. "sidereal" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. "tropical" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to "sidereal".'}}}

Output schema

{'type': 'object', 'required': ['year', 'month', 'days'], 'properties': {'days': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'positions'], 'properties': {'date': {'type': 'string'}, 'positions': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'longitude', 'sign', 'degreeInSign', 'isRetrograde'], 'properties': {'sign': {'type': 'string'}, 'planet': {'type': 'string'}, 'longitude': {'type': 'number'}, 'degreeInSign': {'type': 'number'}, 'isRetrograde': {'type': 'boolean'}, 'signLocalized': {'type': 'string'}, 'planetLocalized': {'type': 'string'}}}}}}}, 'year': {'type': 'number'}, 'month': {'type': 'number'}}}

post_vedic_astrology_shadbala

Get Shadbala (six-fold planetary strength) analysis - Shadbala Calculator API

Calculate complete Shadbala (six-fold planetary strength) per Brihat Parashara Hora Shastra (BPHS) and BV Raman Graha and Bhava Balas. Returns all 6 strength components (Sthana Bala, Dig Bala, Kala Bala, Chesta Bala, Naisargika Bala, Drik Bala) plus Ishta Phala, Kashta Phala, strength ratio, and relative ranking for all 7 classical planets. Essential for evaluating planetary strength in Vedic birth chart analysis, dasha prediction, transit interpretation, and yoga assessment. Shadbala calculator API, planetary strength Vedic astrology, graha bala, Ishta Kashta Phala.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['balaThemes', 'frame', 'planets'], 'properties': {'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'planets': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'sthanaBala', 'digBala', 'kalaBala', 'chestaBala', 'naisargikaBala', 'drikBala', 'totalVirupas', 'totalRupas', 'minRequired', 'strengthRatio', 'ishtaPhala', 'kashtaPhala', 'relativeRank'], 'properties': {'planet': {'type': 'string'}, 'digBala': {'type': 'number'}, 'drikBala': {'type': 'number'}, 'kalaBala': {'type': 'number'}, 'chestaBala': {'type': 'number'}, 'ishtaPhala': {'type': 'number'}, 'sthanaBala': {'type': 'number'}, 'totalRupas': {'type': 'number'}, 'kashtaPhala': {'type': 'number'}, 'minRequired': {'type': 'number'}, 'relativeRank': {'type': 'number'}, 'totalVirupas': {'type': 'number'}, 'strengthRatio': {'type': 'number'}, 'naisargikaBala': {'type': 'number'}}}}, 'balaThemes': {'type': 'object', 'required': ['sthanaBala', 'digBala', 'kalaBala', 'chestaBala', 'naisargikaBala', 'drikBala'], 'properties': {'digBala': {'type': 'object', 'required': ['name', 'meaning'], 'properties': {'name': {'type': 'string'}, 'meaning': {'type': 'string'}}}, 'drikBala': {'type': 'object', 'required': ['name', 'meaning'], 'properties': {'name': {'type': 'string'}, 'meaning': {'type': 'string'}}}, 'kalaBala': {'type': 'object', 'required': ['name', 'meaning'], 'properties': {'name': {'type': 'string'}, 'meaning': {'type': 'string'}}}, 'chestaBala': {'type': 'object', 'required': ['name', 'meaning'], 'properties': {'name': {'type': 'string'}, 'meaning': {'type': 'string'}}}, 'sthanaBala': {'type': 'object', 'required': ['name', 'meaning'], 'properties': {'name': {'type': 'string'}, 'meaning': {'type': 'string'}}}, 'naisargikaBala': {'type': 'object', 'required': ['name', 'meaning'], 'properties': {'name': {'type': 'string'}, 'meaning': {'type': 'string'}}}}}}}

post_vedic_astrology_transit

Transit Analysis - Compare current planets to natal chart (Gochar)

Analyze planetary transits (Gochar) over natal chart positions. Each transiting graha comes back with TWO whole-sign house numbers, because the two readings answer different questions: houseFromMoon is counted from the natal Moon sign (Janma Rashi), which is the reference classical Gochara uses, and natalHouse is counted from the Lagna. Also returns graha drishti onto the natal grahas (7th for every graha, plus Mars 4th and 8th, Jupiter 5th and 9th, Saturn 3rd and 10th), degree-based angular aspects with orbs, the Gochara Kaksha verdict, and highlighted transits from the slow-moving grahas (Jupiter, Saturn, Rahu, Ketu). Essential for timing predictions, event forecasting, and understanding current planetary influences. Transit analysis API, gochar calculator, vedic transit predictions, Chandra Lagna gochara, graha drishti.

Read only

Input schema

{'type': 'object', 'examples': [{'latitude': 17.385044, 'birthDate': '1990-07-04', 'birthTime': '10:12:00', 'longitude': 78.486671, 'transitDate': '2026-02-03'}], 'required': ['birthDate', 'birthTime', 'transitDate', 'latitude', 'longitude'], 'properties': {'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'latitude': {'type': 'number', 'example': 17.385044, 'maximum': 90, 'minimum': -90, 'description': 'Observer latitude in decimal degrees. Determines Placidus house cusps for natal chart house assignments.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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).'}, 'birthDate': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Used to calculate the natal chart against which transits are analyzed.'}, 'birthTime': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in HH:MM:SS format (24-hour). Critical for accurate natal Lagna and Placidus house cusps which determine transit house placements.'}, 'longitude': {'type': 'number', 'example': 78.486671, 'maximum': 180, 'minimum': -180, 'description': 'Observer longitude in decimal degrees. Affects local sidereal time for Lagna and house calculations.'}, 'transitDate': {'type': 'string', 'format': 'date', 'example': '2026-02-03', 'description': 'Transit date to analyze in YYYY-MM-DD format. Planetary positions on this date are overlaid on the natal chart.'}, 'transitTime': {'type': 'string', 'format': 'time', 'example': '12:00:00', 'description': 'Transit time in HH:MM:SS format (24-hour). Affects fast-moving planets like Moon. Defaults to noon.'}, 'coordinateSystem': {'enum': ['sidereal', 'tropical'], 'type': 'string', 'default': 'sidereal', 'example': 'sidereal', 'description': 'Coordinate system for longitude output. "sidereal" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. "tropical" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to "sidereal".'}}}

Output schema

{'type': 'object', 'required': ['frame', 'birthDatetime', 'transitDatetime', 'natalPlanets', 'transitingPlanets', 'keyTransits'], 'properties': {'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'keyTransits': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'description', 'natalHouse', 'houseFromMoon', 'aspects', 'drishti'], 'properties': {'planet': {'type': 'string'}, 'aspects': {'type': 'array', 'items': {'type': 'string'}}, 'drishti': {'type': 'array', 'items': {'type': 'string'}}, 'natalHouse': {'type': 'number'}, 'description': {'type': 'string'}, 'houseFromMoon': {'type': 'number'}}}}, 'natalPlanets': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'longitude', 'sign', 'house'], 'properties': {'name': {'type': 'string'}, 'sign': {'type': 'string'}, 'house': {'type': 'number'}, 'longitude': {'type': 'number'}}}}, 'birthDatetime': {'type': 'string'}, 'transitDatetime': {'type': 'string'}, 'transitingPlanets': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'longitude', 'sign', 'natalHouse', 'houseFromMoon', 'aspectsToNatal', 'drishtiToNatal', 'kaksha'], 'properties': {'name': {'type': 'string'}, 'sign': {'type': 'string'}, 'kaksha': {'type': 'object', 'required': ['number', 'lord', 'startDegree', 'endDegree', 'bindu', 'binduCount'], 'properties': {'lord': {'type': 'string'}, 'bindu': {'type': ['boolean', 'null']}, 'number': {'type': 'number'}, 'endDegree': {'type': 'number'}, 'binduCount': {'type': ['number', 'null']}, 'startDegree': {'type': 'number'}}}, 'longitude': {'type': 'number'}, 'natalHouse': {'type': 'number'}, 'houseFromMoon': {'type': 'number'}, 'aspectsToNatal': {'type': 'array', 'items': {'type': 'object', 'required': ['natalPlanet', 'aspectType', 'orb'], 'properties': {'orb': {'type': 'number'}, 'aspectType': {'type': 'string'}, 'natalPlanet': {'type': 'string'}}}}, 'drishtiToNatal': {'type': 'array', 'items': {'type': 'object', 'required': ['natalPlanet', 'aspectType', 'strength', 'orb'], 'properties': {'orb': {'type': 'number'}, 'strength': {'type': 'number'}, 'aspectType': {'enum': ['conjunction', '7th', '4th', '8th', '5th', '9th', '3rd', '10th'], 'type': 'string'}, 'natalPlanet': {'type': 'string'}}}}}}}}}

post_vedic_astrology_transit_monthly

Monthly Transit - Planetary sign changes for an entire month

Get all planetary sign (rashi) changes for a given month. Shows when each planet transitions from one zodiac sign to another. Covers all 9 Vedic planets: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu. Includes starting positions at the beginning of the month. Omit year and month to get the month in progress, so a published gochar calendar stays current without a redeploy. Essential for transit prediction, monthly horoscope generation, and muhurta planning. Monthly planetary transit API, gochar calendar, rashi parivartan dates.

Read only

Input schema

{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'year': {'type': 'integer', 'example': 2026, 'maximum': 2649, 'minimum': 1551, 'description': 'Year for monthly transit analysis (1551 to 2649). Defaults to the current year (UTC).'}, 'month': {'type': 'integer', 'example': 2, 'maximum': 12, 'minimum': 1, 'description': 'Month number (1-12) for transit analysis. Defaults to the current month (UTC).'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 0, 'example': 5.5, 'description': '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 once, at the start of the window, and that offset applies to every time in the response. Output times are converted to this timezone. Defaults to 0 (UTC).'}, 'coordinateSystem': {'enum': ['sidereal', 'tropical'], 'type': 'string', 'default': 'sidereal', 'example': 'sidereal', 'description': 'Coordinate system for longitude output. "sidereal" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. "tropical" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to "sidereal".'}}}

Output schema

{'type': 'object', 'required': ['year', 'month', 'timezone', 'startingPositions', 'transitEvents'], 'properties': {'year': {'type': 'number'}, 'month': {'type': 'number'}, 'timezone': {'type': 'number'}, 'transitEvents': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'fromSign', 'toSign', 'date', 'time', 'datetime', 'isRetrograde'], 'properties': {'date': {'type': 'string'}, 'time': {'type': 'string'}, 'planet': {'type': 'string'}, 'toSign': {'type': 'string'}, 'datetime': {'type': 'string'}, 'fromSign': {'type': 'string'}, 'isRetrograde': {'type': 'boolean'}, 'planetLocalized': {'type': 'string'}, 'toSignLocalized': {'type': 'string'}, 'fromSignLocalized': {'type': 'string'}}}}, 'startingPositions': {'type': 'array', 'items': {'type': 'object', 'required': ['planet', 'sign', 'longitude'], 'properties': {'sign': {'type': 'string'}, 'planet': {'type': 'string'}, 'longitude': {'type': 'number'}, 'signLocalized': {'type': 'string'}, 'planetLocalized': {'type': 'string'}}}}}}

post_vedic_astrology_upagraha

Get upagraha (sub-planet) positions - Upagraha Calculator API

Calculate all 11 Vedic upagraha (sub-planet) positions per Brihat Parashara Hora Shastra (BPHS). Returns 6 time-based upagrahas (Gulika, Mandi, Kala, Mrityu, Ardhaprahara, Yamaghantaka) derived from the 8-part day/night division, plus 5 Sun-longitude-based upagrahas (Dhuma, Vyatipata, Parivesha, Indra Chapa, Upaketu). Essential for complete kundli analysis, dosha assessment, and advanced chart interpretation. Upagraha calculator API, Gulika Mandi position, sub-planet Vedic astrology.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['frame', 'timeBased', 'sunBased'], 'properties': {'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'sunBased': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'longitude', 'rashi', 'degreeInSign', 'nakshatra', 'nakshatraIndex', 'nakshatraPada'], 'properties': {'name': {'type': 'string'}, 'rashi': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'string'}, 'degreeInSign': {'type': 'number'}, 'nakshatraPada': {'type': 'number'}, 'nakshatraIndex': {'type': 'number'}}}}, 'timeBased': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'longitude', 'rashi', 'degreeInSign', 'nakshatra', 'nakshatraIndex', 'nakshatraPada'], 'properties': {'name': {'type': 'string'}, 'rashi': {'type': 'string'}, 'longitude': {'type': 'number'}, 'nakshatra': {'type': 'string'}, 'degreeInSign': {'type': 'number'}, 'nakshatraPada': {'type': 'number'}, 'nakshatraIndex': {'type': 'number'}}}}}}

post_vedic_astrology_yoga_detect

Detect classical Vedic yogas in a birth chart

Chart-driven detection of 48 classical Vedic yogas. Twelve conjunction and dignity yogas: Gajakesari (parashara three-rule definition), Sunapha, Anapha, Dhurdhura, Kemadruma, Chandra Mangala, Budha-Aditya, and the five Pancha Mahapurusha yogas (Ruchaka, Bhadra, Hamsa, Malavya, Sasa). Plus all 32 Nabhasa distribution yogas, which describe how the seven visible grahas are spread across the whole chart rather than any single conjunction, across four families: Asraya (Rajju, Musala, Nala), Dala (Mala, Sarpa), Akriti (Gada, Shakata, Vihaga, Shringataka, Hala, Vajra, Yava, Kamala, Vapi, Yupa, Shara, Shakti, Danda, Nauka, Kuta, Chhatra, Dhanusha, Ardhachandra, Chakra, Samudra) and Sankhya (Gola, Yuga, Shoola, Kedara, Pasa, Damini, Veena). Plus four wealth and poverty verdicts, each ONE answer over a whole family of classical rules: Dhana Yoga over the eleven catalogued wealth combinations of BPHS ch. 41, Daridra Yoga over the poverty combinations of BPHS ch. 42 and Phaladeepika ch. 6, Lakshmi Yoga (BPHS ch. 36), and Dhana Malika (Jataka Parijata ch. 7). Their evidence names every rule that matched and the exact condition it matched on, so a wealth reading cites the combination rather than a label, and a rule resting on a single authority is excluded from the verdict and says so rather than quietly counting. Each yoga is returned with an `id`, `name`, a `present` boolean, a `quality` (Positive, Negative, or Both, i.e. auspicious, inauspicious, or context-dependent), and a classical-text `evidence` string naming the rule that triggered or failed (kendra position, dignity, malefic drishti, lordship, retrograde state, sign modality, bhava distribution). Nabhasa results also apply the four classical precedence norms, so a yoga that matched its own rule but was outranked by a stronger family is returned as absent with evidence naming the norm that silenced it, letting you explain a verdict rather than only report it. There is no separate major/minor flag; `quality` is the auspiciousness axis. Unlike GET /yoga and GET /yoga/{id} which are dictionary lookups, this endpoint computes the kundli from birth data and runs the detection rules. Sources: BPHS ch. 35 and ch. 75, Mantreswara Phaladeepika ch. 6, B.V. Raman Three Hundred Important Combinations.

Read only

Input schema

{'type': 'object', 'examples': [{'date': '1990-07-04', 'time': '10:12:00', 'latitude': 28.6139, 'longitude': 77.209}], 'required': ['date', 'time', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '1990-07-04', 'description': 'Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', 'description': '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.'}, 'time': {'type': 'string', 'format': 'time', 'example': '10:12:00', 'description': 'Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.'}, 'compact': {'type': 'boolean', 'default': False, 'description': 'Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.'}, 'ayanamsa': {'enum': ['kp-newcomb', 'kp-old', 'lahiri', 'raman', 'custom'], 'type': 'string', 'default': 'lahiri', 'example': 'lahiri', 'description': 'Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.'}, 'latitude': {'type': 'number', 'example': 28.6139, 'maximum': 90, 'minimum': -90, 'description': 'Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.'}, 'timezone': {'anyOf': [{'type': 'number', 'maximum': 14, 'minimum': -14}, {'type': 'string'}], 'default': 5.5, 'example': 5.5, 'description': '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.'}, 'longitude': {'type': 'number', 'example': 77.209, 'maximum': 180, 'minimum': -180, 'description': 'Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.'}, 'ayanamsaValue': {'type': 'number', 'example': 24, 'description': '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.'}}}

Output schema

{'type': 'object', 'required': ['yogas', 'frame', 'total', 'birthDetails'], 'properties': {'frame': {'type': 'object', 'required': ['ayanamsa', 'ayanamsaDegrees'], 'properties': {'ayanamsa': {'type': 'string'}, 'ayanamsaDegrees': {'type': 'number'}}}, 'total': {'type': 'number'}, 'yogas': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'description', 'result', 'quality', 'family', 'present'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'family': {'enum': ['classical', 'asraya', 'dala', 'akriti', 'sankhya'], 'type': 'string'}, 'result': {'type': 'string'}, 'present': {'type': 'boolean'}, 'quality': {'enum': ['Positive', 'Negative', 'Both'], 'type': 'string'}, 'evidence': {'type': 'string'}, 'description': {'type': 'string'}, 'suppressedBy': {'enum': ['classical', 'asraya', 'dala', 'akriti', 'sankhya'], 'type': 'string'}}}}, 'birthDetails': {'type': 'object', 'required': ['date', 'time', 'latitude', 'longitude', 'timezone'], 'properties': {'date': {'type': 'string'}, 'time': {'type': 'string'}, 'latitude': {'type': 'number'}, 'timezone': {'type': 'number'}, 'longitude': {'type': 'number'}}}}}

Vedic Astrology and Kundli MCP Server by RoxyAPI

What this MCP does

Tools

Recent tool changes

Similar MCP servers

Asterwise

Sahadeva

tollbooth-sample

Thesportsdb

Rescuegroups

Recipes

F1

Nba