Skip to main content

Graha Nature

Returns classical graha properties for all nine planets or a single planet. Includes tattva, guna, gender, caste, direction, color, deity, ruling day, metal, body part governed, and naisargika maitri (natural friends, enemies, neutrals). Pass ?planet=Sun (or Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu) for a single planet. Omit ?planet to get all nine planets.

Endpoint

GET /v1/astro/planet-nature

Request parameters

FieldTypeRequiredDescription
planetstring | nullNo

Example request

curl -X GET "https://api.asterwise.com/v1/astro/planet-nature" \
-H "Authorization: Bearer YOUR_API_KEY"

Example response

{
"success": true,
"message": "success",
"data": {
"planets": {
"Sun": {
"tattva": "Agni (Fire)",
"guna": "Sattvic",
"gender": "Male",
"caste": "Kshatriya",
"nature": "Malefic",
"direction": "East",
"color": "Blood Red / Copper",
"deity": "Agni / Shiva",
"day": "Sunday",
"metal": "Copper / Gold",
"body_part": "Bones",
"friends": [
"Moon",
"Mars",
"... and 1 more item"
],
"enemies": [
"Venus",
"Saturn"
],
"neutrals": [
"Mercury"
]
},
"Moon": {
"tattva": "Jala (Water)",
"guna": "Sattvic",
"gender": "Female",
"caste": "Vaishya",
"nature": "Benefic when bright / Malefic when dark",
"direction": "North-West",
"color": "Tawny / White",
"deity": "Apas / Parvati",
"day": "Monday",
"metal": "Silver / Bell-metal",
"body_part": "Blood",
"friends": [
"Sun",
"Mercury"
],
"enemies": [],
"neutrals": [
"Mars",
"Jupiter",
"... and 2 more items"
]
},
"Mars": {
"tattva": "Agni (Fire)",
"guna": "Tamasic",
"gender": "Male",
"caste": "Kshatriya",
"nature": "Malefic",
"direction": "South",
"color": "Blood Red",
"deity": "Kartikeya",
"day": "Tuesday",
"metal": "Copper",
"body_part": "Marrow",
"friends": [
"Sun",
"Moon",
"... and 1 more item"
],
"enemies": [
"Mercury"
],
"neutrals": [
"Venus",
"Saturn"
]
},
"Mercury": {
"tattva": "Prithvi (Earth)",
"guna": "Rajasic",
"gender": "Neuter",
"caste": "Vaishya",
"nature": "Benefic (unless conjunct malefics)",
"direction": "North",
"color": "Green (Durva grass)",
"deity": "Vishnu",
"day": "Wednesday",
"metal": "Brass",
"body_part": "Skin",
"friends": [
"Sun",
"Venus"
],
"enemies": [
"Moon"
],
"neutrals": [
"Mars",
"Jupiter",
"... and 1 more item"
]
},
"Jupiter": {
"tattva": "Akasha (Ether)",
"guna": "Sattvic",
"gender": "Male",
"caste": "Brahmin",
"nature": "Benefic",
"direction": "North-East",
"color": "Tawny / Yellow",
"deity": "Indra / Brahma",
"day": "Thursday",
"metal": "Silver / Gold",
"body_part": "Fat",
"friends": [
"Sun",
"Moon",
"... and 1 more item"
],
"enemies": [
"Mercury",
"Venus"
],
"neutrals": [
"Saturn"
]
},
"Venus": {
"tattva": "Jala (Water)",
"guna": "Rajasic",
"gender": "Female",
"caste": "Brahmin",
"nature": "Benefic",
"direction": "South-East",
"color": "Variegated",
"deity": "Sachi / Lakshmi",
"day": "Friday",
"metal": "Silver",
"body_part": "Semen",
"friends": [
"Mercury",
"Saturn"
],
"enemies": [
"Sun",
"Moon"
],
"neutrals": [
"Mars",
"Jupiter"
]
},
"Saturn": {
"tattva": "Vayu (Air)",
"guna": "Tamasic",
"gender": "Neuter",
"caste": "Shudra",
"nature": "Malefic",
"direction": "West",
"color": "Dark / Black",
"deity": "Brahma / Yama",
"day": "Saturday",
"metal": "Iron",
"body_part": "Muscles / Nerves",
"friends": [
"Mercury",
"Venus"
],
"enemies": [
"Sun",
"Moon",
"... and 1 more item"
],
"neutrals": [
"Jupiter"
]
},
"Rahu": {
"tattva": null,
"guna": "Tamasic",
"gender": "Neuter",
"caste": "Outcaste",
"nature": "Malefic",
"direction": "South-West",
"color": "Smoky / Dark Blue",
"deity": "Durga / Sarpa",
"day": "Saturday",
"metal": "Lead / Ashtadhatu",
"body_part": "Detoxification pathways",
"friends": [
"Venus",
"Saturn"
],
"enemies": [
"Sun",
"Moon"
],
"neutrals": [
"Mars",
"Mercury",
"... and 1 more item"
]
},
"Ketu": {
"tattva": null,
"guna": "Tamasic",
"gender": "Neuter",
"caste": "Outcaste",
"nature": "Malefic",
"direction": "North-West",
"color": "Smoky / Grey",
"deity": "Ganesha / Chitragupta",
"day": "Tuesday",
"metal": "Lead / Iron",
"body_part": "Immune modulation",
"friends": [
"Mars",
"Venus"
],
"enemies": [
"Moon",
"Sun"
],
"neutrals": [
"Mercury",
"Jupiter",
"... and 1 more item"
]
}
}
}
}

Response fields

FieldTypeDescription
successbooleanTrue if the request succeeded
messagestringHuman-readable status message
dataPlanetNatureAllResponse | PlanetNatureSingleResponseThe endpoint response payload

Errors

CodeDescriptionReference
authentication_failedMissing or invalid API key.authentication_failed
ephemeris_unavailableUpstream ephemeris service error.ephemeris_unavailable
insufficient_tierAPI key tier does not include this endpoint.insufficient_tier
internal_errorUnexpected server error.internal_error
ip_rate_limit_exceededToo many requests in a short window.ip_rate_limit_exceeded
payload_too_largeRequest body exceeds the size limit.payload_too_large
resource_not_foundReferenced resource was not found.resource_not_found
validation_errorRequest body failed schema validation.validation_error