Vedika Astrology and Vastu

Send natural-language astrology questions to the Vedika API, with birth details when the operation requires them. Select Vedic, Western or KP through the documented system field; use conversationId for follow-up questions. Operation and language availability depend on the route and account plan. Response time depends on request complexity, answer length and selected tier. Review current billing terms at https://vedika.io/pricing before production use.

Manage multi-turn AI conversations. List recent active conversations (default 10, maximum 100, ordered by last activity). Pass data.nextCursor to continue, even after an empty page; stop at null. data.paginationAvailable=false means continuation is unavailable. Activity can change between calls; this is not a snapshot. Get a specific conversation with stored messages, delete one, or extend its TTL. Conversations are created automatically when you use vedika_ai_chat and persist for context continuity. Free.

Generate a Vedic birth chart (Kundli) with planetary positions, house cusps, ascendant, nakshatras, and dignities. All calculations use Vedika Ephemeris (sidereal, Lahiri ayanamsa default). "kundli" returns the full chart. "planetary-positions" returns all 9 planets + Rahu/Ketu with sign, degree, house, nakshatra, retrograde status. "house-cusps" returns all 12 house boundaries. "ascendant" returns lagna details. Cost: $0.016-0.028/call.

Calculate planetary period timelines (Dasha). Vimshottari is the primary 120-year cycle used in Vedic astrology — shows current Mahadasha (major period), Antardasha (sub-period), and Pratyantar (sub-sub-period) with exact start/end dates. Based on Moon nakshatra at birth. Yogini is an alternative 8-year cycle. Cost: $0.016-0.028/call.

Detect unfavorable planetary combinations (doshas) in a birth chart. Mangal Dosha checks Mars in houses 1,2,4,7,8,12 (affects marriage — BPHS Ch. 80 vv. 47-49 / Stri Jataka). Kaal Sarp detects all planets enclosed between Rahu-Ketu axis. Sade Sati tracks Saturn 7.5-year transit over natal Moon (3 phases). Pitru checks ancestral karma. Nadi checks pulse compatibility. "all" runs Mangal+Kaal Sarp+Pitru together. Cost: $0.016-0.040/call.

Vedic marriage/relationship compatibility matching. Requires birth details for BOTH male and female. Guna Milan uses 36-point Ashtakoot system (North Indian) scoring 8 factors: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi. 18+/36 is acceptable. Kundali adds Mangal Dosha cross-check. Nakshatra Porutham is 10-factor South Indian. Thirumana Porutham is Tamil marriage matching. Cost: $0.040-0.048/call.

Hindu calendar (Panchang) for today or a specific date/time. Returns the 5 limbs: Tithi (lunar day), Nakshatra (lunar mansion), Yoga (luni-solar combination), Karana (half-tithi), and Vara (weekday). Also includes sunrise/sunset/moonrise times. Location defaults to Delhi if not specified. Cost: $0.012/call.

Calculate auspicious and inauspicious time periods for today or a specific date. Choghadiya divides the day into ~90-minute slots. Hora assigns planetary rulers to each hour. Rahu Kaal, Gulika Kaal, Yamaghanta are inauspicious periods to avoid. Abhijit Muhurta is the most auspicious midday window. Brahma Muhurta is the pre-dawn spiritual window. "combined" returns choghadiya+hora+rahu-kaal. "auspicious" returns only good periods. Location defaults to Delhi. Cost: $0.012-0.020/call.

Calculate Vedic divisional charts (Vargas). Each division reveals a specific life area: D2 Hora (wealth), D3 Drekkana (siblings), D4 Chaturthamsa (property), D7 Saptamsa (children), D9 Navamsa (marriage/dharma — most important after Rashi), D10 Dashamsa (career), D12 Dwadashamsa (parents), D16 Shodasamsa (vehicles), D20 Vimsamsa (spiritual), D24 Chaturvimsamsa (education), D27 Bhamsa (strength), D30 Trimsamsa (evils), D40 Khavedamsa (maternal), D45 Akshavedamsa (paternal), D60 Shashtiamsa (past-life karma). Vedika Ephemeris computed. Cost: $0.005/call.

Get Vedic astrology predictions for a zodiac sign or from birth details. Daily, weekly, monthly, quarterly, or yearly. If rashi (zodiac sign) is provided, returns sign-based prediction. If birth datetime is provided, Moon sign is derived automatically. First call per sign per day is charged; subsequent calls same sign+day are cached (free). Accepts English (aries-pisces) and Hindi (mesha-meena) sign names. Cost: $0.020-0.088/call.

Calculate Ashtakavarga — the 8-fold division system scoring each planet strength across 12 signs (0-8 points per sign). "planet" returns Bhinnashtakavarga (individual planet table). "sarva" returns Sarvashtakavarga (combined all 7 planets per sign, max 337 total). Signs scoring 28+ in SAV are strong for transits. Used for timing events. Cost: $0.025/call.

Western astrology current transits against a natal chart. Tropical zodiac (no ayanamsa). "chart" returns the full transit chart overlay. "positions" returns current planetary positions in tropical signs. "aspects" returns current transit aspects (conjunction, opposition, trine, square, sextile) to natal planets with orbs. Vedika Ephemeris computed. Cost: $0.064/call.

Western secondary progressions — "a day for a year" technique. Shows how natal chart evolves over time. Progressed Moon moves ~1 degree/month (changes sign every 2.5 years). Progressed Sun moves ~1 degree/year. "chart" returns full progressed chart. "positions" returns progressed planets. "aspects" returns progressed-to-natal aspects. Tropical zodiac. Cost: $0.092/call.

Western solar return chart — cast for the exact moment the transiting Sun returns to its natal position each year (your "solar birthday"). Reveals themes for the coming year. "chart" returns full solar return chart. "positions" returns planets at solar return moment. "aspects" returns solar return chart aspects. Tropical zodiac. Cost: $0.120/call.

Western relationship astrology — synastry and composite charts for two people. Synastry overlays charts to find inter-aspects (how planets interact between two people). Composite creates a midpoint chart representing the relationship itself. Uses person1/person2 (gender-neutral). Tropical zodiac. Cost: $0.148/call.

Get a daily, weekly, or monthly Vedic horoscope, or a daily Western horoscope, for a zodiac sign. Western with advanced=true uses the advanced registered route. Unsupported Western weekly/monthly requests fail before any API call. Accepts English (aries-pisces) and Hindi (mesha-meena) sign names. Consult current Vedika API pricing before use.

Numerology calculations using Pythagorean or Chaldean systems. Life Path (birth date) = life purpose. Destiny/Expression (full name) = talents. Personality (consonants) = how others see you. Soul Urge (vowels) = inner desires. Personal Year = current year theme. Complete = all core numbers + pinnacle cycles. Compatibility = two-person comparison. Cost: $0.003-0.010/call.

Vedic annual horoscope (Varshaphal / Tajaka Solar Return). Cast for the exact moment the Sun returns to its natal sidereal position each year. Uses Tajaka system with Sahams (sensitive points), Muntha (progressed ascendant), and Tajaka yogas. Different from Western Solar Return — uses sidereal zodiac. Cost: $0.006/call.

Calculate planetary strength and relationships. Chandra Bala = Moon strength (8 types for muhurta timing). Tara Bala = nakshatra compatibility (9 Tara groups). Upagraha = sub-planet positions (Dhuma, Vyatipata, Parivesha, Chapa, Upaketu, Gulika, Mandi). Planet Relationship = Naisargika Maitri friendship table per BPHS. Shadbala = the 6-fold strength system (Sthana, Dig, Kala, Cheshta, Naisargika, Drik bala), normalized 0-100. Cost: $0.020/call.

Vedic calendar calculations and timing. Ritu = Hindu 6-season system. Solstice = equinox/solstice dates. Anandadi Yoga = 27 yogas from tithi+weekday. Auspicious/Inauspicious Yoga = daily favorable combos. Auspicious/Inauspicious Period = time windows for activities. Gowri Nalla Neram = South Indian Choghadiya. Disha Shool = inauspicious directions per weekday. Planet Transit = current transit positions. Chandrashtama = Moon in 8th from natal Moon (avoid important work). Cost: $0.016-0.020/call.

Check your Vedika API usage, wallet balance, and billing history. Wallet balance is in USD cents (divide by 100 for dollars). History returns recent transactions (default 50, maximum 500) from at most 1000 latest records. No page or cursor is available. Summary and models aggregate at most 1000 records; check the returned truncated and scanLimit fields. Models groups by public service tier. Free — no cost to check.

Look up a static Vastu Shastra reference table — no calculation, no building input required. mandala-9-zone/mandala-45-devatas/mandala-64-pada = the Vastu Purusha Mandala grids and their presiding devatas. directions-8/16/32 = the compass direction system at increasing resolution. defects-catalog/remedies-catalog = known Vastu doshas (defects) and their corresponding remedies. colors-by-zone/materials-by-zone = recommended colors/materials per compass zone. gate-obstructions = the Brihat Samhita 53.76-81 table of features (road/tree/well/pillar/etc.) opposite the main gate and their verdicts. Billed reference operation.

Audit an entire floor plan for Vastu compliance in one call — pass every room in the building with the compass zone it actually occupies, and get back a per-room compliance verdict, severity, and remedy for anything misplaced, plus an overall score. Use vastu_room_placement instead if you only need guidance for a single room.

Get Vastu Shastra placement guidance for ONE room type in a specific (or proposed) compass zone — whether it is compliant, the severity if not, the recommended zone, and the remedy. One dedicated backend endpoint per room type. Use vastu_audit_floor_plan instead to check a whole building at once.

Project a Vastu Purusha Mandala grid onto a plot polygon. "9-zone" = the coarse 9-sector grid. "81-pada" = the 81-square plan of Brihat Samhita 53.43-48: each cell carries its verse square number and, where the verse names one, the devata it seats there (28 squares have none). Fitting that grid to YOUR polygon is a computed layout convention, not a classical measurement. "brahmasthan" = just the central sacred zone that must stay unbuilt. Returns which mandala cell/devata falls where on the plot.

Generate a Vastu-compliant floor plan from a high-level brief instead of an explicit room list — give it plot dimensions plus a room programme (BHK, bathrooms, parking, pooja room, etc.) and it infers and places the rooms. Returns up to 3 ranked variants.

Look up a coarse magnetic-declination reference estimate for India. The result is unverified and is not field calibration; do not treat it as a verified compass correction.

Call any Vastu Shastra operation directly by its path suffix under /v2/astrology/vastu/ — for the long tail of the 143-operation surface not covered by the dedicated vastu_* tools. Examples: "entrance/recommend", "entrance/pada", "entrance/obstruction-check", "placement/borewell", "placement/main-gate", "score/overall", "score/zone-wise", "specialized/temple", "timing/grihapravesh", "timing/bhumi-pujan", "plot/shape", "plot/slope", "compound/wall-analysis", "elements/distribution", "plan/analyze", "plan/optimize", "direction/sun-path", "ar/true-north-calibrate". Prefer a dedicated vastu_* tool when your need matches one.

Submit 1-1000 assessment, plan analysis or report inputs. Retain the Idempotency-Key. Quote is maxCharge; only successful items charge the existing operation price. No job fee.

Read job status, counts and billing. Read-only; does not charge.

Read one results page with per-item response, receipts and artifacts. Pass nextCursor verbatim; null ends pagination. Results expire after 7 days.

Cancel unstarted job items. An item already in flight can finish and charge. This call does not charge.

Fetch the exact completed item artifact and original receipt by stable job and item IDs. HTML reports use format:html at submit. No arbitrary URLs are fetched; reads do not charge.

Draw tarot cards in a chosen spread layout. Single = 1 card quick answer. Three-card = past/present/future or situation/action/outcome. Celtic Cross = 10-card comprehensive reading covering situation, challenges, past, future, above, below, advice, environment, hopes, and outcome. Horseshoe = 7-card arc. Relationship and Career spreads are themed 5-card layouts. Each card includes upright/reversed orientation, suit, and position meaning. Cost: $0.020-0.048/call.

Get the tarot card of the day. Returns a single card with its upright meaning, reversed meaning, keywords, element, suit, and daily guidance. Cached per day — repeated calls return the same card. Cost: $0.008/call.

Cast an I Ching (Book of Changes) hexagram for divination. Uses the traditional yarrow stalk or three-coin method simulation. Returns the primary hexagram (1-64), its name, judgment, image, and line texts. If any changing lines exist, also returns the transformed hexagram. Each hexagram includes the upper and lower trigrams with their attributes. The I Ching is the oldest Chinese divination system (~3000 years). Cost: $0.012/call.

Get Chinese zodiac animal sign and element for a birth year. Returns the animal (Rat through Pig in 12-year cycle), element (Wood, Fire, Earth, Metal, Water in 60-year cycle), yin/yang polarity, lucky numbers, lucky colors, compatible animals, and incompatible animals. Accounts for Chinese New Year date (animal year starts late Jan/early Feb, not Jan 1). Cost: $0.003/call.

Calculate the current basic Ba Zi (Four Pillars) chart from a timezone-free birth datetime. Returns Year, Month, Day, and Hour pillars, Day Master, dominant element, and element balance. This route does not provide Da Yun, annual luck pillars, or favorable/unfavorable elements. Timezone-bearing input is temporarily rejected while accepted civil, zoned, or solar-time semantics remain unresolved. Consult current Vedika API pricing before use.

Generate a Human Design BodyGraph chart from birth details. Human Design synthesizes the I Ching, Kabbalah Tree of Life, Hindu-Brahmin chakra system, and quantum physics. Returns your Type (Generator, Manifestor, Projector, Reflector, Manifesting Generator), Strategy, Authority (Emotional, Sacral, Splenic, etc.), Profile (e.g., 1/3, 4/6), defined/undefined Centers (9 centers), Channels, and Gates. The BodyGraph is calculated from precise birth time using planetary positions at birth and 88 degrees of the Sun before birth. Cost: $0.040/call.

Get crystal and gemstone recommendations based on zodiac sign, ruling planet, or specific need. Returns recommended crystals with properties, chakra association, cleansing method, and how to use them. Combines Vedic ratna-shastra (gemstone science from Garuda Purana and BPHS) with modern crystal healing correspondences. Accepts zodiac sign (Vedic or Western) or a specific planet to strengthen. Cost: $0.012/call.

Comprehensive Kundali matching for marriage. The default report combines the 36-point Ashtakoota Guna Milan, a Dashakoot summary, dosha cancellation analysis (Mangal, Nadi, Bhakoot) and an overall compatibility verdict. Set southIndian=true for the South Indian Porutham system instead. Consult current Vedika API pricing before use.

Calculate the Ashtottari Dasha (108-year cycle). An alternative to Vimshottari (120-year) used when Rahu is in a Kendra or Trikona from the Lagna lord, or when the birth is at night in Krishna Paksha / day in Shukla Paksha. Uses 8 planets (excludes Ketu) with periods: Sun 6y, Moon 15y, Mars 8y, Mercury 17y, Saturn 10y, Jupiter 19y, Rahu 12y, Venus 21y = 108 total. Returns current Mahadasha, Antardasha, and full timeline with start/end dates. Cost: $0.020/call.

Get Lal Kitab remedies for afflicted planets based on their house placement. Lal Kitab (Red Book) is a 20th-century Urdu text offering unique remedies distinct from classical BPHS — simple, actionable totkas (remedies) involving donations, wearing specific items, keeping objects at home, or performing actions on specific days. Returns planet-by-planet analysis with house placement, whether the planet is exalted/debilitated in Lal Kitab terms (different from Parashari), the affliction description, and 2-3 specific remedies per afflicted planet. Cost: $0.020/call.

Get personalized mantra recommendations based on birth chart analysis. Identifies weak or afflicted planets and recommends Vedic mantras from classical texts (Mantra Mahodadhi, BPHS remedies chapter). Returns the mantra in Sanskrit (Devanagari + IAST transliteration), the specific planet or deity it addresses, recommended repetition count (japa sankhya), best time to chant (muhurta), direction to face, and associated rosary (mala) material. Can also return mantras for specific purposes like career, health, or relationships. Cost: $0.016/call.

Determine the Ishta Devata (personal deity) from the birth chart. Uses the Atmakaraka (soul planet) and its Navamsa (D9) placement to identify the deity most aligned with the native per BPHS Ch.33. Also returns Dharma Devata (from 9th lord in D9), Palana Devata (sustenance deity from Amatya Karaka in D9), and Guru Devata (spiritual guide from Bhratri Karaka in D9). Each deity includes associated mantras, temples, worship day, and offerings. Cost: $0.020/call.

Ayurvedic constitution (Prakriti) analysis derived from birth chart. Maps planetary positions to the three doshas: Vata (air+ether, governed by Saturn and Rahu), Pitta (fire+water, governed by Sun and Mars), and Kapha (earth+water, governed by Moon and Jupiter). Returns dominant dosha, sub-dosha balance, vulnerable body areas based on 6th/8th house lords, recommended diet type, lifestyle adjustments, favorable seasons, and Ayurvedic herbs aligned with the chart. Based on Brihat Samhita and Charaka Samhita cross-references. Cost: $0.024/call.

Get the day's general content in one call: tarot card, angel number, crystal, mantra, moon phase, rune and I Ching. It is not a personal or per-sign reading. For a sign horoscope use vedika_horoscope, and for panchang use vedika_panchang. Consult current Vedika API pricing before use.

Full numerology report combining all core numbers in a single call. Returns Life Path number (from birth date), Destiny/Expression number (from full name), Soul Urge/Heart Desire number (from vowels), Personality number (from consonants), Maturity number (Life Path + Destiny), Personal Year/Month/Day cycles, Pinnacle cycles (4 life phases), Challenge numbers, Karmic Debt numbers (13, 14, 16, 19), Karmic Lessons (missing digits in name), Hidden Passion (most frequent digit), and Lucky Day/Color. Supports both Pythagorean and Chaldean systems. Cost: $0.010/call.