astro_dignities
Planetary dignity assessments (essential, accidental, almuten, hyleg, receptions).
- Layer: compute
- Methods: essential, accidental, almuten, hyleg, mutual-receptions
- Free tier: essential, accidental
- Paid tier: almuten, hyleg, mutual-receptions
Description
Planetary dignity assessments (essential, accidental, almuten, hyleg, receptions).
Methods:
essential [Free] — Essential dignities: domicile, exaltation, triplicity, term, face, detriment, fall, peregrine.
accidental [Free] — Accidental dignities: house placement, motion, speed, and Sun-proximity conditions.
almuten [Paid] — Scheme-based almuten (essence) computation from the five classical dignities.
hyleg [Paid] — Life-ruler computation across Ptolemaic, Dorothean, and luminary schemes.
mutual-receptions [Paid] — Mutual receptions between planets by domicile or exaltation.
Input schema
essential
| Field | Type | Required | Constraints |
|---|---|---|---|
| birthData.year | integer | yes | min -4000, max 4000, int |
| birthData.month | integer | yes | min 1, max 12, int |
| birthData.day | integer | yes | min 1, max 31, int |
| birthData.hour | integer | yes | min 0, max 23, int |
| birthData.minute | integer | yes | min 0, max 59, int |
| birthData.second | integer | no | min 0, max 59, int |
| birthData.latitude | number | yes | min -90, max 90 |
| birthData.longitude | number | yes | min -180, max 180 |
| birthData.timezone | number | yes | min -12, max 14 |
| birthData.unknownTime | boolean | no | — |
| scheme | "ptolemaic" | "egyptian" | no | — |
Example request
{
"method": "essential",
"birthData": {
"year": 1990,
"month": 1,
"day": 1,
"hour": 12,
"minute": 0,
"latitude": 51.5074,
"longitude": -0.1278,
"timezone": 0
}
}
Example response (captured; long values elided)
{
"isDayChart": true,
"scheme": "ptolemaic",
"planets": [
{
"planet": "Sun",
"longitude": 280.814265,
"sign": "Capricorn",
"score": -5,
"dignities": {
"domicile": false,
"exaltation": false,
"triplicity": false,
"term": false,
"face": false,
"detriment": false,
"fall": false,
"peregrine": true
}
},
{
"planet": "Moon",
"longitude": 333.267706,
"sign": "Pisces",
"score": -5,
"dignities": {
"domicile": false,
"exaltation": false,
"triplicity": false,
"term": false,
"face": false,
"detriment": false,
"fall": false,
"peregrine": true
}
},
{
"planet": "Mercury",
"longitude": 295.672824,
"sign": "Capricorn",
"score": -5,
"dignities": {
"domicile": false,
"exaltation": false,
"triplicity": false,
"term": false,
"face": false,
"detriment": false,
"fall": false,
"peregrine": true
}
},
{
"planet": "Venus",
"longitude": 306.22196,
"sign": "Aquarius",
"score": 1,
"dignities": {
"domicile": false,
"exaltation": false,
"triplicity": false,
"term": false,
"face": true,
"detriment": false,
"fall": false,
"peregrine": false
}
},
{
"planet": "Mars",
"longitude": 250.000088,
"sign": "Sagittarius",
"score": -5,
"dignities": {
"domicile": false,
"exaltation": false,
"triplicity": false,
"term": false,
"face": false,
"detriment": false,
"fall": false,
"peregrine": true
}
},
{
"planet": "Jupiter",
"longitude": 95.148793,
"sign": "Cancer",
"score": 4,
"dignities": {
"domicile": false,
"exaltation": true,
"triplicity": false,
"term": false,
"face": false,
"detriment": false,
"fall": false,
"peregrine": false
}
},
{
"planet": "Saturn",
"longitude": 285.657499,
"sign": "Capricorn",
"score": 5,
"dignities": {
"domicile": true,
"exaltation": false,
"triplicity": false,
"term": false,
"face": false,
"detriment": false,
"fall": false,
"peregrine": false
}
},
{
"planet": "Uranus",
"longitude": 275.785441,
"sign": "Capricorn",
"score": -5,
"dignities": {
"domicile": false,
"exaltation": false,
"triplicity": false,
"term": false,
"face": false,
"detriment": false,
"fall": false,
"peregrine": true
}
},
"… 2 more items"
]
}
accidental
| Field | Type | Required | Constraints |
|---|---|---|---|
| birthData.year | integer | yes | min -4000, max 4000, int |
| birthData.month | integer | yes | min 1, max 12, int |
| birthData.day | integer | yes | min 1, max 31, int |
| birthData.hour | integer | yes | min 0, max 23, int |
| birthData.minute | integer | yes | min 0, max 59, int |
| birthData.second | integer | no | min 0, max 59, int |
| birthData.latitude | number | yes | min -90, max 90 |
| birthData.longitude | number | yes | min -180, max 180 |
| birthData.timezone | number | yes | min -12, max 14 |
| birthData.unknownTime | boolean | no | — |
Example request
{
"method": "accidental",
"birthData": {
"year": 1990,
"month": 1,
"day": 1,
"hour": 12,
"minute": 0,
"latitude": 51.5074,
"longitude": -0.1278,
"timezone": 0
}
}
Example response (captured; long values elided)
{
"planets": [
{
"planet": "Sun",
"house": 10,
"score": 5,
"factors": {
"housePoints": 5,
"retrograde": false,
"direct": false,
"swift": false,
"slow": false,
"cazimi": false,
"combust": false,
"underBeams": false,
"free": false
}
},
{
"planet": "Moon",
"house": 12,
"score": 2,
"factors": {
"housePoints": -5,
"retrograde": false,
"direct": false,
"swift": true,
"slow": false,
"cazimi": false,
"combust": false,
"underBeams": false,
"free": true
}
},
{
"planet": "Mercury",
"house": 10,
"score": -6,
"factors": {
"housePoints": 5,
"retrograde": true,
"direct": false,
"swift": false,
"slow": true,
"cazimi": false,
"combust": false,
"underBeams": true,
"free": false
}
},
{
"planet": "Venus",
"house": 11,
"score": 2,
"factors": {
"housePoints": 4,
"retrograde": true,
"direct": false,
"swift": false,
"slow": true,
"cazimi": false,
"combust": false,
"underBeams": false,
"free": true
}
},
{
"planet": "Mars",
"house": 8,
"score": 9,
"factors": {
"housePoints": -2,
"retrograde": false,
"direct": true,
"swift": true,
"slow": false,
"cazimi": false,
"combust": false,
"underBeams": false,
"free": true
}
},
{
"planet": "Jupiter",
"house": 3,
"score": 3,
"factors": {
"housePoints": 1,
"retrograde": true,
"direct": false,
"swift": true,
"slow": false,
"cazimi": false,
"combust": false,
"underBeams": false,
"free": true
}
},
{
"planet": "Saturn",
"house": 10,
"score": 6,
"factors": {
"housePoints": 5,
"retrograde": false,
"direct": true,
"swift": true,
"slow": false,
"cazimi": false,
"combust": true,
"underBeams": false,
"free": false
}
},
{
"planet": "Uranus",
"house": 9,
"score": 3,
"factors": {
"housePoints": 2,
"retrograde": false,
"direct": true,
"swift": true,
"slow": false,
"cazimi": false,
"combust": true,
"underBeams": false,
"free": false
}
},
"… 2 more items"
]
}
almuten
| Field | Type | Required | Constraints |
|---|---|---|---|
| birthData.year | integer | yes | min -4000, max 4000, int |
| birthData.month | integer | yes | min 1, max 12, int |
| birthData.day | integer | yes | min 1, max 31, int |
| birthData.hour | integer | yes | min 0, max 23, int |
| birthData.minute | integer | yes | min 0, max 59, int |
| birthData.second | integer | no | min 0, max 59, int |
| birthData.latitude | number | yes | min -90, max 90 |
| birthData.longitude | number | yes | min -180, max 180 |
| birthData.timezone | number | yes | min -12, max 14 |
| birthData.unknownTime | boolean | no | — |
Example request
{
"method": "almuten",
"birthData": {
"year": 1990,
"month": 1,
"day": 1,
"hour": 12,
"minute": 0,
"latitude": 51.5074,
"longitude": -0.1278,
"timezone": 0
}
}
Example response (captured; long values elided)
{
"almuten": "Mars",
"isDayChart": true,
"scores": [
{
"planet": "Mars",
"score": 15
},
{
"planet": "Venus",
"score": 13
},
{
"planet": "Saturn",
"score": 9
},
{
"planet": "Jupiter",
"score": 7
},
{
"planet": "Sun",
"score": 7
},
{
"planet": "Mercury",
"score": 5
},
{
"planet": "Moon",
"score": 0
}
]
}
hyleg
| Field | Type | Required | Constraints |
|---|---|---|---|
| birthData.year | integer | yes | min -4000, max 4000, int |
| birthData.month | integer | yes | min 1, max 12, int |
| birthData.day | integer | yes | min 1, max 31, int |
| birthData.hour | integer | yes | min 0, max 23, int |
| birthData.minute | integer | yes | min 0, max 59, int |
| birthData.second | integer | no | min 0, max 59, int |
| birthData.latitude | number | yes | min -90, max 90 |
| birthData.longitude | number | yes | min -180, max 180 |
| birthData.timezone | number | yes | min -12, max 14 |
| birthData.unknownTime | boolean | no | — |
| scheme | "ptolemy" | "dorotheus" | "luminary" | no | — |
Example request
{
"method": "hyleg",
"birthData": {
"year": 1990,
"month": 1,
"day": 1,
"hour": 12,
"minute": 0,
"latitude": 51.5074,
"longitude": -0.1278,
"timezone": 0
}
}
Example response (captured; long values elided)
{
"scheme": "ptolemy",
"isDayChart": true,
"hyleg": {
"point": "Sun",
"longitude": 280.814265,
"house": 10,
"inAphesis": true,
"witnesses": [
{
"ruler": "Saturn",
"dignity": "domicile",
"aspect": "conjunction",
"orb": 4.843234
},
{
"ruler": "Jupiter",
"dignity": "term",
"aspect": "opposition",
"orb": 5.665471
}
],
"qualified": true
},
"candidates": [
{
"point": "Sun",
"longitude": 280.814265,
"house": 10,
"inAphesis": true,
"witnesses": [
{
"ruler": "Saturn",
"dignity": "domicile",
"aspect": "conjunction",
"orb": 4.843234
},
{
"ruler": "Jupiter",
"dignity": "term",
"aspect": "opposition",
"orb": 5.665471
}
],
"qualified": true
},
{
"point": "Moon",
"longitude": 333.267706,
"house": 12,
"inAphesis": false,
"witnesses": [
{
"ruler": "Jupiter",
"dignity": "domicile",
"aspect": "trine",
"orb": 1.881088
}
],
"qualified": false
},
{
"point": "Syzygy",
"longitude": 276.367694,
"house": 9,
"inAphesis": true,
"witnesses": [
{
"ruler": "Jupiter",
"dignity": "face",
"aspect": "opposition",
"orb": 1.2189
}
],
"qualified": true
},
{
"point": "Fortune",
"longitude": 77.400454,
"house": 2,
"inAphesis": false,
"witnesses": [
{
"ruler": "Mars",
"dignity": "term",
"aspect": "opposition",
"orb": 7.400366
}
],
"qualified": false
},
{
"point": "ASC",
"longitude": 24.947013,
"house": 1,
"inAphesis": true,
"witnesses": [],
"qualified": false
}
],
"syzygy": {
"jdUT": 2447888.638604,
"longitude": 276.367694,
"type": "full"
}
}
mutual-receptions
| Field | Type | Required | Constraints |
|---|---|---|---|
| birthData.year | integer | yes | min -4000, max 4000, int |
| birthData.month | integer | yes | min 1, max 12, int |
| birthData.day | integer | yes | min 1, max 31, int |
| birthData.hour | integer | yes | min 0, max 23, int |
| birthData.minute | integer | yes | min 0, max 59, int |
| birthData.second | integer | no | min 0, max 59, int |
| birthData.latitude | number | yes | min -90, max 90 |
| birthData.longitude | number | yes | min -180, max 180 |
| birthData.timezone | number | yes | min -12, max 14 |
| birthData.unknownTime | boolean | no | — |
Example request
{
"method": "mutual-receptions",
"birthData": {
"year": 1990,
"month": 1,
"day": 1,
"hour": 12,
"minute": 0,
"latitude": 51.5074,
"longitude": -0.1278,
"timezone": 0
}
}
Example response (captured; long values elided)
{
"receptions": [
{
"planetA": "Moon",
"planetB": "Jupiter",
"kind": "domicile"
}
]
}