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

Field	Type	Required	Description
planet	string	Yes

Example request

curl

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

Python

import asterwise
from asterwise.api.crystals_api import CrystalsApi

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

with asterwise.ApiClient(configuration) as client:
    api = CrystalsApi(client)
    result = api.crystals_by_planet(planet="sun")
    print(result)

TypeScript

import { createClient, createConfig, crystalsByPlanet } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await crystalsByPlanet({
  client,
  path: {
      "planet": "sun"
  },
});

console.log(result.data);

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

Field	Type	Description
success	boolean	True if the request succeeded
message	string	Human-readable status message
data	object
data.total	integer	Total number of crystals in the database.
data.crystals	array[object]	All crystals sorted alphabetically.
data.crystals[].slug	string	URL-safe identifier, e.g. 'amethyst', 'blue-sapphire'.
data.crystals[].name	string	Display name of the crystal.
data.crystals[].colors	array[string]	Primary colours of this crystal.
data.crystals[].hardness_mohs	number	Hardness on the Mohs scale (1-10).
data.crystals[].chakras	array[string]	Associated chakras.
data.crystals[].element	string	Classical element: Earth, Water, Fire, Air, or All.
data.crystals[].zodiac_signs	array[string]	Associated Western zodiac signs.
data.crystals[].vedic_planet	string | null	Vedic planetary correspondence. Null if no classical Vedic text assigns this stone.
data.crystals[].vedic_correspondence	string	'navaratna' (primary classical gem), 'uparatna' (substitute gem), or 'none_classical' (no Vedic text assigns this stone).
data.crystals[].western_planet	string | null	Western metaphysical planetary correspondence.
data.crystals[].keywords	array[string]	Primary energy keywords.
data.crystals[].healing_physical	string	Physical healing properties.
data.crystals[].healing_emotional	string	Emotional healing properties.
data.crystals[].healing_spiritual	string	Spiritual healing properties.
data.crystals[].description	string	Overview description.
data.crystals[].origins	array[string]	Primary geographic origins.
data.crystals[].affirmation	string	Affirmation for working with this crystal.
data.crystals[].caution	string | null	Important safety or usage cautions. Null if none.

Errors

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

Related endpoints

• Single crystal lookup
• Crystal recommendations
• Complete crystal database
• Crystal recommendations from Vedic natal chart