POST/v1/crystals/recommend/natal

Crystal recommendations from Vedic natal chart

Recommend crystals based on gemstone house lordship rules. Computes the natal chart and identifies the planets that lord Trikona houses (1, 5, 9). Lagna lord = Life Stone (+5), Yogakaraka = supreme benefic (+5), 9th lord = Fortune Stone (+4), 5th lord = Lucky Stone (+3). Where a planet lords both a Trikona and a Dusthana (6, 8, 12), the Trikona Trikona lordship still prevails — the planet is still recommended. Planets not lordsing any Trikona house are contraindicated. Only crystals with classical Vedic assignments (Navaratna or Uparatna) are returned. Dangerous gem combinations are flagged in warnings[].

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

include_interpretationoptional

boolean

Whether to include planet-in-house interpretation layer

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.natal_context

object

data.natal_context.lagna_sign

string

Ascendant sign (English).

data.natal_context.lagna_lord

string

Lord of the 1st house.

data.natal_context.fifth_sign

string

5th house sign (English).

data.natal_context.fifth_lord

string

Lord of the 5th house (Panchamesh — Lucky Stone).

data.natal_context.ninth_sign

string

9th house sign (English).

data.natal_context.ninth_lord

string

Lord of the 9th house (Bhagyesh — Fortune Stone).

data.natal_context.yogakaraka

string | null

Yogakaraka planet — lords both a non-1st Kendra and a non-1st Trikona. Null if none for this Lagna.

data.natal_context.contraindicated_lords

array[string]

Planets that do not lord any Trikona house — their gems are contraindicated.

data.natal_context.ayanamsa

string

data.total

integer

data.crystals

array[object]

data.crystals[].slug

string

data.crystals[].name

string

data.crystals[].colors

array[string]

data.crystals[].hardness_mohs

number

data.crystals[].chakras

array[string]

data.crystals[].element

string

data.crystals[].zodiac_signs

array[string]

data.crystals[].vedic_planet

string | null

data.crystals[].vedic_correspondence

string

data.crystals[].western_planet

string | null

data.crystals[].keywords

array[string]

data.crystals[].healing_physical

string

data.crystals[].healing_emotional

string

data.crystals[].healing_spiritual

string

data.crystals[].description

string

data.crystals[].origins

array[string]

data.crystals[].affirmation

string

data.crystals[].caution

string | null

data.crystals[].match_score

integer

Gemstone match score based on house lordship.

data.crystals[].match_reasons

array[string]

Classical factors — which house lordship triggered this recommendation.

data.crystals[].warnings

array[string]

Classical cautions for this specific chart context.

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

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
• Crystals by Vedic planet
• Complete crystal database

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/crystals/recommend/natal" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","location":"Mumbai"}'

Python

import asterwise
from asterwise.api.crystals_api import CrystalsApi
from asterwise.models.natal_request import NatalRequest

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

request = NatalRequest(
    name="Arjun Mehta",
    date="1985-11-12",
    time="06:45",
    location="Mumbai",
)

with asterwise.ApiClient(configuration) as client:
    api = CrystalsApi(client)
    result = api.crystals_recommend_natal(natal_request=request)
    print(result)

TypeScript

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

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

const result = await crystalsRecommendNatal({
  client,
  body: {
      "name": "Arjun Mehta",
      "date": "1985-11-12",
      "time": "06:45",
      "location": "Mumbai"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "natal_context": {
      "lagna_sign": "Libra",
      "lagna_lord": "Venus",
      "fifth_sign": "Aquarius",
      "fifth_lord": "Saturn",
      "ninth_sign": "Gemini",
      "ninth_lord": "Mercury",
      "yogakaraka": "Saturn",
      "contraindicated_lords": [
        "Jupiter",
        "Mars",
        "... and 2 more items"
      ],
      "ayanamsa": "lahiri"
    },
    "total": 5,
    "crystals": [
      {
        "slug": "blue-sapphire",
        "name": "Blue Sapphire",
        "colors": [
          "blue",
          "navy",
          "... and 1 more item"
        ],
        "hardness_mohs": 9.0,
        "chakras": [
          "Third Eye",
          "Throat"
        ],
        "element": "Air",
        "zodiac_signs": [
          "Capricorn",
          "Aquarius"
        ],
        "vedic_planet": "Saturn",
        "vedic_correspondence": "navaratna",
        "western_planet": "Saturn",
        "keywords": [
          "discipline",
          "focus",
          "... and 3 more items"
        ],
        "healing_physical": "Supports nervous system, bones, and endocrine function.",
        "healing_emotional": "Brings severe discipline, mental focus, and rapid karmic restructuring.",
        "healing_spiritual": "Neelam — primary Navaratna gemstone for Saturn. One of the most powerful and potentially volatile gems in Jyotish.",
        "description": "Corundum variety second only to Diamond in hardness. The primary Saturn gemstone — one of the nine Navaratna. Extremely…",
        "origins": [
          "Sri Lanka",
          "Kashmir",
          "... and 2 more items"
        ],
        "affirmation": "I embrace discipline and trust the wisdom of Saturn's timing.",
        "caution": "CRITICAL: Blue Sapphire is the most volatile of the Navaratna. In Jyotish, it is said to bring sudden wealth or sudden r…",
        "match_score": 5,
        "match_reasons": [
          "Yogakaraka (Saturn) — lords both Kendra and Trikona, supreme benefic"
        ],
        "warnings": [
          "CRITICAL: Blue Sapphire is the most volatile of the Navaratna. In Jyotish, it is said to bring sudden wealth or sudden r…"
        ]
      },
      {
        "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…",
        "match_score": 4,
        "match_reasons": [
          "Yogakaraka (Saturn) — lords both Kendra and Trikona, supreme benefic"
        ],
        "warnings": [
          "In Jyotish, deep purple Amethyst invokes Saturn's karmic energy. Consult a practitioner before wearing for astrological…"
        ]
      },
      "... and 3 more items"
    ]
  }
}