Gemstone Recommendation API

Overview

Gemstone therapy (Ratna Shastra) is a key Vedic remedy. This API analyzes the chart and recommends:

Primary Gemstone: For strengthening weak but beneficial planets
Secondary Gemstones: Alternative options based on budget
Gemstones to Avoid: Stones that may amplify malefic influences
Wearing Guidelines: Metal, finger, day, and muhurta for wearing
Weight Recommendations: Minimum carat weight for effectiveness

Request

curl -X POST "https://api.vedika.io/v2/astrology/gemstone-recommendation" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "datetime": "1990-05-15T10:30:00+05:30",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "purpose": "career"
  }'

Parameters

Parameter	Type	Required	Description
`datetime`	string	Required	Birth date/time (ISO 8601)
`latitude`	number	Required	Birth latitude
`longitude`	number	Required	Birth longitude
`purpose`	string	Optional	Focus area: career, health, relationships, wealth, education, spiritual

Response

{
  "success": true,
  "data": {
    "primaryRecommendation": {
      "gemstone": "Yellow Sapphire",
      "sanskritName": "Pukhraj",
      "planet": "Jupiter",
      "reason": "Jupiter is yogakaraka and weak in 6th house - strengthening will boost career and wisdom",
      "planetStrength": 0.42,
      "beneficLevel": "High",
      "weight": {
        "minimum": 3.25,
        "recommended": 4.5,
        "unit": "carats"
      },
      "wearing": {
        "metal": "Gold",
        "finger": "Index finger (right hand)",
        "day": "Thursday",
        "time": "Morning during Jupiter Hora",
        "muhurta": "Pushya Nakshatra recommended"
      },
      "mantra": {
        "text": "Om Gram Greem Graum Sah Gurave Namah",
        "repetitions": 19000,
        "purpose": "Energize before wearing"
      }
    },
    "secondaryRecommendations": [
      {
        "gemstone": "Citrine",
        "sanskritName": "Sunela",
        "planet": "Jupiter",
        "reason": "Budget-friendly alternative to Yellow Sapphire",
        "effectiveness": "70% of Yellow Sapphire",
        "weight": { "minimum": 5, "unit": "carats" }
      },
      {
        "gemstone": "Yellow Topaz",
        "sanskritName": "Tapasvi Mani",
        "planet": "Jupiter",
        "reason": "Mid-range alternative",
        "effectiveness": "80% of Yellow Sapphire",
        "weight": { "minimum": 4, "unit": "carats" }
      }
    ],
    "additionalGemstones": [
      {
        "gemstone": "Emerald",
        "sanskritName": "Panna",
        "planet": "Mercury",
        "reason": "Mercury in 10th house supports career communication",
        "priority": "Optional - wear after 3 months of primary stone"
      }
    ],
    "gemstonesToAvoid": [
      {
        "gemstone": "Blue Sapphire",
        "planet": "Saturn",
        "reason": "Saturn is 8th lord - may intensify obstacles"
      },
      {
        "gemstone": "Hessonite",
        "planet": "Rahu",
        "reason": "Rahu in 12th - may increase confusion and losses"
      }
    ],
    "purposeAnalysis": {
      "requestedPurpose": "career",
      "relevantHouses": [10, 2, 6, 11],
      "keyPlanets": ["Jupiter", "Mercury", "Sun"],
      "recommendation": "Yellow Sapphire will strengthen 10th lord Jupiter, improving career prospects"
    },
    "qualityGuidelines": {
      "clarity": "Eye-clean, no visible inclusions",
      "color": "Golden yellow, uniform throughout",
      "cut": "Cushion or oval preferred",
      "origin": "Ceylon (Sri Lanka) or Bangkok recommended",
      "certification": "Recommended from GIA, IGI, or reputed gem lab"
    }
  },
  "metadata": { "cost": 0.008 }
}

Nine Planetary Gemstones

Sun - Ruby

Leadership, authority, health

Moon - Pearl

Mind, emotions, mother

Mars - Red Coral

Courage, property, siblings

Mercury - Emerald

Intelligence, communication

Jupiter - Yellow Sapphire

Wisdom, wealth, marriage

Venus - Diamond

Love, luxury, creativity

Saturn - Blue Sapphire

Career, discipline, longevity

Rahu - Hessonite

Ambition, foreign matters

Ketu - Cat's Eye

Spirituality, moksha