New Numerology API

Readings

Vedic Astrology Remedies API

The Vedic astrology remedies API from API for Astrology (apiforastrology.com) suggests traditional remedies for one birth chart: gemstones, rudraksha (sacred beads), mantras, havan (a fire ritual) and puja (a worship ritual).
Get a free API keyTry it in the API reference

Updated

© API for Astrology (apiforastrology.com). "Remedies explained". All rights reserved. Not to be copied or reused.John Doe's planetsSunMoonMarsMercuryJupiterVenusSaturnRahuKetuJupiterLucky gemstoneYellow sapphireIn gold, index finger, ThursdayMantraOm Graam Greem GraumSah Gurave NamahRudrakshaFive-faced beadWorn for JupiterPicked: Jupiter's periodruns 2014 to 2030

How the astrology remedies API works

  1. 1Each traditional remedy is chosen for one planet. Most follow the planet whose period is running now.
  2. 2For John Doe that is Jupiter, so a yellow sapphire, Jupiter's mantra and a five-faced rudraksha are suggested.
  3. 3The API returns each suggestion with the planet behind it, as traditional guidance, not medical or financial advice.
POST /v1/reading/section/topic:remedy-life-gemstone?as_of=2026-10-01200 OK
{
  "section": {
    "id": "topic:remedy-life-gemstone"
  },
  "blocks": [
    {
      "selection": {
        "graha": "Mercury",
        "stone": "Emerald",
        "metal": "gold",
        "finger": "little",
        "day": "Wednesday"
      }
    }
  ]
}
The life gemstone suggested for John Doe's chart, the planet it is chosen for, and how it is traditionally worn. Real output for John Doe, born Aug 15, 1990, 10:30 AM, New York.

Call the astrology remedies API from your code

Send the details as JSON with your API key in the Authorization header. Copy the code, set ASTROLOGY_API_KEY to your key, and run it.

POST /v1/reading/section/topic:remedy-life-gemstone

# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/reading/section/topic:remedy-life-gemstone?as_of=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'

What the remedies API returns

  • Nine remedy topics: life gemstone, lucky gemstone, rudraksha, lucky mantra, havan and puja, and general remedies. Also remedies for sade sati (a long Saturn period), kaal sarp and pitra dosha.
  • The life gemstone, read from the ruler of the rising sign. It stays the same for life.
  • The lucky gemstone, rudraksha, mantra and havan, read from the planet whose main period (mahadasha) is running. They change when the period changes; send as_of to pick the date.
  • For each gemstone: the planet it is chosen for, the stone, the metal, the finger and the day to start wearing it.
  • The birth-star remedy, in the nakshatra (birth star) reading. It gives the star's deity, its mantra, and the next dates it is traditionally done, worked out for the person.
  • Rudraksha (POST /v1/remedies/rudraksha): which bead (mukhi) and why, chosen three ways: the ruler of the rising sign, the running main period and the birth star. Each bead comes with the day to start, the thread color and the planet's mantra.
  • Where the tradition adds a caution about a stone, the caution comes with it; the stone is never hidden.
  • Charity (POST /v1/remedies/charity): what to give, to whom and on which day. Fasting (POST /v1/remedies/fasting): which weekday fasts to keep, as one simple meal. Each set names its planet and the reason it applies.
  • Every fasting answer carries a caution: skip or soften the fast when pregnant, unwell, older or on medicine, and ask a doctor first.

Most remedies are reading sections, fetched from POST /v1/reading/section/{section_id} with ids such as topic:remedy-life-gemstone. The rudraksha suggestion also has its own endpoint, POST /v1/remedies/rudraksha, with each bead's reasons as data. The kaal sarp and pitra remedies come back only when the chart has that dosha, and the sade sati remedies only while it is running.

Astrology remedies API endpoints

What it uses from your plan

Calculations use 1 call each. Written readings use reading credits instead:

  • One chapter1 credit
  • The year-ahead chapter3 credits
What reading credits buy

The rules behind the astrology remedies API

The life gemstone is the stone of the rising sign's ruler, and it does not change (RM-01). The other remedies follow the planet whose main period is running, and change with it (RM-02). A stone the tradition warns about is shown with the warning, never hidden (RM-03). A dosha remedy appears only with the dosha (RM-04). The birth-star remedy is based on the nakshatra, not on a planet (NR-01), and its dates are worked out, not left to the reader (NR-03). Each rudraksha mukhi stands for one planet (RM-06), and a chart picks a bead three ways, each with its reason (RM-07). The bead guidance is only what is standard and harmless, and it is not a guarantee (RM-08). Charity and fasting follow the planets of the running periods and the ruler of the rising sign (RM-10). Each planet has one charity and one fast, on its own weekday (RM-11), and neither promises a result (RM-12).

Browse the full rulebookEvery remedy section id

How we check the numbers

Every answer here starts from planet positions worked out from NASA JPL planet data (DE440). We test them against NASA JPL Horizons, NASA's planet position service. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. On 2,000 random birth charts, the rising sign agrees with Swiss Ephemeris within 0.004. An arc second is 1/3,600 of a degree. Our tests fail if a result drifts past these figures.

A practicing astrologer reviews the rules behind these answers. Each rule has an ID you can look up in the public rulebook.

See how we test accuracy

Terms used here

Who uses it

Related features

From the blog

Astrology remedies API questions

All questions
Is there a separate remedies endpoint?

Most remedies are reading sections. Fetch them from POST /v1/reading/section/{section_id} with IDs such as topic:remedy-life-gemstone, or call POST /v1/reading/sections to see which remedy sections this chart has. Three remedies also have their own endpoints, with each reason as data: POST /v1/remedies/rudraksha, POST /v1/remedies/charity and POST /v1/remedies/fasting.

See the reading endpoints
Why did the lucky gemstone change?

The lucky gemstone, rudraksha, mantra and havan follow the planet whose main period (mahadasha) is running, so they change when that period ends. The life gemstone comes from the ruler of the rising sign and never changes. Send as_of to choose the date the remedies are read for.

What a mahadasha is
Will the remedies API suggest a dosha remedy the customer does not need?

No. Kaal sarp and pitra dosha remedies come back only when the chart has that dosha. Sade sati remedies come back only while sade sati is running. So a puja store never offers a remedy for a problem the chart does not show.

Read rule RM-04
Are risky gemstones hidden?

No. Where tradition warns about a stone, such as blue sapphire, the warning comes back beside the suggestion, and the stone is never hidden. Show the warning to your customers next to the product.

Read rule RM-03
Does a remedy need the birth time?

For the life gemstone, yes, because it comes from the ruler of the rising sign, which changes about every two hours. The period remedies depend on the Moon's position, so a small error matters less, though it can move the date when a period changes.

Does the fasting remedy suit everyone?

No, and every fasting answer says so. It carries a caution in the reader's language. Skip or soften the fast when pregnant, unwell, older or on medicine, and ask a doctor first. Show the caution next to the list. A fast here is one simple meal on the planet's weekday, and it is never a promise of a result.

Read rule RM-12

Astrology API

Call it with a free test key

Create an account and a test key, then call any endpoint on this page. Or try a request in the API reference first.

Get a free API keyOpen the API reference

Your first answer

John Doe, New York

POST /v1/planets200 OK
  • RisingVirgoHast
  • SunCancerAshlesha
  • MoonTaurusMrigashira
  • MarsAriesKrittika

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    Open rules: every rule is published, so you can check any answer