GET/v1/crystals/{name}

Single crystal lookup

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

Request parameters

namerequired

string

Response fields

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

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

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

Request

GET·application/json

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

Response

200 OK·application/jsonsigned

{
  "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…"
  }
}