Sign in
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
}

Changes

Changed in 5 of the 13 revisions of this API.10647

  • 8ab5a768b521442See the full diff
    • ▲

      the response property data/avoid/items/ became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property data/cautions/items/ became nullable for the status 200

      response-property-became-nullable

    • ▲

      the data/avoid/items/ response's property type/format changed from / to object/ for status 200

      response-property-type-changed

    • ▲

      the data/cautions/items/ response's property type/format changed from / to object/ for status 200

      response-property-type-changed

    • ○

      added the optional property data/avoid/items/basis to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/avoid/items/gem to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/avoid/items/gemSanskrit to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/avoid/items/graha to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/avoid/items/grahaName to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/avoid/items/grahaSanskrit to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/avoid/items/housesOwned to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/avoid/items/mineral to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/avoid/items/role to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/avoid/items/substitutes to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/avoid/items/wearing to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/ayanamsa to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/cautions/items/basis to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/cautions/items/gem to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/cautions/items/gemSanskrit to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/cautions/items/graha to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/cautions/items/grahaName to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/cautions/items/grahaSanskrit to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/cautions/items/housesOwned to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/cautions/items/mineral to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/cautions/items/role to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/cautions/items/substitutes to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/cautions/items/wearing to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/condition/Jupiter to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/condition/Mars to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/condition/Mercury to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/condition/Moon to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/condition/Saturn to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/condition/Sun to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/condition/Venus/degreeInSign to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/condition/Venus/house to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/condition/Venus/isRetrograde to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/condition/Venus/sign to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/conditionNote to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/lagna/longitude to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/nodesNote to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/recommended/items/grahaName to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/recommended/items/grahaSanskrit to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/recommended/items/mineral to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/recommended/items/wearing/fingerVariants to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/recommended/items/wearing/minWeight/grams to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/schoolNote to the response with the 200 status

      response-optional-property-added

  • dd3764875e7a1See the full diff
    • ○

      added the new optional request property allOf[ChartInput]/ayanamsa

      new-optional-request-property

  • e637d1a9911b2See the full diff
    • ●

      the allOf[ChartInput]/timezoneOffset request property's max was set to 14.00

      request-property-max-set

    • ●

      the allOf[ChartInput]/timezoneOffset request property's min was set to -14.00

      request-property-min-set

  • 994755209cea2See the full diff
    • ▲

      the request property allOf[subschema #2]/latitude became not nullable

      request-property-became-not-nullable

    • ▲

      the request property allOf[subschema #2]/longitude became not nullable

      request-property-became-not-nullable

  • b0533bcc12c0444See the full diff
    • ▲

      the request property allOf[ChartInput]/latitude became not nullable

      request-property-became-not-nullable

    • ▲

      the request property allOf[ChartInput]/longitude became not nullable

      request-property-became-not-nullable

    • ▲

      the request property allOf[ChartInput]/latitude became required

      request-property-became-required

    • ▲

      the request property allOf[ChartInput]/longitude became required

      request-property-became-required

    • ●

      the allOf[ChartInput]/latitude request property's max was set to 90.00

      request-property-max-set

    • ●

      the allOf[ChartInput]/longitude request property's max was set to 180.00

      request-property-max-set

    • ●

      the allOf[ChartInput]/latitude request property's min was set to -90.00

      request-property-min-set

    • ●

      the allOf[ChartInput]/longitude request property's min was set to -180.00

      request-property-min-set

    • ○

      the request property allOf[subschema #2]/latitude became optional

      request-property-became-optional

    • ○

      the request property allOf[subschema #2]/longitude became optional

      request-property-became-optional

    • ○

      the latitude request property default value 0 was removed

      request-property-default-value-removed

    • ○

      the longitude request property default value 0 was removed

      request-property-default-value-removed