Ratna (gemas como remedio)

Ratna (रत्न) es la gema que sirve de remedio para un planeta. Nueve gemas, navaratna, una por cada uno de los nueve grahas. La pregunta “qué gema debo llevar” parece sencilla, pero la respuesta depende de la escuela, y las dos escuelas más extendidas prohíben cosas distintas. Por eso /v1/vedic/gemstones recibe la escuela como parámetro y la respuesta siempre indica con cuál se ha calculado.

Dos escuelas

Escuela	Qué recomienda	Qué prohíbe
lagna-lord (por defecto)	Las gemas de los regentes de las casas 1, 9 y 5: la gema vital, la de la suerte y la benéfica	Casi nada: solo el graha que rige exclusivamente dusthanas
functional-benefic	Las mismas tres gemas, pero primero va el yogakaraka, si lo hay	Las gemas de todos los maléficos funcionales para ese lagna

Las gemas recomendadas coinciden en ambas escuelas, y no es casualidad: un benéfico funcional se define como el graha que rige un trikona, y los regentes de los trikonas son precisamente los de la 1, la 5 y la 9. No lo supusimos: lo comprobamos recorriendo los doce lagnas y lo fijamos con un test.

La diferencia está donde le importa al comprador: la lista de prohibiciones. Para el lagna Leo, functional-benefic descarta la esmeralda, el diamante y el zafiro azul, mientras que lagna-lord no descarta ninguno de ellos. Si tu astrólogo trabaja con una escuela y tú le das al cliente la respuesta de la otra, la discrepancia estará justo aquí.

Endpoints

Endpoint	Créditos	Qué devuelve
POST /v1/vedic/gemstones	20	Recomendación según la carta: tres gemas con su papel, lista de prohibiciones, advertencia, estado de los planetas
GET /v1/vedic/gemstones/navaratna	5	Tabla de referencia de las nueve gemas, sin carta

Precaución

Las coordenadas son obligatorias. Toda la respuesta se deriva del lagna, así que latitude y longitude aquí no tienen el cero por defecto del resto de endpoints de carta: sin ellas obtienes un 400, y no un juego de gemas muy seguro de sí mismo para el ascendente de otra persona.

Ejemplo

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

Ejemplo de respuesta

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

Qué se devuelve exactamente

• basis en cada gema no es una etiqueta, sino una traza: qué casas rige el graha y por qué eso le da ese papel. La recomendación se puede verificar sin fiarse de nuestra palabra.
• wearing: día, dedo, metales, peso en ratti con conversión a gramos y quilates, bija mantra y número de japas. El peso se da como rango y el dedo como lista de opciones, porque los manuales no coinciden.
• substitutes (upa-ratna): en la práctica, la alternativa a un zafiro azul natural de 5 quilates no es “sin remedio”, sino un sustituto más barato. Quien calcula el coste de la recomendación tiene que ver las dos opciones.
• condition: dignidad, combustión y retrogradación de cada graha. Es contexto, no una regla: ambas escuelas prescriben según la regencia de las casas, y afirmar otra cosa sería inventar una tercera escuela.
• nodesNote: Rahu y Ketu no rigen ningún signo, así que desde el lagna ninguna de las escuelas llega al hessonita ni al ojo de gato. Lo decimos claramente, en lugar de devolver en silencio siete gemas de nueve.

Precisión y fuentes

• Correspondencia gema-graha: Garuda Purana (Acharakhanda, sección ratna-pariksha) y Varahamihira, Brihat Samhita, cap. 80. Ambos textos dan el mismo conjunto de nueve gemas.
• La regla de las tres gemas (vital, de la suerte, benéfica) es la práctica moderna estándar.
• Clasificación funcional: Bepin Behari, Fundamentals of Vedic Astrology. La propia regla del yogakaraka viene del BPHS: el graha que rige a la vez un kendra y un trikona.
• Cómo se ha verificado. No es una técnica numérica, aquí no hay nada que pueda derivar respecto a las efemérides. Solo cabe una comprobación: las reglas tienen que reproducir las prescripciones publicadas sin tenerlas escritas a mano en ningún sitio. La sexteta clásica de yogakarakas (Saturno para Tauro y Libra, Marte para Cáncer y Leo, Venus para Capricornio y Acuario) sale sola de la regla de regencia, igual que las listas conocidas de prohibiciones para Aries, Tauro, Cáncer y Leo. Cada una de estas afirmaciones es un test.
• El lagna es sideral, derivado mediante la ayanamsa. El ascendente tropical suele estar desplazado un signo entero, y eso cambiaría cada gema de la respuesta.
• El protocolo de uso (día, dedo, metal, peso, mantra) es práctica moderna, no shastra. Por eso se dan opciones y un rango, y no un único número presentado como canon.

Peligro

Es un remedio, no medicina ni una tasación de compra. La identidad de la gema, su tratamiento y su peso los debe confirmar un gemólogo o joyero cualificado antes de comprarla. Ninguna gema sustituye un tratamiento: para cualquier cuestión de salud, consulta a un médico. Esta advertencia va en todas las respuestas del endpoint.

Relacionado

• Shadbala, la fuerza del planeta, si necesitas una visión cuantitativa y no de remedio
• Doshas, Mangal, Kaal Sarp y otras aflicciones para las que tradicionalmente se elige una gema
• Vargas, cartas divisionales
• Créditos, la tabla completa de tarifas
• Autenticación, cómo obtener una clave aw_live_*