Sign in
latestOpenAPI 3.1.02026-08-237602082.8 MB

529d7d36d7d6

Vedic

Gemstone (ratna) recommendation

Which of the nine gems to wear, from the sidereal lagna. Two schools are implemented: lagna-lord (default) prescribes the gems of the 1st, 9th and 5th lords as the life, lucky and benefic stones; functional-benefic classifies every graha by the houses it owns from the lagna, prescribes only for functional benefics led by the yogakaraka, and names the functional malefics as gems to avoid. Both reach the same three gems, because a functional benefic is a graha owning a trikona and the trikona lords are the 1st, 5th and 9th: the school changes the ordering, the role each gem carries, and the avoid list. The response always reports which one produced it. Coordinates are required, since the whole answer is derived from the lagna. Each gem carries its substitutes, day, finger, metal, weight range in ratti/grams/carats, and beeja mantra. Planet dignity is returned as context and does not change the list.

post/vedic/gemstones

Request body

datestring required
timestring required
timezoneOffsetnumber nullable

Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.

latitudenumber required

Birth latitude. Required: the lagna is what both schools prescribe from.

longitudenumber required

Birth longitude. Required: the lagna is what both schools prescribe from.

houseSystemstring
namestring
citystring
zodiacType'tropical' | 'sidereal'
ayanamsaIdnumber nullable
ayanamsa'fagan-bradley' | 'lahiri' | 'de-luce' | 'raman' | 'krishnamurti' | 'kp' | 'yukteshwar' | 'jn-bhasin' | 'true-citra' | 'djwhal-khul'

Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.

cosmogramboolean
school'lagna-lord' | 'functional-benefic'

Prescription school. Both reach the same three gems (the trikona lords), and differ on what they withhold and on the ordering. The response always names the one used. Default: lagna-lord.

Response

Successful calculation

okboolean

Example response

{
  "ok": true
}