Astrologia védica por API: de Parashara ao Lal Kitab em 354 endpoints

A astrologia védica é a mais antiga tradição astrológica contínua do mundo. Os seus métodos formais (BPHS, sutras de Jaimini, Lal Kitab, KP) são usados todos os dias na Índia: por casamenteiros, na escolha de datas, no diagnóstico proativo do destino. Mas chegar a cálculos de qualidade por código era, até há pouco, doloroso.

A AstroWay v2.19 resolve isso: mais de 354 endpoints védicos, verificados de forma cruzada com o PyJHora (a implementação de referência em Python), com as divergências documentadas.

Embora os dois zodíacos partam das mesmas posições dos planetas (calculadas com a Swiss Ephemeris), conceptualmente são diferentes:

O védico não é uma “alternativa” ao ocidental: é um sistema à parte com a sua própria estrutura lógica interna. Os integradores que fazem apps multi-tradição (horóscopo móvel, matchmaking, daily horoscope) querem muitas vezes os dois, e aqui uma só API em vez de dois fornecedores é uma poupança séria.

A maioria da concorrência só tem Vimshottari (ciclo de 120 anos, o mais popular). A AstroWay cobre:

1. Vimshottari (120 anos): o padrão do BPHS, transversal
2. Yogini (36 anos): previsões mais rápidas, 8 planetas
3. Ashtottari (108 anos): tradição Ardradi, recomendação por paksha
4. Kalachakra (signos como senhores de MD): o sistema mais complexo, o paramayu varia de mapa para mapa
5. Chara (Jaimini, móvel): para previsões baseadas em signos
6. Tribhagi (54 = Vimshottari/2 + extras): Vimshottari acelerado
7. Shatabdika (100 anos): contagens de fonte variadas
8. Shodashottari (116 anos): para mapas com paksha misto
9. Sthira (dasha rara de período fixo)
10. Shoola (método cross-rasi)

Cada uma suporta 5 níveis: Maha → Antar → Pratyantar → Sookshma → Prana.

Os mapas divisionais são olhares recursivos sobre o mesmo mapa natal a escalas diferentes. O D9 (Navamsha) é o mais importante para o casamento. O D10 (Dashamsha), para a carreira. O D60 (Shashtyamsha) é o nível mais fino.

Uma chamada a /v1/vedic/vargas devolve as 16 divisões de uma vez: o integrador não precisa de fazer 16 pedidos separados.

5 elementos + auxiliares:

• Tithi (dia lunar, 30 divisões do ciclo lunar)
• Karana (meio tithi, 11 tipos)
• Yoga (yoga do dia, 27 tipos, baseado na soma das longitudes do Sol e da Lua)
• Nakshatra (uma das 27 mansões lunares)
• Choghadia (o dia e a noite divididos em 8 blocos de auspiciosidade cada, de cerca de hora e meia)
• Hora (hora planetária)
• Rahu-kaal (janela desfavorável de 1,5 horas todos os dias)

Com /v1/vedic/panchang/full recebes os 8 elementos num só JSON para uma data e local concretos.

Uma yoga, no védico, é uma combinação planetária especial que forma um padrão de vida notório. Parashara (BPHS) descreve centenas; a AstroWay implementa as mais citadas:

• Raja: combinações de poder e reconhecimento
• Dhana: riqueza
• Dharma-Karmadhipati: percurso profissional
• Pancha-Mahapurusha: Ruchaka/Bhadra/Hamsa/Malavya/Shasha (5 planetas em casas kendra nos próprios signos)
• Gajakesari: Lua + Júpiter em kendra
• Adhi: Mercúrio/Vénus/Júpiter na 6.ª/7.ª/8.ª a partir da Lua

E ainda as específicas de Jaimini: karaka-yoga (8 chara karakas em casas significativas), karakamsa (projeção de 12 casas com o AK no D9), shubha-graha (benéfico funcional segundo o BPHS, Adhyaya 34).

Um dosha é uma aflição planetária que complica uma área concreta da vida. A AstroWay cobre três escolas:

• Parashara: Mangal Dosha (Marte), Kaal Sarp (planetas entre Rahu e Ketu), Pitru (karma ancestral), Shrapit, Grahan, Guru-Chandal
• Lal Kitab: Manglik (interpretação própria do Lal Kitab), e outros doshas exclusivos desta escola
• KP (Krishnamurti Paddhati): diagnóstico baseado em sub-lords

Se o teu serviço de matchmaking atende clientes de várias regiões da Índia (o Punjab usa muitas vezes LK, Tamil Nadu KP, todos usam Parashara), tens uma API em vez de três.

O processo clássico indiano de match:

1. Ashtakoot (Guna Milan): escala de 8 fatores, máximo de 36 pontos. Menos de 18 = pouco compatível. O mais popular no Norte e Centro da Índia.
2. Dashakoota: 10 fatores, variante do Sul da Índia.
3. Manglik check: crítico para mapas natais com Marte aflito.
4. Mangal match: compensa Marte-Marte.
5. Bhrigu match: sobreposição preditiva a partir do Bhrigu Samhita.

Tudo através de /v1/vedic/compatibility/full: uma chamada, um relatório de compatibilidade completo.

“Muhurta” é um momento auspicioso para dar início a um acontecimento. Os acontecimentos clássicos:

• Marriage muhurta (casamento)
• Vehicle purchase (automóvel)
• Business start (abertura de um negócio)
• Travel (viagens)
• Naming ceremony (Namakaran: atribuição do nome ao bebé)
• Surgery, education start, investment, property purchase, griha-pravesh (mudança para casa nova), engagement, court cases

/v1/vedic/muhurat/{event} devolve as 3 melhores datas auspiciosas no intervalo pedido.

Lahiri é o padrão (Chitra Paksha, o padrão oficial do governo indiano). Com o parâmetro ayanamsa podes mudar para:

• raman: tradição de B.V. Raman (popular no KP)
• krishnamurti: específico do KP
• yukteshwar: Sri Yukteshwar (distância à Spica)
• fagan-bradley: Fagan/Bradley (sideral ocidental)
• de-luce: De Luce
• jn-bhasin: JN Bhasin

Cada uma tem um offset diferente (normalmente 23,5–24,0°). Para o mesmo cliente, as posições dos planetas nos signos podem variar: convém saber isto logo na fase de arquitetura da tua app.

Cada endpoint tem:

• Status (GREEN/YELLOW) em docs/AUDIT-TRAIL.md
• Um cabeçalho AUDIT inline no código-fonte com as fontes (BPHS Adhyaya N, Jaimini Sutras X.Y, função de referência do PyJHora)
• Uma fixture de snapshot test para regressões

As divergências face ao PyJHora (onde existem, sobretudo em métodos de um só autor como o Lal Kitab) estão documentadas no AUDIT-TRAIL: o integrador vê o delta exato antes de integrar.

# Natal Vedic chart
curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Devolve o senhor da Maha-dasha atual, a data de fim da MD e a sequência das dashas seguintes. Por /maha → /antar → /pratyantar → … podes descer até ao 5.º nível.

Os relatórios védicos (PDF) estão disponíveis em 20 idiomas, incluindo hi, ko, ja, id, tr e vi, mercados com procura real de conteúdo védico. Passa lang=<code> a qualquer endpoint /v1/reports/*. Detalhes em /languages/.

Os endpoints védicos custam 10, 20 ou 50 créditos, conforme o que calculam: Lal Kitab e KP 10, vargas e elementos do panchang 20, doshas de Parashara, dashas, shadbala e muhurta 50. No plano gratuito (10 000 créditos) isto dá entre 200 e 1000 chamadas védicas por mês. Os relatórios PDF Vedic Kundli / Lal Kitab custam 5000.

• Categorias de endpoints védicos: navegação pelos 8 grupos
• Vedic API: visão geral completa com exemplos de código em 4 linguagens
• Início rápido: o primeiro pedido em 5 minutos
• Preços: do plano gratuito ao Enterprise