Skip to main content

Crystals by Vedic planet

Returns all crystals associated with a specific Vedic planet. Planets: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu. Results are sorted with primary Navaratna gems first, then Uparatna substitutes. Only Navaratna and Uparatna Vedic assignments are included — crystals without classical Vedic gemstone support are not returned here.

Endpoint

GET /v1/crystals/by-planet/{planet}

Request parameters

FieldTypeRequiredDescription
planetstringYes

Example request

curl -X GET "https://api.asterwise.com/v1/crystals/by-planet/sun" \
-H "Authorization: Bearer YOUR_API_KEY"

Example response

{
"success": true,
"message": "success",
"data": {
"total": 3,
"crystals": [
{
"slug": "ruby",
"name": "Ruby",
"colors": [
"red",
"deep red",
"... and 1 more item"
],
"hardness_mohs": 9.0,
"chakras": [
"Root",
"Heart"
],
"element": "Fire",
"zodiac_signs": [
"Leo",
"Aries"
],
"vedic_planet": "Sun",
"vedic_correspondence": "navaratna",
"western_planet": "Sun",
"keywords": [
"leadership",
"vitality",
"... and 3 more items"
],
"healing_physical": "Supports heart, blood, and adrenal function.",
"healing_emotional": "Cultivates leadership, authority, radiant vitality, and immense self-confidence.",
"healing_spiritual": "Manikya — the primary Navaratna gemstone for the Sun. Activates solar energy and kingly qualities.",
"description": "Red corundum — the King of Gemstones. Manikya is the primary Sun gemstone in the classical nine Navaratna of Vedic tradi…",
"origins": [
"Burma (Myanmar)",
"Sri Lanka",
"... and 2 more items"
],
"affirmation": "I lead with confidence and my inner light shines brilliantly.",
"caution": "Wear only on qualified Jyotish recommendation. Strengthens the Sun — not suitable for those with malefic Sun placements…"
},
{
"slug": "garnet",
"name": "Garnet",
"colors": [
"deep red",
"crimson",
"... and 1 more item"
],
"hardness_mohs": 7.5,
"chakras": [
"Root"
],
"element": "Fire",
"zodiac_signs": [
"Capricorn",
"Aquarius"
],
"vedic_planet": "Sun",
"vedic_correspondence": "uparatna",
"western_planet": "Mars",
"keywords": [
"vitality",
"passion",
"... and 3 more items"
],
"healing_physical": "Revitalises the physical body and supports blood and circulation.",
"healing_emotional": "Stimulates the survival instinct and grounds spiritual energy into physical reality.",
"healing_spiritual": "Red Almandine/Pyrope Garnet is used as an affordable Ruby substitute (Sun) in Jyotish. Note: Hessonite Garnet is a separ…",
"description": "Red silicate mineral. Widely used as a Ruby substitute (Sun) in Jyotish. Distinct from Hessonite Garnet which is the Nav…",
"origins": [
"India",
"Sri Lanka",
"... and 2 more items"
],
"affirmation": "My life force is strong and I am rooted in my purpose.",
"caution": "Do not confuse with Hessonite (Gomed) which is a different variety used for Rahu, not Sun."
},
"... and 1 more item"
]
}
}

Response fields

FieldTypeDescription
successbooleanTrue if the request succeeded
messagestringHuman-readable status message
dataobject
data.totalintegerTotal number of crystals in the database.
data.crystalsarray[object]All crystals sorted alphabetically.
data.crystals[].slugstringURL-safe identifier, e.g. 'amethyst', 'blue-sapphire'.
data.crystals[].namestringDisplay name of the crystal.
data.crystals[].colorsarray[string]Primary colours of this crystal.
data.crystals[].hardness_mohsnumberHardness on the Mohs scale (1-10).
data.crystals[].chakrasarray[string]Associated chakras.
data.crystals[].elementstringClassical element: Earth, Water, Fire, Air, or All.
data.crystals[].zodiac_signsarray[string]Associated Western zodiac signs.
data.crystals[].vedic_planetstring | nullVedic planetary correspondence. Null if no classical Vedic text assigns this stone.
data.crystals[].vedic_correspondencestring'navaratna' (primary classical gem), 'uparatna' (substitute gem), or 'none_classical' (no Vedic text assigns this stone).
data.crystals[].western_planetstring | nullWestern metaphysical planetary correspondence.
data.crystals[].keywordsarray[string]Primary energy keywords.
data.crystals[].healing_physicalstringPhysical healing properties.
data.crystals[].healing_emotionalstringEmotional healing properties.
data.crystals[].healing_spiritualstringSpiritual healing properties.
data.crystals[].descriptionstringOverview description.
data.crystals[].originsarray[string]Primary geographic origins.
data.crystals[].affirmationstringAffirmation for working with this crystal.
data.crystals[].cautionstring | nullImportant safety or usage cautions. Null if none.

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