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

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, each group alphabetically. Only Navaratna and Uparatna Vedic assignments are included — crystals without classical Vedic gemstone support are not returned here.

Request parameters

planetrequired

string

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

GET /v1/crystals/by-planet/{planet}: one planet's gems, not the catalogue.

data.total

integer

Number of crystals assigned to the planet (the length of crystals).

data.crystals

array[object]

Crystals whose Vedic planet is the requested planet: Navaratna (primary gem) first, then Uparatna (substitutes), each group sorted alphabetically by name.

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 planet: the planet of a navaratna gem, or the planet an uparatna substitutes for. Null if the stone has no Vedic gem use.

data.crystals[].vedic_correspondence

string

'navaratna' (primary classical gem, Phaladeepika table), 'uparatna' (substitute gem — includes common modern substitutes such as Tiger's Eye for Ketu; the description says when a substitute is not classical), or 'none_classical' (no Vedic gem use).

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

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Single crystal lookup
• Crystal recommendations
• Complete crystal database
• Natal Chart Crystal Recommendations

Request

GET·application/json

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);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "total": 4,
    "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 2 more items"
    ]
  }
}