Remedies (upaya)

Upaya (उपाय) is a remedy for a graha that is weak or afflicted, or for a dosha. Most remedy lists online mix three layers without saying which is which: what a classical text prescribes, what modern manuals add, and what a particular school teaches. Here every item carries its source and a basis:

• classical: the cited text has it. The graha shanti comes from BPHS ch. 84, checked line by line against the Yajnavalkya Smriti, which gives the same lists in the same order.
• modern-popular: current practice, with the nearest documented source named. Beeja mantras, the mukhi-to-graha map for rudraksha, weekday fasts, the per-graha yantras.

Gemstones and Lal Kitab upayas are not repeated here: the items point at Ratna and /v1/vedic/lal-kitab/remedies, which already own them.

Endpoints

Endpoint	Credits	What it returns
GET /v1/vedic/remedies/catalogue	5	The whole catalogue: nine grahas, eight doshas
GET /v1/vedic/remedies/by-graha?graha=saturn	5	One graha’s remedies and the doshas that draw on it
GET /v1/vedic/remedies/by-dosha?dosha=sade-sati	5	One dosha: its classical status, its own rites, the remedies of its grahas
GET /v1/vedic/remedies/by-type?type=rudraksha	5	Every item of one type, or of a comma list of types
POST /v1/vedic/remedies/chart	20	From a birth chart: the weak or afflicted grahas, the doshas present, their remedies, and why each graha was selected

type is one of mantra, puja, deity, yantra, rudraksha, fasting, charity, colour, gemstone, lal-kitab. The three lookups take it as an optional filter; the chart route takes types as an array in the body.

Grahas: sun, moon, mars, mercury, jupiter, venus, saturn, rahu, ketu. Doshas: mangal, kaal-sarp, pitru, sade-sati, grahan, shrapit, guru-chandal, kemadruma.

What is in a graha’s entry

Type	Item	Basis
mantra	The Vedic mantra by its opening words, with the Veda reference and the BPHS 84 japa count	classical
mantra	The beeja mantra	modern-popular
puja	Graha shanti: image material, the contemplation form, samidh, havan, food	classical
charity	The dakshina at the close of the rite	classical
colour	The graha’s colour for flowers and garments, plus the weekday it rules	classical
rudraksha	Mukhi, with the deity the Shiva Purana gives that mukhi	modern-popular
yantra	The navagraha magic square, as a principle	modern-popular
fasting	The weekday fast (none for Rahu and Ketu)	modern-popular
deity, charity	BPHS 83.109-111, written for one complaint: a son denied by that graha	classical
gemstone	The gem’s name and a link to the navaratna table	classical
lal-kitab	A link to the Lal Kitab route with the graha’s id	modern-popular

Doshas

Each dosha says plainly whether it exists in the classical texts (classicalStatus). Kaal Sarp, Shrapit and Guru-Chandal do not: they are later doctrines, and their remedies are those of the grahas involved. Where BPHS has a rite for a related trigger, it is returned in specific with a note saying what it was written for:

• Pitru: BPHS 83.31-33 (curse of the father: shraddha at Gaya) and 83.106-108 (a parent’s shraddha left undone: pinda dana, Rudra abhisheka).
• Kaal Sarp: BPHS 83.17-19, the rite for the serpent curse. BPHS does not name Kaal Sarp; applying this rite to it is later practice, and the item says so.
• Grahan: BPHS 91.1-14, the rite for a birth during an eclipse, which is rarer than the natal conjunction the dosha detector reports.
• Kemadruma: classical (BPHS 37.11-13), but no remedy is given there.

The chart route

POST /v1/vedic/remedies/chart selects a graha when any of these fires, and lists every reason that fired:

1. Shadbala below the BPHS 27.32-33 requirement: 390 virupa for the Sun, 360 Moon, 300 Mars, 420 Mercury, 390 Jupiter, 330 Venus, 300 Saturn. The numbers are those of /vedic/shadbala/full.
2. Debilitated, in sidereal signs.
3. Combust, with the orbs /vedic/gemstones uses.
4. Forms a present dosha: Mangal, Kaal Sarp, Pitru, Shrapit, Grahan, Guru-Chandal as on /vedic/doshas/parashara/full; Kemadruma by BPHS 37.11-13; Sade Sati on targetDate (today when omitted).

Rahu and Ketu have no Shadbala, so they are selected only through a dosha. checked shows every graha against its requirement and every dosha’s result, so you can see what did not fire as well. The route does not rank remedies or say which to perform.

Caution

Coordinates are required on the chart route. Shadbala and the doshas read the lagna, so latitude and longitude do not default to zero: omit them and you get a 400.

Example

cURL

curl -X POST https://api.astroway.info/v1/vedic/remedies/chart \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-05-15",
    "time": "15:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52,
    "targetDate": "2026-11-07",
    "types": ["mantra", "puja"]
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/vedic/remedies/chart', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-05-15', time: '15:30:00', timezoneOffset: 3,
    latitude: 50.45, longitude: 30.52, targetDate: '2026-11-07',
  }),
});
const { data } = await r.json();
for (const g of data.selected.grahas) {
  console.log(g.name, g.reasons.map((x: any) => x.detail).join(' '));
  for (const item of g.remedies) console.log(`  ${item.type} (${item.basis}): ${item.title}`);
}

Python

import os, requests

r = requests.get(
    'https://api.astroway.info/v1/vedic/remedies/by-graha',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    params={'graha': 'saturn', 'type': 'mantra,charity'},
)
for item in r.json()['data']['remedies']:
    print(item['title'], '|', item['basis'], '|', item['source'])

Sample response (chart route, shortened)

{
  "type": "remedies-for-chart",
  "lagna": { "sign": 5, "signName": "Virgo" },
  "selected": {
    "grahas": [
      {
        "graha": "mercury",
        "name": "Mercury",
        "reasons": [
          {
            "code": "shadbala-below-required",
            "detail": "Shadbala 405.8 virupa, below the 420 BPHS requires for Mercury.",
            "source": "BPHS ch. 27 vv. 32-33"
          }
        ],
        "remedies": [
          {
            "id": "mercury.vedic-mantra",
            "type": "mantra",
            "title": "Vedic mantra of Mercury",
            "detail": { "mantraKind": "vedic", "pratika": "Udbudhyasva", "vedaRef": "Shukla Yajurveda (Vajasaneyi) 15.54", "japaCount": 9000 },
            "basis": "classical",
            "source": "BPHS ch. 84 vv. 17-20 (graha shanti; ch. 86 in the G.C. Sharma 2006 edition) for the count; ..."
          }
        ]
      }
    ],
    "doshas": [
      {
        "dosha": "shrapit",
        "classicalStatus": "A modern name for Saturn with Rahu; not in the classical texts. The remedies are those of the two grahas.",
        "grahas": ["saturn", "rahu"],
        "details": ["Saturn + Rahu conjunct in Capricorn, house 5: Shrapit Dosha formed"],
        "specific": []
      }
    ]
  },
  "checked": {
    "grahas": [{ "graha": "mercury", "shadbalaVirupa": 405.77, "shadbalaRequired": 420, "sign": "Aries", "dignity": "neutral", "isCombust": false }],
    "doshas": { "mangal": true, "kaal-sarp": false, "shrapit": true, "grahan": true, "kemadruma": false, "sade-sati": false }
  },
  "disclaimer": "Traditional Jyotish practices, listed with their textual source for reference. Not a prediction, not a guarantee of any outcome..."
}

Accuracy and sources

• Graha shanti: BPHS ch. 84 in the 97-chapter numbering of the common English text (ch. 86 in the G.C. Sharma 2006 edition), against Yajnavalkya Smriti, Acharadhyaya 1.297-1.306. Image materials, Vedic mantras, samidh and dakshina agree between the two in order. Mars japa is 11000 in that translation and 10000 in many manuals; both are returned.
• Curses and eclipse birth: BPHS ch. 83 and ch. 91.
• Rudraksha: the deity of each mukhi is the Shiva Purana’s (Vidyeshvara Samhita ch. 25). Which mukhi belongs to which graha is modern practice, not the Purana.
• Left out because no source could be pinned: the grain dear to each graha, the numbers inside the navagraha yantras, a fasting day for Rahu and Ketu, stotras attributed to particular Puranas without a checked reference.

Danger

Reference, not advice. These are traditional practices listed with their sources. They are not predictions, carry no guarantee of any outcome, and replace no doctor, psychologist, lawyer or financial adviser. The note ships in every response.

Related

• Ratna (gemstones), which gem a chart calls for, by school
• Doshas, the detectors the chart route reads
• Shadbala, the strength numbers behind rule 1
• Credits, the full pricing table