Skip to main content

Crystal recommendations from Vedic natal chart

Recommend crystals based on gemstone house lordship rules. Computes the natal chart and identifies the planets that lord Trikona houses (1, 5, 9). Lagna lord = Life Stone (+5), Yogakaraka = supreme benefic (+5), 9th lord = Fortune Stone (+4), 5th lord = Lucky Stone (+3). Where a planet lords both a Trikona and a Dusthana (6, 8, 12), the Trikona Trikona lordship still prevails — the planet is still recommended. Planets not lordsing any Trikona house are contraindicated. Only crystals with classical Vedic assignments (Navaratna or Uparatna) are returned. Dangerous gem combinations are flagged in warnings[].

Endpoint

POST /v1/crystals/recommend/natal

Request parameters

FieldTypeRequiredDescription
locationstring | nullNoCity name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
namestringNoPerson name associated with the birth record
datestringYesBirth date in YYYY-MM-DD format
timestring | nullNoBirth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
latitudenumber | nullNoLatitude. Required if location not provided.
longitudenumber | nullNoLongitude. Required if location not provided.
timezonestring | nullNoIANA timezone. Required if location not provided.
ayanamsastringNoSidereal ayanamsa mode used in calculations
include_interpretationbooleanNoWhether to include planet-in-house interpretation layer

Example request

curl -X POST "https://api.asterwise.com/v1/crystals/recommend/natal" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai"}'

Example response

{
"success": true,
"message": "success",
"data": {
"natal_context": {
"lagna_sign": "Libra",
"lagna_lord": "Venus",
"fifth_sign": "Aquarius",
"fifth_lord": "Saturn",
"ninth_sign": "Gemini",
"ninth_lord": "Mercury",
"yogakaraka": "Saturn",
"contraindicated_lords": [
"Jupiter",
"Mars",
"... and 2 more items"
],
"ayanamsa": "lahiri"
},
"total": 5,
"crystals": [
{
"slug": "blue-sapphire",
"name": "Blue Sapphire",
"colors": [
"blue",
"navy",
"... and 1 more item"
],
"hardness_mohs": 9.0,
"chakras": [
"Third Eye",
"Throat"
],
"element": "Air",
"zodiac_signs": [
"Capricorn",
"Aquarius"
],
"vedic_planet": "Saturn",
"vedic_correspondence": "navaratna",
"western_planet": "Saturn",
"keywords": [
"discipline",
"focus",
"... and 3 more items"
],
"healing_physical": "Supports nervous system, bones, and endocrine function.",
"healing_emotional": "Brings severe discipline, mental focus, and rapid karmic restructuring.",
"healing_spiritual": "Neelam — primary Navaratna gemstone for Saturn. One of the most powerful and potentially volatile gems in Jyotish.",
"description": "Corundum variety second only to Diamond in hardness. The primary Saturn gemstone — one of the nine Navaratna. Extremely…",
"origins": [
"Sri Lanka",
"Kashmir",
"... and 2 more items"
],
"affirmation": "I embrace discipline and trust the wisdom of Saturn's timing.",
"caution": "CRITICAL: Blue Sapphire is the most volatile of the Navaratna. In Jyotish, it is said to bring sudden wealth or sudden r…",
"match_score": 5,
"match_reasons": [
"Yogakaraka (Saturn) — lords both Kendra and Trikona, supreme benefic"
],
"warnings": [
"CRITICAL: Blue Sapphire is the most volatile of the Navaratna. In Jyotish, it is said to bring sudden wealth or sudden r…"
]
},
{
"slug": "amethyst",
"name": "Amethyst",
"colors": [
"purple",
"violet"
],
"hardness_mohs": 7.0,
"chakras": [
"Third Eye",
"Crown"
],
"element": "Air",
"zodiac_signs": [
"Aquarius",
"Pisces"
],
"vedic_planet": "Saturn",
"vedic_correspondence": "uparatna",
"western_planet": "Jupiter",
"keywords": [
"protection",
"intuition",
"... and 3 more items"
],
"healing_physical": "Supports nervous system, headaches, insomnia, and hormonal balance.",
"healing_emotional": "Calms anxiety, reduces anger, promotes emotional centering.",
"healing_spiritual": "Opens Third Eye, enhances intuition, supports meditation and psychic protection.",
"description": "A violet variety of quartz revered across cultures for spiritual protection and mental clarity. Its purple hue ranges fr…",
"origins": [
"Brazil",
"Uruguay",
"... and 2 more items"
],
"affirmation": "I trust my intuition and am protected by divine light.",
"caution": "In Jyotish, deep purple Amethyst invokes Saturn's karmic energy. Consult a practitioner before wearing for astrological…",
"match_score": 4,
"match_reasons": [
"Yogakaraka (Saturn) — lords both Kendra and Trikona, supreme benefic"
],
"warnings": [
"In Jyotish, deep purple Amethyst invokes Saturn's karmic energy. Consult a practitioner before wearing for astrological…"
]
},
"... and 3 more items"
]
}
}

Response fields

FieldTypeDescription
successbooleanTrue if the request succeeded
messagestringHuman-readable status message
dataobject
data.natal_contextobject
data.natal_context.lagna_signstringAscendant sign (English).
data.natal_context.lagna_lordstringLord of the 1st house.
data.natal_context.fifth_signstring5th house sign (English).
data.natal_context.fifth_lordstringLord of the 5th house (Panchamesh — Lucky Stone).
data.natal_context.ninth_signstring9th house sign (English).
data.natal_context.ninth_lordstringLord of the 9th house (Bhagyesh — Fortune Stone).
data.natal_context.yogakarakastring | nullYogakaraka planet — lords both a non-1st Kendra and a non-1st Trikona. Null if none for this Lagna.
data.natal_context.contraindicated_lordsarray[string]Planets that do not lord any Trikona house — their gems are contraindicated.
data.natal_context.ayanamsastring
data.totalinteger
data.crystalsarray[object]
data.crystals[].slugstring
data.crystals[].namestring
data.crystals[].colorsarray[string]
data.crystals[].hardness_mohsnumber
data.crystals[].chakrasarray[string]
data.crystals[].elementstring
data.crystals[].zodiac_signsarray[string]
data.crystals[].vedic_planetstring | null
data.crystals[].vedic_correspondencestring
data.crystals[].western_planetstring | null
data.crystals[].keywordsarray[string]
data.crystals[].healing_physicalstring
data.crystals[].healing_emotionalstring
data.crystals[].healing_spiritualstring
data.crystals[].descriptionstring
data.crystals[].originsarray[string]
data.crystals[].affirmationstring
data.crystals[].cautionstring | null
data.crystals[].match_scoreintegerGemstone match score based on house lordship.
data.crystals[].match_reasonsarray[string]Classical factors — which house lordship triggered this recommendation.
data.crystals[].warningsarray[string]Classical cautions for this specific chart context.

Errors

CodeDescriptionReference
authentication_failedMissing or invalid API key.authentication_failed
ephemeris_unavailableUpstream ephemeris service error.ephemeris_unavailable
insufficient_tierAPI key tier does not include this endpoint.insufficient_tier
internal_errorUnexpected server error.internal_error
ip_rate_limit_exceededToo many requests in a short window.ip_rate_limit_exceeded
payload_too_largeRequest body exceeds the size limit.payload_too_large
resource_not_foundReferenced resource was not found.resource_not_found
validation_errorRequest body failed schema validation.validation_error