Ratna (edelstenen als remedie)

Ratna (रत्न) is een edelsteen als remedie voor een planeet. Negen stenen, de navaratna, één voor elk van de negen graha’s. De vraag “welke steen moet ik dragen” klinkt eenvoudig, maar het antwoord hangt af van de school, en de twee gangbare scholen verbieden verschillende stenen. Daarom neemt /v1/vedic/gemstones de school als parameter en zegt het antwoord altijd volgens welke school het berekend is.

Twee scholen

School	Wat ze aanbeveelt	Wat ze verbiedt
lagna-lord (standaard)	De stenen van de heersers van het 1e, 9e en 5e huis: de levenssteen, de geluksteen en de weldoende steen	Bijna niets: alleen een graha die uitsluitend dusthana’s bezit
functional-benefic	Dezelfde drie stenen, maar de yogakaraka komt eerst als die er is	De stenen van alle functionele malefics voor deze lagna

De aanbevolen stenen zijn in beide scholen gelijk, en dat is geen toeval: een functionele benefic is gedefinieerd als een graha die een trikona bezit, en de heersers van de trikona’s zijn precies de heersers van het 1e, 5e en 9e huis. Dat hebben we niet aangenomen maar gecontroleerd door alle twaalf lagna’s door te rekenen, en we hebben het vastgelegd in een test.

Het verschil zit waar het voor de koper telt: de lijst met verboden stenen. Voor een Leeuw-lagna schrapt functional-benefic smaragd, diamant en blauwe saffier, terwijl lagna-lord geen van die drie schrapt. Werkt je astroloog in de ene school en geef je je klant het antwoord van de andere, dan zit het verschil precies hier.

Endpoints

Endpoint	Credits	Wat het teruggeeft
POST /v1/vedic/gemstones	20	Aanbeveling op basis van de horoscoop: drie stenen met hun rol, een lijst met verboden stenen, een disclaimer, de toestand van de planeten
GET /v1/vedic/gemstones/navaratna	5	Referentietabel van de negen stenen, zonder horoscoop

Opgepast

Coördinaten zijn verplicht. Het hele antwoord wordt afgeleid van de lagna, dus latitude en longitude hebben hier geen standaardwaarde nul zoals bij de andere chart-endpoints: zonder die velden krijg je een 400, en geen zelfverzekerde set stenen voor de ascendant van iemand anders.

Voorbeeld

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

Voorbeeldantwoord

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

Wat er precies terugkomt

• basis bij elke steen is geen label maar een herleiding: welke huizen de graha bezit en waarom dat deze rol oplevert. Je kunt de aanbeveling controleren zonder ons op ons woord te geloven.
• wearing: dag, vinger, metalen, gewicht in ratti met omrekening naar grammen en karaat, de bija-mantra en het aantal japa’s. Het gewicht is een bereik en de vinger een lijst met opties, omdat de handboeken het niet eens zijn.
• substitutes (upa-ratna): het alternatief voor een natuurlijke blauwe saffier van 5 karaat is in de praktijk niet “geen remedie”, maar een goedkopere vervanger. Wie de kosten van een aanbeveling berekent, moet beide opties zien.
• condition: waardigheid, verbranding en retrograde beweging van elke graha. Dit is context, geen regel: beide scholen schrijven voor op basis van huisbezit, en iets anders beweren zou een derde school verzinnen.
• nodesNote: Rahu en Ketu bezitten geen enkel teken, dus vanuit de lagna kom je in geen van beide scholen bij hessoniet of kattenoog uit. Dat zeggen we expliciet, in plaats van stilletjes zeven van de negen stenen terug te geven.

Nauwkeurigheid en bronnen

• Koppeling van steen aan graha: de Garuda Purana (Acharakhanda, het hoofdstuk ratna-pariksha) en Varahamihira, Brihat Samhita, hfdst. 80. Beide teksten geven dezelfde set van negen stenen.
• De regel van drie stenen (levenssteen, geluksteen, weldoende steen) is de gangbare moderne praktijk.
• Functionele classificatie: Bepin Behari, Fundamentals of Vedic Astrology. De yogakaraka-regel zelf komt uit de BPHS: een graha die zowel een kendra als een trikona bezit.
• Hoe het gecontroleerd is. Dit is geen numerieke techniek, dus er is niets dat ten opzichte van de efemeride kan afwijken. Er is maar één controle mogelijk: de regels moeten gepubliceerde voorschriften reproduceren zonder die ergens hard te coderen. De klassieke zes yogakaraka’s (Saturnus voor Stier en Weegschaal, Mars voor Kreeft en Leeuw, Venus voor Steenbok en Waterman) volgen vanzelf uit de regel van huisbezit, net als de bekende lijsten met verboden stenen voor Ram, Stier, Kreeft en Leeuw. Elk van die beweringen is een test.
• De lagna is siderisch, afgeleid via de ayanamsa. Een tropische ascendant ligt meestal een heel teken verschoven, en dat zou elke steen in het antwoord veranderen.
• Het draagprotocol (dag, vinger, metaal, gewicht, mantra) is moderne praktijk, geen shastra. Daarom varianten en een bereik, en niet één getal dat als canon wordt gepresenteerd.

Gevaar

Dit is een remedie, geen geneeskunde en geen aankoopadvies. De identiteit van de steen, de behandeling en het gewicht moeten vóór aankoop worden bevestigd door een gekwalificeerde gemmoloog of juwelier. Geen enkele steen vervangt een medische behandeling: ga met elke gezondheidsvraag naar een arts. Deze disclaimer staat in elk antwoord van het endpoint.

Gerelateerd

• Shadbala, de kracht van een planeet, als je geen remediërende maar een kwantitatieve blik nodig hebt
• Dosha’s, Mangal, Kaal Sarp en andere afflicties waarvoor traditioneel een steen wordt gekozen
• Varga’s, divisionele horoscopen
• Credits, de volledige tarieftabel
• Authenticatie, hoe je een aw_live_*-sleutel krijgt