Ratna (gemme come rimedio)

Il ratna (रत्न) è la gemma-rimedio di un pianeta. Nove gemme, il navaratna, una per ciascuno dei nove graha. La domanda “quale gemma devo indossare” sembra semplice, ma la risposta dipende dalla scuola, e le due scuole più diffuse danno divieti diversi. Per questo /v1/vedic/gemstones prende la scuola come parametro, e nella risposta scrive sempre con quale ha calcolato.

Due scuole

Scuola	Cosa raccomanda	Cosa vieta
lagna-lord (predefinita)	Le gemme dei signori della 1ª, 9ª e 5ª casa: la gemma della vita, della fortuna e benefica	Quasi nulla: solo il graha che governa esclusivamente dusthana
functional-benefic	Le stesse tre gemme, ma al primo posto c’è lo yogakaraka, se presente	Le gemme di tutti i malefici funzionali per quel lagna

Le gemme raccomandate coincidono nelle due scuole, e non per caso: un benefico funzionale è definito come il graha che governa un trikona, e i signori dei trikona sono proprio i signori della 1ª, 5ª e 9ª. Non lo abbiamo dato per scontato, lo abbiamo verificato su tutti e dodici i lagna e fissato con un test.

La differenza sta dove conta per chi acquista: l’elenco dei divieti. Per il lagna Leone, functional-benefic esclude smeraldo, diamante e zaffiro blu, mentre lagna-lord non esclude nessuno di questi. Se il tuo astrologo lavora con una scuola e tu dai al cliente la risposta dell’altra, la discrepanza sarà proprio qui.

Endpoint

Endpoint	Crediti	Cosa restituisce
POST /v1/vedic/gemstones	20	Raccomandazione per la carta: tre gemme con il loro ruolo, elenco dei divieti, avvertenze, stato dei pianeti
GET /v1/vedic/gemstones/navaratna	5	Tabella di riferimento delle nove gemme, senza carta

Attenzione

Le coordinate sono obbligatorie. Tutta la risposta deriva dal lagna, per cui qui latitude e longitude non hanno lo zero predefinito come negli altri endpoint delle carte: senza di esse ricevi un 400, e non un set di gemme sicuro di sé per l’ascendente di qualcun altro.

Esempio

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")

Esempio di risposta

{
  "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..."
}

Cosa viene restituito esattamente

• basis su ogni gemma non è un’etichetta ma una traccia: quali case governa il graha e perché questo gli dà quel ruolo. Puoi verificare la raccomandazione senza fidarti sulla parola.
• wearing: giorno, dito, metalli, peso in ratti con conversione in grammi e carati, bija mantra e numero di japa. Il peso è dato come intervallo e il dito come elenco di varianti, perché i manuali non sono concordi.
• substitutes (upa-ratna): in pratica l’alternativa a uno zaffiro blu naturale da 5 carati non è “nessun rimedio”, ma un sostituto più economico. Chi calcola il costo della raccomandazione deve vedere entrambe le opzioni.
• condition: dignità, combustione, retrogradazione di ciascun graha. È contesto, non una regola: entrambe le scuole assegnano le gemme in base al governo delle case, e sostenere altro significherebbe inventare una terza scuola.
• nodesNote: Rahu e Ketu non governano alcun segno, quindi dal lagna nessuna delle due scuole arriva a hessonite e occhio di gatto. Lo scriviamo apertamente, invece di restituire in silenzio sette gemme su nove.

Precisione e fonti

• Corrispondenza gemma-graha: il Garuda Purana (Acharakhanda, sezione ratna-pariksha) e Varahamihira, Brihat Samhita, cap. 80. Entrambi i testi danno lo stesso set di nove gemme.
• La regola delle tre gemme (della vita, della fortuna, benefica) è la pratica moderna standard.
• Classificazione funzionale: Bepin Behari, Fundamentals of Vedic Astrology. La regola dello yogakaraka viene dal BPHS: il graha che governa sia un kendra sia un trikona.
• Come è stato verificato. Non è una tecnica numerica, qui non c’è nulla che possa scostarsi dalle effemeridi. L’unica verifica possibile: le regole devono riprodurre le assegnazioni pubblicate senza cablarle da nessuna parte. Il classico sestetto degli yogakaraka (Saturno per Toro e Bilancia, Marte per Cancro e Leone, Venere per Capricorno e Acquario) emerge da solo dalla regola del governo delle case, così come gli elenchi di divieti noti per Ariete, Toro, Cancro e Leone. Ognuna di queste affermazioni è un test.
• Il lagna è siderale, derivato tramite ayanamsa. L’ascendente tropicale di solito è spostato di un segno intero, e questo cambierebbe ogni gemma della risposta.
• Il protocollo per indossarle (giorno, dito, metallo, peso, mantra) è pratica moderna, non shastra. Per questo ci sono varianti e intervalli, e non un unico numero presentato come canone.

Pericolo

È un rimedio, non una terapia medica né una valutazione d’acquisto. L’identità della gemma, i trattamenti e il peso devono essere confermati da un gemmologo o da un gioielliere qualificato prima dell’acquisto. Nessuna gemma sostituisce le cure: per qualsiasi questione di salute rivolgiti a un medico. Questa avvertenza è presente in ogni risposta dell’endpoint.

Correlati

• Shadbala, la forza del pianeta, se ti serve uno sguardo quantitativo e non rimediale
• Dosha, Mangal, Kaal Sarp e le altre afflizioni per cui tradizionalmente si sceglie la gemma
• Varga, le carte divisionali
• Crediti, la tabella completa dei costi
• Autenticazione, come ottenere una chiave aw_live_*