Ratna (pierres de remède)

Ratna (रत्न) est la pierre de remède d’une planète. Neuf pierres, navaratna, une pour chacune des neuf grahas. La question “quelle pierre dois-je porter” semble simple, mais la réponse dépend de l’école, et les deux écoles répandues donnent des interdictions différentes. C’est pourquoi /v1/vedic/gemstones prend l’école en paramètre et indique toujours dans la réponse selon laquelle il a calculé.

Deux écoles

École	Ce qu’elle recommande	Ce qu’elle interdit
lagna-lord (par défaut)	Les pierres des maîtres des maisons 1, 9 et 5 : pierre de vie, pierre de chance et pierre bénéfique	Presque rien : seulement une graha qui ne possède que des dusthanas
functional-benefic	Les mêmes trois pierres, mais le yogakaraka passe en premier s’il existe	Les pierres de tous les maléfiques fonctionnels pour ce lagna

Les pierres recommandées coïncident dans les deux écoles, et ce n’est pas un hasard : un bénéfique fonctionnel est défini comme une graha qui possède un trikona, et les maîtres des trikonas sont précisément les maîtres des maisons 1, 5 et 9. Nous ne l’avons pas supposé, nous l’avons vérifié en parcourant les douze lagnas, et nous l’avons fixé par un test.

La différence est là où elle compte pour l’acheteur : la liste des interdictions. Pour un lagna Lion, functional-benefic écarte l’émeraude, le diamant et le saphir bleu, alors que lagna-lord n’en écarte aucun. Si votre astrologue travaille dans une école et que vous donnez au client la réponse de l’autre, la divergence sera précisément là.

Endpoints

Endpoint	Crédits	Ce qu’il renvoie
POST /v1/vedic/gemstones	20	Recommandation selon la carte : trois pierres avec leur rôle, liste des interdictions, mises en garde, état des planètes
GET /v1/vedic/gemstones/navaratna	5	Table de référence des neuf pierres, sans carte

Attention

Les coordonnées sont obligatoires. Toute la réponse est dérivée du lagna, c’est pourquoi latitude et longitude n’ont pas ici de zéro par défaut comme dans les autres endpoints de carte : sans elles, vous obtiendrez un 400, et non un jeu de pierres sûr de lui pour l’ascendant de quelqu’un d’autre.

Exemple

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

Exemple de réponse

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

Ce qui est renvoyé exactement

• basis sur chaque pierre n’est pas une étiquette, mais une trace : quelles maisons appartiennent à la graha et pourquoi cela lui donne ce rôle. La recommandation peut être vérifiée sans nous croire sur parole.
• wearing : jour, doigt, métaux, poids en ratti avec conversion en grammes et en carats, bija-mantra et nombre de japas. Le poids est donné sous forme de plage, et le doigt sous forme de liste de variantes, car les manuels divergent.
• substitutes (upa-ratna) : l’alternative à un saphir bleu naturel de 5 carats n’est pas, en pratique, “pas de remède”, mais un substitut moins cher. Quiconque calcule le coût d’une recommandation doit voir les deux options.
• condition : dignité, combustion, rétrogradation de chaque graha. C’est un contexte, pas une règle : les deux écoles prescrivent selon la possession des maisons, et affirmer le contraire reviendrait à inventer une troisième école.
• nodesNote : Rahu et Ketu ne possèdent aucun signe, donc depuis le lagna aucune des écoles ne mène au hessonite ni à l’œil-de-chat. Nous l’écrivons clairement, au lieu de renvoyer en silence sept pierres sur neuf.

Précision et sources

• Correspondance pierre-graha : Garuda Purana (Acharakhanda, section ratna-pariksha) et Varahamihira, Brihat Samhita, ch. 80. Les deux textes donnent le même ensemble de neuf pierres.
• La règle des trois pierres (vie, chance, bénéfique) est la pratique moderne standard.
• Classification fonctionnelle : Bepin Behari, Fundamentals of Vedic Astrology. La règle du yogakaraka elle-même vient du BPHS : une graha qui possède à la fois un kendra et un trikona.
• Comment c’est vérifié. Ce n’est pas une technique numérique, il n’y a rien ici qui puisse dériver par rapport aux éphémérides. Une seule vérification est possible : les règles doivent reproduire les prescriptions publiées sans les coder en dur nulle part. Les six yogakarakas classiques (Saturne pour le Taureau et la Balance, Mars pour le Cancer et le Lion, Vénus pour le Capricorne et le Verseau) découlent d’eux-mêmes de la règle de possession, tout comme les listes d’interdictions connues pour le Bélier, le Taureau, le Cancer et le Lion. Chacune de ces affirmations est un test.
• Le lagna est sidéral, dérivé via l’ayanamsa. Un ascendant tropical est généralement décalé d’un signe entier, ce qui changerait chaque pierre de la réponse.
• Le protocole de port (jour, doigt, métal, poids, mantra) est une pratique moderne, et non un shastra. D’où des variantes et une plage, plutôt qu’un seul nombre présenté comme canonique.

Danger

C’est un remède, ni de la médecine ni une évaluation d’achat. L’identité de la pierre, son traitement et son poids doivent être confirmés par un gemmologue ou un joaillier qualifié avant l’achat. Aucune pierre ne remplace un traitement médical : pour toute question de santé, consultez un médecin. Cette mise en garde figure dans chaque réponse de l’endpoint.

Voir aussi

• Shadbala, la force d’une planète, si vous avez besoin d’un regard quantitatif plutôt que d’un remède
• Doshas, Mangal, Kaal Sarp et autres afflictions pour lesquelles on choisit traditionnellement une pierre
• Vargas, les cartes divisionnaires
• Crédits, le tableau complet des tarifs
• Authentification, comment obtenir une clé aw_live_*