Gemstone Recommendations API

Personalized gemstone recommendations based on Vedic astrology and birth chart analysis

Planetary Gemstones in Vedic Astrology

Gemstones (Ratna) play a crucial role in Vedic astrology for balancing planetary influences and enhancing positive energies.

Sun - Ruby (Manik)

Enhances leadership, vitality, and self-confidence

Hot Ring finger Sunday

Moon - Pearl (Moti)

Improves emotional balance and mental peace

Cold Little finger Monday

Mars - Red Coral (Moonga)

Boosts courage, energy, and physical strength

Hot Ring finger Tuesday

Mercury - Emerald (Panna)

Enhances intelligence, communication, and business success

Cold Little finger Wednesday

Jupiter - Yellow Sapphire (Pukhraj)

Brings wisdom, prosperity, and spiritual growth

Cold Index finger Thursday

Saturn - Blue Sapphire (Neelam)

Provides stability, discipline, and protection from misfortunes

Cold Middle finger Saturday

Rahu - Hessonite (Gomed)

Protects from evil influences and enhances spiritual awareness

Hot Middle finger Saturday

Ketu - Cat's Eye (Lehsunia)

Brings spiritual enlightenment and removes obstacles

Hot Middle finger Tuesday

Venus - Diamond (Heera)

Enhances love, beauty, luxury, and artistic abilities

Cold Ring finger Friday

API Endpoints

Get Personalized Gemstone Recommendations

GET /v1/recommendations/gemstones Personalized

Get gemstone recommendations based on your complete birth chart analysis

curl -X GET 'https://api.astro-fusion.com/v1/recommendations/gemstones?date=1990-06-15T14:30:00Z&latitude=28.6139&longitude=77.2090&timezone=5.5' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Get Zodiac-Based Gemstones

GET /v1/recommendations/gemstones/zodiac/:sign Zodiac-based

Get gemstone recommendations based on sun sign/zodiac sign

curl -X GET 'https://api.astro-fusion.com/v1/recommendations/gemstones/zodiac/gemini' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Get Gemstone Details

GET /v1/recommendations/gemstones/info/:gemstone Reference

Get detailed information about a specific gemstone

curl -X GET 'https://api.astro-fusion.com/v1/recommendations/gemstones/info/ruby' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Personalized Recommendations Response

Complete Analysis Response

{
  "birthChart": {
    "sunSign": "Gemini",
    "moonSign": "Cancer",
    "ascendant": "Leo",
    "planetaryStrengths": {
      "strong": ["Mercury", "Venus"],
      "weak": ["Saturn", "Mars"],
      "afflicted": ["Jupiter"]
    }
  },
  "primaryGemstone": {
    "name": "Emerald",
    "planet": "Mercury",
    "reason": "Strengthens Mercury which is your ruling planet",
    "weight": "3-5 carats",
    "quality": "Natural, untreated",
    "certification": "GIA or equivalent"
  },
  "secondaryGemstones": [
    {
      "name": "Yellow Sapphire",
      "planet": "Jupiter",
      "reason": "Balances Jupiter which is afflicted in your chart",
      "priority": "High"
    },
    {
      "name": "Blue Sapphire",
      "planet": "Saturn",
      "reason": "Strengthens Saturn which is weak in your chart",
      "priority": "Medium"
    }
  ],
  "wearingInstructions": {
    "finger": "Little finger (left hand)",
    "day": "Wednesday",
    "time": "Morning (sunrise)",
    "mantra": "ॐ बुधाय नमः (Om Budhay Namah)",
    "prayer": "Pray to Lord Vishnu or Mercury before wearing"
  },
  "benefits": [
    "Enhanced communication skills",
    "Improved business success",
    "Better academic performance",
    "Stronger intuition"
  ],
  "precautions": [
    "Avoid wearing during sleep",
    "Remove during bathing or swimming",
    "Clean regularly with mild soap",
    "Avoid contact with chemicals"
  ],
  "alternativeGemstones": [
    {
      "name": "Peridot",
      "reason": "Affordable alternative to Emerald",
      "effectiveness": "70% of Emerald"
    }
  ]
}

Zodiac-Based Response

{
  "zodiacSign": "Gemini",
  "element": "Air",
  "rulingPlanet": "Mercury",
  "primaryGemstone": {
    "name": "Emerald",
    "planet": "Mercury",
    "properties": "Intelligence, communication, adaptability",
    "benefits": [
      "Enhanced communication skills",
      "Better learning ability",
      "Improved business acumen",
      "Stronger nervous system"
    ]
  },
  "supportingGemstones": [
    {
      "name": "Agate",
      "purpose": "Grounding and stability",
      "whenToUse": "During stressful periods"
    },
    {
      "name": "Aquamarine",
      "purpose": "Calming and clear thinking",
      "whenToUse": "For mental clarity"
    }
  ],
  "wearingGuide": {
    "bestDay": "Wednesday",
    "bestTime": "Morning",
    "finger": "Little finger",
    "metal": "Gold or silver",
    "mantra": "ॐ बुधाय नमः"
  }
}

Gemstone Wearing Guidelines

👐 Finger Selection

  • Thumb: For willpower and courage
  • Index: For leadership and ambition
  • Middle: For patience and wisdom
  • Ring: For creativity and relationships
  • Little: For communication and intellect

📅 Auspicious Days

  • Sunday: Ruby, Red Coral
  • Monday: Pearl, Moonstone
  • Tuesday: Red Coral, Cat's Eye
  • Wednesday: Emerald, Green Jade
  • Thursday: Yellow Sapphire, Citrine
  • Friday: Diamond, Amethyst
  • Saturday: Blue Sapphire, Lapis Lazuli

🕐 Auspicious Times

  • Sunrise: Most powerful time
  • Morning (6-12): Good for all gemstones
  • Afternoon: Avoid for hot gemstones
  • Evening: Good for cold gemstones
  • Night: Generally avoid wearing

🔧 Metal Selection

  • Gold: Enhances gemstone power
  • Silver: Good for most gemstones
  • Panchdhatu: Traditional five-metal alloy
  • Copper: For grounding (rarely used)

Mantras and Rituals

Ruby (Manik) Mantra

ॐ सूर्याय नमः
Om Suryay Namah

Chant 108 times before wearing

Pearl (Moti) Mantra

ॐ चंद्राय नमः
Om Chandray Namah

Chant during moonrise

Emerald (Panna) Mantra

ॐ बुधाय नमः
Om Budhay Namah

Chant 16,000 times for full activation

Diamond (Heera) Mantra

ॐ शुक्राय नमः
Om Shukray Namah

Chant 16,000 times

Gemstone Wearing Ceremony

  1. Purification: Clean the gemstone with Gangajal (holy water)
  2. Prana Pratishta: Energize with appropriate mantra chanting
  3. Wearing: Wear on auspicious day and time
  4. Activation: Keep in sunlight/moonlight for 24 hours
  5. Maintenance: Clean weekly and recharge monthly

JavaScript Integration Example

class GemstoneRecommender {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseURL = 'https://api.astro-fusion.com/v1';
  }

  async getPersonalizedRecommendations(birthData) {
    const params = new URLSearchParams({
      date: birthData.date,
      latitude: birthData.latitude,
      longitude: birthData.longitude,
      timezone: birthData.timezone || 5.5
    });

    const response = await fetch(\`\${this.baseURL}/recommendations/gemstones?\${params}\`, {
      headers: {
        'Authorization': \`Bearer \${this.apiKey}\`,
        'Content-Type': 'application/json'
      }
    });

    return await response.json();
  }

  async getZodiacGemstones(zodiacSign) {
    const response = await fetch(\`\${this.baseURL}/recommendations/gemstones/zodiac/\${zodiacSign}\`, {
      headers: {
        'Authorization': \`Bearer \${this.apiKey}\`,
        'Content-Type': 'application/json'
      }
    });

    return await response.json();
  }

  displayRecommendations(recommendations) {
    const container = document.getElementById('gemstone-results');

    const primaryGem = recommendations.primaryGemstone;
    const html = \`
      <div class="gemstone-result">
        <h3>Primary Gemstone: \${primaryGem.name}</h3>
        <p><strong>Planet:</strong> \${primaryGem.planet}</p>
        <p><strong>Reason:</strong> \${primaryGem.reason}</p>
        <p><strong>Weight:</strong> \${primaryGem.weight}</p>

        <h4>Wearing Instructions</h4>
        <ul>
          <li><strong>Finger:</strong> \${recommendations.wearingInstructions.finger}</li>
          <li><strong>Day:</strong> \${recommendations.wearingInstructions.day}</li>
          <li><strong>Time:</strong> \${recommendations.wearingInstructions.time}</li>
          <li><strong>Mantra:</strong> \${recommendations.wearingInstructions.mantra}</li>
        </ul>

        <h4>Benefits</h4>
        <ul>
          \${recommendations.benefits.map(benefit => \`<li>\${benefit}</li>\`).join('')}
        </ul>
      </div>
    \`;

    container.innerHTML = html;
  }
}

// Usage
const recommender = new GemstoneRecommender('YOUR_API_KEY');

// Get recommendations for a birth chart
const birthData = {
  date: '1990-06-15T14:30:00Z',
  latitude: 28.6139,
  longitude: 77.2090,
  timezone: 5.5
};

recommender.getPersonalizedRecommendations(birthData)
  .then(recommendations => {
    recommender.displayRecommendations(recommendations);
  })
  .catch(error => {
    console.error('Error getting recommendations:', error);
  });