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. 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

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

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

Reserved; product endpoints are not feature-gated by plan (quota differs by tier).

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

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

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": 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"
    ]
  }
}