Single crystal lookup

Lookup a specific crystal by slug or name (case-insensitive). Examples: 'amethyst', 'blue-sapphire', 'rose-quartz', 'Tiger's Eye'.

Endpoint

GET /v1/crystals/{name}

Request parameters

Field	Type	Required	Description
name	string	Yes

Example request

curl

curl -X GET "https://api.asterwise.com/v1/crystals/amethyst" \
  -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.crystal(name="amethyst")
    print(result)

TypeScript

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

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

const result = await crystal({
  client,
  path: {
      "name": "amethyst"
  },
});

console.log(result.data);

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "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…"
  }
}

Response fields

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

• Crystal recommendations
• Crystals by Vedic planet
• Complete crystal database
• Crystal recommendations from Vedic natal chart