Ratna (pedras-remédio)

Ratna (रत्न) é a pedra-remédio de um planeta. Nove pedras, a navaratna, uma para cada um dos nove grahas. A pergunta “que pedra devo usar” parece simples, mas a resposta depende da escola, e as duas escolas mais comuns dão proibições diferentes. Por isso /v1/vedic/gemstones recebe a escola como parâmetro e a resposta diz sempre com qual foi calculada.

Duas escolas

Escola	O que recomenda	O que proíbe
lagna-lord (por omissão)	As pedras dos senhores das casas 1, 9 e 5: a pedra da vida, da sorte e benéfica	Quase nada: apenas o graha que rege exclusivamente dusthanas
functional-benefic	As mesmas três pedras, mas em primeiro lugar vem o yogakaraka, se existir	As pedras de todos os maléficos funcionais para este lagna

As pedras recomendadas coincidem nas duas escolas, e não por acaso: um benéfico funcional define-se como o graha que rege um trikona, e os senhores dos trikonas são precisamente os senhores das casas 1, 5 e 9. Não o presumimos: verificámo-lo correndo os doze lagnas e fixámo-lo num teste.

A diferença está onde importa a quem compra: a lista de proibições. Para o lagna Leão, functional-benefic retira a esmeralda, o diamante e a safira azul, e lagna-lord não retira nenhuma delas. Se o teu astrólogo trabalha numa escola e entregares ao cliente a resposta da outra, a divergência estará exatamente aqui.

Endpoints

Endpoint	Créditos	O que devolve
POST /v1/vedic/gemstones	20	Recomendação a partir do mapa: três pedras com o seu papel, lista de proibições, avisos, estado dos planetas
GET /v1/vedic/gemstones/navaratna	5	Tabela de referência das nove pedras, sem mapa

Cuidado

As coordenadas são obrigatórias. Toda a resposta deriva do lagna, por isso latitude e longitude aqui não têm o zero por omissão dos restantes endpoints de mapa: sem elas recebes um 400, e não um conjunto confiante de pedras para o ascendente de outra pessoa.

Exemplo

cURL

curl -X POST https://api.astroway.info/v1/vedic/gemstones \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52,
    "school": "functional-benefic"
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/vedic/gemstones', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-05-15', time: '14:30:00', timezoneOffset: 3,
    latitude: 50.45, longitude: 30.52, school: 'functional-benefic',
  }),
});
const { data } = await r.json();
console.log(`Lagna ${data.lagna.signName}, school ${data.school}`);
for (const g of data.recommended) console.log(`  ${g.role}: ${g.gem}`);
for (const g of data.avoid) console.log(`  avoid ${g.gem} (${g.basis})`);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/vedic/gemstones',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '1990-05-15', 'time': '14:30:00', 'timezoneOffset': 3,
        'latitude': 50.45, 'longitude': 30.52, 'school': 'functional-benefic',
    },
)
d = r.json()['data']
print(f"Lagna {d['lagna']['signName']} ({d['school']})")
for g in d['recommended']:
    w = g['wearing']
    print(f"  {g['gem']:16s} {w['day']:10s} {w['finger']:14s} {w['minWeight']['carats']} ct")

Exemplo de resposta

{
  "type": "gemstone-recommendation",
  "school": "functional-benefic",
  "ayanamsa": 23.7225,
  "lagna": { "sign": 4, "signName": "Leo", "lord": 0, "lordName": "Sun" },
  "recommended": [
    {
      "role": "yogakaraka (primary)",
      "graha": 4, "grahaName": "Mars",
      "gem": "Red coral", "gemSanskrit": "Moonga",
      "mineral": "Corallium rubrum",
      "housesOwned": [4, 9],
      "basis": "owns the 4th (kendra) and the 9th (trikona)",
      "substitutes": ["Carnelian", "Red jasper"],
      "wearing": {
        "day": "Tuesday",
        "finger": "Ring finger",
        "metals": ["Gold", "Copper"],
        "minWeight": { "ratti": [6, 9], "grams": [0.729, 1.094], "carats": [3.65, 5.47] },
        "mantra": "Om Kraam Kreem Kraum Sah Bhaumaya Namah",
        "japaCount": 10000
      }
    }
  ],
  "avoid": [
    { "gem": "Blue sapphire", "basis": "owns the 6th and no trikona" },
    { "gem": "Emerald", "basis": "owns the 11th and no trikona" }
  ],
  "condition": {
    "Sun": { "signName": "Taurus", "house": 10, "dignity": "neutral", "isCombust": false }
  },
  "disclaimer": "Traditional Jyotish remedy, informational only..."
}

O que é devolvido exatamente

• basis em cada pedra não é um rótulo, é um rastreio: que casas pertencem ao graha e porque é que isso lhe dá esse papel. A recomendação pode ser verificada sem acreditar na nossa palavra.
• wearing: dia, dedo, metais, peso em ratti com conversão para gramas e quilates, bija mantra e número de japas. O peso vem num intervalo e o dedo numa lista de opções, porque os manuais divergem.
• substitutes (upa-ratna): na prática, a alternativa a uma safira azul natural de 5 quilates não é “sem remédio”, é um substituto mais barato. Quem calcula o custo de uma recomendação tem de ver as duas opções.
• condition: dignidade, combustão e retrogradação de cada graha. Isto é contexto, não regra: as duas escolas prescrevem pela regência das casas, e afirmar o contrário seria inventar uma terceira escola.
• nodesNote: Rahu e Ketu não regem nenhum signo, por isso a partir do lagna nenhuma das escolas chega ao hessonite nem ao olho-de-gato. Dizemo-lo abertamente, em vez de devolver em silêncio sete pedras das nove.

Precisão e fontes

• Correspondência entre pedra e graha: Garuda Purana (Acharakhanda, secção ratna-pariksha) e Varahamihira, Brihat Samhita, cap. 80. Os dois textos dão o mesmo conjunto de nove pedras.
• A regra das três pedras (da vida, da sorte, benéfica) é a prática moderna corrente.
• Classificação funcional: Bepin Behari, Fundamentals of Vedic Astrology. A própria regra do yogakaraka vem do BPHS: o graha que rege tanto um kendra como um trikona.
• Como foi verificado. Não é uma técnica numérica, não há aqui nada que possa derivar em relação às efemérides. Só uma verificação é possível: as regras têm de reproduzir as prescrições publicadas sem as codificar em lado nenhum. A sêxtupla clássica de yogakarakas (Saturno para Touro e Balança, Marte para Caranguejo e Leão, Vénus para Capricórnio e Aquário) sai sozinha da regra da regência, tal como as listas de proibições conhecidas para Carneiro, Touro, Caranguejo e Leão. Cada uma destas afirmações é um teste.
• O lagna é sideral, obtido através da ayanamsa. O ascendente tropical costuma estar deslocado um signo inteiro, e isso mudaria todas as pedras da resposta.
• O protocolo de uso (dia, dedo, metal, peso, mantra) é prática moderna, não shastra. Daí as opções e o intervalo, em vez de um único número apresentado como cânone.

Perigo

Isto é um remédio, não medicina nem avaliação de uma compra. A identidade da pedra, o seu tratamento e o peso devem ser confirmados por um gemólogo ou joalheiro qualificado antes da compra. Nenhuma pedra substitui um tratamento médico: para qualquer questão de saúde, consulta um médico. Este aviso está em todas as respostas do endpoint.

Relacionado

• Shadbala, a força do planeta, se precisares de uma visão quantitativa e não de remédios
• Doshas, Mangal, Kaal Sarp e outras aflições para as quais tradicionalmente se escolhe a pedra
• Vargas, os mapas divisionais
• Créditos, a tabela completa de preços
• Autenticação, como obter uma chave aw_live_*