Horary Chart Data#
/api/astro/horary/
Use this endpoint to get data to cast and analyse the horary charts in your front-end application. The access levels for this endpoint are 0, 1 and 2 (see access levels).
Request#
Method POST
| Value | Type | Required | Comment |
|---|---|---|---|
| year | int | yes | In range 1950..2100 |
| month | int | yes | 1..12 |
| day | int | yes | |
| hour | int | yes | |
| minute | int | yes | |
| second | int | no | |
| tz | float | yes | Timezone (UTC offset in hours), f.e. -3.5 means minus 3hrs and 30 minutes latitutes |
| ln_d | int | yes | Longitude degrees 0..180 |
| ln_m | int | yes | Longitude minutes 0..59 |
| dir_ln | str | yes | east-west direction. Can be e or w |
| lt_d | int | yes | Latitude degrees 0..90 |
| lt_m | int | yes | Latitude minutes 0..59 |
| dir_lt | str | yes | north-south direction. Can be n or s |
| fortune | str | no | 0 to use reversed PoF, 1 to use a day-only formula. Default is 1 |
| q | str | no | horary question string (max 70 symbols) |
| transit | boolean | no | See note below |
Note: if transit set to true, a limited portion of data is provided for the transit chart visualization, namely chart_data, coords, on_screen and planetary_speeds (see below)
Response#
This endpoint returns a rather long list of various data, so we will break it down into the logical blocks below.
Coordinates#
- Key:
coords. - Access levels:
0,1,2
This part presents the coordinates of celestial objects in the following form:
"planets": [
{
"name": "Sun",
"ecliptical": { "lon": 125.365, "lat": 0.0 },
"horizontal": { "azm": 128.403, "alt": -3.8 }
}
// ... The same for other 6 planets
],
"cusps": [
{
"name": 1,
"ecliptical": { "lon": 125.365, "lat": 0.0 },
"horizontal": { "lon": 340.209, "lat": 0 }
// ... The same for other 2..12 cusps
}
],
"nodes": [
{
"name": "North Node",
"ecliptical": { "lon": 125.365, "lat": 0.0 },
"horizontal": { "azm": 128.403, "alt": -3.8 }
}
// ... The same for S. Node. Coordinates are given for True Nodes
],
"stars": [
{
"name": "Alcyone",
"ecliptical": { "lon": 60.31, "lat": 4.05},
"horizontal": { "azm": 128.403, "alt": -3.8 }
}
// ... The same for other stars
],
"parts": [
{
"name": "Pars of Fortune",
"ecliptical": { "lon": 60.31, "lat": 4.05},
"horizontal": { "azm": 128.403, "alt": -3.8 }
}
// ... The same for other parts
],
"antis": [
{
"name": "Sun",
"ecliptical": { "lon": 51.14, "lat": 0 },
"horizontal": { "azm": 128.403, "alt": -3.8 }
}
// ... The same for other planets
]
Planetary Speeds#
Key planetary_speeds
This part represents the current speeds of the planets:
[
{
"name": "Sun",
"speed": {
"in_lon": 1.0058326303364813,
"in_lat": -0.000024446217625552297,
"percent": 102.0480870229323, // Deviation from the average speed in longitude
"rate": "Average", // Can be Fast, or Slow
"direction": "D" // D-direct, R-Retrograde, S-Stationary
}
},
// The same for other 6 planets
]
Positions in a House#
- Key:
pos_in_house - Access levels:
0,1,2
This part presents the position of planets and Pars of Fortune (PoF) in astrological houses in the following form:
/**
* position of a planet|PoF in a specific house,
* and distances from adjacent cusps on ecliptic.
*/
"ecliptical": [
{
"name": "Sun",
"in_house": 6, // House numbers are 1..12
"from_cusp": 50.65, // degrees
"to_next_cusp": 106.73
}
// The same for other 6 planets and PoF
],
/**
* position of a planet or PoF in a specific spacial area
* between house dividers, and distances to the house
* dividers, measured along a declination circle of
* a planet. It can be null in extreme latitudes
* in Placidus house system, if planet falls into
* the area of never ascending point, where the
* Placidus system doesn't exists.
*/
"mundane": [
{
"name": "Sun",
"in_house": 6, // House numbers are 1..12
"from_cusp": 50.65, // degrees
"to_next_cusp": 106.73
}
// The same for other 6 planets and PoF
]
Screen Display Positions#
- Key:
on_screen - Access levels:
0,1,2
This part represents the data for displaying cusps and planets on the chart. For example, the ASC has an angle of 0 degrees on the screen, the 7th house is displayed in 180 degrees.
There are two display styles for the cusp and planets. The modern style assumes that the cusps are drawn with their actual widths. For example, if the distance between the ASC and the 2nd house cusp is 58 degrees, then the 2nd house should be displayed at 58 degrees on the chart's circle.
In the traditional style, houses are displayed equal. Accordingly, the displayed positions of the planets in the houses is adjusted.
Because plant glyphs can intersect each other, this endpoint returns two kinds of angles - the planet's true center and its corrected position.
"modern_style": {
"cusps": [
{
"name": 11,
"angle": 159.35
}
// The same for other houses
],
"in_circle": [
{
"name": "Venus",
"angle_of_center": 229.45,
"angle_corrected": 229.24
}
// The same for other planets, True Nodes and Pars of Fortune
]
},
"trad_style": {
"cusps": [
{
"name": 2,
"angle": 60.0
}
// The same for other houses
],
"in_circle": [
{
"name": "Venus",
"angle_of_center": 219.05,
"angle_corrected": 217.78
}
// The same for other planets, True Nodes and Pars of Fortune
]
},
"on_ruler": [ // if you display a ruler with planets beneath the chart
{
"name": "Jupiter",
"x_center": 1.87,
"x_corrected": 1.87
}
// The same for other planets
]
Receptions#
- Key:
receptions - Access levels:
0,1,2
This part represents receptions of the planets. It uses W. Lilly's table of receptions:
[
{
"name": "Sun",
"by_rulership": "Venus",
"by_exaltation": "Saturn",
"by_triplicity": "Mercury",
"by_fall": "Sun",
"by_detriment": "Mars",
"by_term": "Jupiter",
"by_face": "Saturn"
}
// Tha same for other 6 planets
]
Planetary Hours#
- Key:
planetary_hours - Access levels:
0,1,2
This section provides the list of planetary hours, sunrise & sunset time, and the current planetary hour. The sunrise and sunset are calculated for the temperature of 15 degrees
[
{
"hour": 1,
"ruler": "Sun",
"start": "06 Aug, 05:43:21",
"end": "06 Aug, 07:01:55",
"note": "Sunrise" // Note field is not empty for Sunrise and sunset hours
},
{
"hour": 2,
"ruler": "Venus",
"start": "06 Aug, 07:01:55",
"end": "06 Aug, 08:20:30"
},
// ...
{
"hour": 5,
"ruler": "Saturn",
"start": "06 Aug, 10:57:40",
"end": "06 Aug, 12:16:15",
"is_current": true // This field is not emtry for the current planetary hour
}
// ...
]
Aspects with Antiscia#
- Key:
antis_apects - Access levels:
1,2
This section contains the list of all possible conjunction and oppositions of planetary antiscia with planets and cusps. As usual aspects assume that sign of antiscia and aspecting body behold each other and the distance in aspect is no more than 3 degrees. If there is no close conjuction/opposition between the planets/cusps and antiscia, they are not displayed in the list.
[
{
"antis": "Mercury",
"cusp": 1,
"aspect": 180,
"distance": 1.30
},
{
"antis": "Mercury",
"cusp": 7,
"aspect": 0,
"distance": 1.30
},
{
"antis": "Mercury",
"planet": "Sun",
"aspect": 0,
"distance": 2.53
}
// ... The same for the rest
]
Close Aspects#
- Key:
close_aspects - Access levels:
1,2
This section contains information about the close aspects of the planets. If there are no close aspects between the planets, they are not displayed in this list.
Note. The standard orb for all planets is 3 degrees. But in the case of opposition or conjunction with the Sun (combustion), the orb of the Sun is 8.5 degrees.
Aspects assumes sign boundaries. For example, the trine of Saturn at 29 degrees Leo and the planet at 1 degree of Virgo are on the adacent signs, so there is no close trine of Saturn and the planet.
[
{
"planet1": "Sun",
"planet2": "Jupiter",
"orb1": 3, // in degrees
"orb2": 3,
"aspect": 90, // in degrees
"distance": 0.58, // distance in aspect
"is_applying": true
}
// the same for other apecting planets
]
Conjunctions with Stars#
- Key:
conjunction_stars - Access levels:
1,2
This part contains the list of conjunctions of planets and cusps with the fixed stars. It only considers the conjunctions in the same sign and within the orb of 1 degree.
[
{
"star": "Alnilam",
"planet": "Mars",
"distance": 0.79
},
{
"star": "Alphard",
"cusp": 9,
"distance": 0.48
}
// The same for other conjunctions
]
Events in Sign#
- Key:
events_in_sign - Access levels:
1,2
This block provides data on events that happen to planets within the current sign. These events include hospitalizations, burnings, and aspects. Events are sorted in order of time.
[
{
"event": {
"type": "Station",
"value": "Getting retrograde" // Can be "Getting direct"
},
"date": "17.06.23", // in format day-month-year
"is_past": true, // if this event is past relative to chart's datetime
"planet": {
"name": "Saturn",
"longitide": 337.21,
"speed": -9.45e-08
},
// Distance to a station is always null. We use a "date" field for such an event
"distance": null,
"applying_planet": null
},
{
"event": {
"type": "Aspect",
"value": 60
},
"date": "19.06.23",
"is_past": true,
"planet1": {
"name": "Jupiter",
"longitide": 37.20,
"speed": 0.19
},
"planet2": {
"name": "Saturn",
"longitide": 337.20,
"speed": -0.0032
},
// Distance to aspect - a path of applying planet from the moment of chart
// to that position. Can be null if applying planet has stations on the way.
"distance": 15.40,
// Applying planet is one that makes a longer journey from the moment of the
// chart to the moment of aspect.
"applying_planet": "Jupiter"
},
{
"event": {
"type": "Combustion",
"value": "Getting combust" // Can be "Exiting combustion"
},
"date": "08.10.23",
"is_past": true,
"planet1": {
"name": "Sun",
"longitide": 180.78,
"speed": 1.01
},
"planet2": {
"name": "Mercury",
"longitide": 188.78,
"speed": 1.77
},
// We always use the combusted planet's path as a distance to combustion
"distance": 3.14,
"applying_planet": null
}
// The same data for the rest of the events
]
Long Term Aspects#
- Key:
long_term_aspects - Access levels:
1,2
This section shows the nearest future or past aspects of the planets, or prohibition points (stations and combustions) that the planet cannot overcome on the way to the closest aspect.
If any of the planets gets combusted before it performs an aspect, then the section displays information about the planet's combustion and the name of the second planet, which was not reached because of the combustion. Note that combustion may happen not only within a sign, but also during the ingression, when the planet enters the sign where it immideately conjucts the Sun.
If the aspecting planet makes a station on its way to the aspect, then the section shows the nearest station and the name of the second (aspected) planet. A faster (aspecting) planet is one that travels a longer distance from the current position to the aspect.
[
{
"date": "06.08.23",
"is_past": true, // separating or applying aspect
"event": 120, // numbers of degrees in case of aspect
"planet1": {
"name": "Sun",
"longitude": 133.37,
"speed": 0.95,
"distance": 0.25 // distance to the aspect
},
"planet2": {
"name": "Moon",
"longitude": 13.37,
"speed": 14.154,
"distance": 3.69
}
},
{
// Mercury got combusted when it crossessed
// 0 Cancer on the way from past apect with Mars
// to a current moment
"date": "27.06.23",
"is_past": true,
"event": "Combustion",
"planet1": {
"name": "Mercury",
"longitude": 90.0003361169669,
"speed": 2.165786463547473
},
"planet2": {
"name": "Mars"
}
},
{
"date": "23.07.23",
"is_past": true,
"event": "Station", // Venus (applying planet) change direction before it meets Mars
"planet1": {
"name": "Venus",
"longitude": 148.60322319003328,
"speed": -3.601053350471775e-07
},
"planet2": {
"name": "Mars"
}
}
// The same for othe planettary pairs
]
Exact Aspects#
- Key
exact_aspects - Access levels:
1,2
This section lists all exact aspects that planets perform while located in their respective signs.
- If an aspect is prohibited, it contains a
prohibitionkey with information about the prohibited event, and aprohibited_perfectionkey with information about the perfection event that will not occur. - If an aspect involves a third-party planet (referred to as the
postman) that either transfers the light (TOL) or collects the light (COL) of two planets, the aspect includes aformationkey. The formation illustrates the event when the first planet gives its light to the postman.
Note
If there is more than 1 prohibition of any of the planets participating in aspect, those prohibitions are not displayed and aspect is not listed.
The output has the following format:
[
/**
* Moon graps the light of the Sun and moves toward Mars.
* However, it cannot complete the translation of light as
* it encounters Saturn on the way.
*/
{
"planet1": "Sun",
"planet2": "Mars",
"summary": {
"type": "Separating",
"perfection": "Prohibition TOL"
},
"formation": { // Moon takes the light of the Sun
"planet1": "Sun",
"postman": "Moon",
"aspect": 180,
"date": "09.10.22",
// If you want to get more info on the event, have a look at the
// 11th element in the list of "events_on_sign" key
"index_in_events_in_sign": 11
},
"prohibition": { // Saturn cuts off the light of the Moon
"aspect": 60,
"date": "10.10.22",
"prohibited": "Moon",
"prohibitor": "Saturn",
"index_in_events_in_sign": 12
},
"prohibited_perfection": { // Moon cannot perform the TOL
"aspect": 60,
"date": "10.10.22",
"index_in_events_in_sign": 13,
"postman": "Moon",
"planet2": "Mars"
}
},
/**
* Separating direct aspect between the Moon and Mars
*/
{
"planet1": "Moon",
"planet2": "Mars",
"summary": {
"type": "Separating",
"perfection": "Direct"
},
"perfection": {
"aspect": 60,
"date": "10.10.22",
"distance": 5.0516812566865745,
"index_in_events_in_sign": 13,
"planet1": "Moon",
"planet2": "Mars"
}
},
/**
* Applying collection of the light (COL) between the luminaries.
* Saturn takes the light of the Moon and waits for the Sun to
* collect it
*/
{
"planet1": "Moon",
"planet2": "Sun",
"summary": {
"type": "Applying",
"perfection": "COL"
},
"formation": { // Saturn takes the light of the Moon
"planet1": "Moon",
"postman": "Saturn",
"aspect": 60,
"date": "10.10.22",
"index_in_events_in_sign": 12
},
"perfection": { // Sun collects the light from Saturn
"aspect": 120,
"date": "12.10.22",
"distance": 1.3084630318250845,
"index_in_events_in_sign": 14,
"postman": "Saturn",
"planet2": "Sun"
}
},
/**
* Prohibited direct aspect between the Sun and Mars.
* Sun moves to Mars but Saturn cuts off the Sun's light
* on the way to Mars.
*/
{
"planet1": "Sun",
"planet2": "Mars",
"summary": {
"type": "Applying",
"perfection": "Prohibition Direct"
},
"prohibition": {
"aspect": 120,
"date": "12.10.22",
"prohibited": "Sun",
"prohibitor": "Saturn",
"index_in_events_in_sign": 14
},
"prohibited_perfection": {
"aspect": 120,
"date": "17.10.22",
"index_in_events_in_sign": 16,
"planet1": "Sun",
"planet2": "Mars"
}
}
// The same is for other planetary pairs.
]
Radicality#
- Key
radicality - Access levels:
0,1,2
This section contains information about card radicalness analysis. It contains 6 types of analysis depending on the input parameters.
// We assume that both planets signify the querent
"querent_lord1_and_moon": {
// Analysis of radicality, in which we do not take into account
// the antiscia conjunction of the querent with planets and cusps
"no_antiscia": {...},
// The same analysis with consideration of antiscia conjunctions
"with_antiscia": {...}
},
// We assume that the Moon is busy with the quesited
"querent_lord1_only": {
"no_antiscia": {...},
"with_antiscia": {...}
},
// We assune thet the lord1 is busy with the quesited and
// the querent is only given the Moon
"querent_moon_only": {
"no_antiscia": {...},
"with_antiscia": {...}
}
Each analysis section has the following structure:
"by_position": [
{
"querent": "Venus", // The name of lord1
"accented_planets": [],
"accented_cusps": [3],
"ignored_cusps": [],
},
{
"querent": "Moon",
"accented_planets": [],
"accented_cusps": [4],
"ignored_cusps": []
},
{
"querent": "Pars of Fortune",
"accented_planets": [],
"accented_cusps": [6],
"ignored_cusps": []
}
],
"by_reception": [
{
"querent": "Venus",
"accented_planets": ["Sun"], // List of planets accented by major receptions
"accented_cusps": [10],
"ignored_cusps": [ // list of ignored cusps and reason to ignore
{
"cusp": 3,
"reason": "Querent is close to the cusp and in the sign of the cusp"
}
]
},
{
"querent": "Moon",
"accented_planets": ["Saturn"],
"accented_cusps": [4],
"ignored_cusps": []
},
{
"querent": "Pars of Fortune",
"accented_planets": ["Mars", "Sun"],
"accented_cusps": [2, 6, 7, 10],
"ignored_cusps": []
}
],
"by_conjunction": [
// Similar data
],
"by_antiscia": [
// Similar data. This list is only present in analysis
// where antiscia conjunctions are taken into account
]
// Summary
"accented_planets": ["Sun"],
"accented_cusps": [10, 4, 6]
Possible reasons to ignore houses in radicality analysis:
Querent is close to the cusp and in the sign of the cuspIf planet signifies the querent, it cannot rule other houses
Naturopathy: Symptoms#
- Key
med_symptoms - Access levels:
2
This section contains data on symptoms accentuated by the medical horary chart. For each house (which represents the patient's body, e.g., 1 - querent's body, 3 - the patient's brother's body, etc.), you will find:
- The lord of the house, representing the patient.
- A list of planets considered as potential causes of the disease, with explanations for why these planets have been selected.
- A list of symptoms associated with each candidate planet.
[
{
"patient_house": 1, // houses 1..12
"patient_planet": "Venus", // The lord of that house
// The list of planets considered as potential significators of
// illness with explanation why they are chosen
"candidates_for_illness": [...],
// The list of symptoms for each potential significator of desease
// (a candidate) with explanation why these symptoms are highlighted
"symptoms_by_candidate": [...]
}
// The same for other 11 houses
]
A list of planets considered as potential causes of the disease:
[
{
"rule": "The planets, afflicting by reception",
"planets": ["Saturn"]
},
{
"rule": "The planets, afflicting by close aspect",
"planets": ["Saturn"]
},
{
"rule": "The angular planets",
"planets": ["Sun", "Moon", "Mercury", "Venus"]
},
// Etc
]
The names of possible rules:
The ruler of dissonant elementThe planets, afflicting by receptionThe planets, afflicting by close aspectThe angular planetsThe most elevated planetThe significator of the patientThe planet, which has the last aspect with the MoonThe combusting Sun
A list of symptoms associated with each candidate planet (the planets are sorted from the most evident candidate to less evident):
[
{
"candidate": "Sun",
"accented_organs": [
{
"organs": ["spine (thoracic region)"],
"accented_by": [
"by position in a house",
"by afflicting reception"
]
},
{
"organs": ["heart", "thymus"],
"accented_by": [
"by planet itself",
"by position in a sign"
]
},
// Etc
]
},
// Similar data for other possible significator of the desease
]
The names of reason why the particular organ/symptom is highlited:
by position in a houseby position in a signby planet-sign combinationby planet itselfuniquely by <the planet's name>
The names of affected organs/desesases (for translation):
brain, head, hair, nose, vitality, thinking ability, eyes, teeth (upper jaw), immune system, neck, throat, esophagus, mouth, tongue, teeth (lower jaw), ears, thyroid, trachea, cerebellum, shoulders, arms, hands, fingers, chest, milk glands, lungs, alveoli, elbows, spine (thoracic region), heart, thymus, liver, gallbladder, stomach, pancreas, spleen, back, spine (lumbar region), belly, intestines, small of the back, spine (sacral region), kidneys, adrenal glands, bladder, uterus, ovaries, gonad, male genitals, female genitals, sperm, excretory organs, anus, hips, buttocks, knees, shins, ankles, feet, toes, right eye (for men), right eye (for women), lymphatic system, nervous system, female genital organ, left ear, bile, iron in blood, male genital organ, cartilage, blood, skin, bones, joints, right ear, fever, inflammation, facial redness, epilepsy, sleepwalking, paralysis, dropsy, convulsions, wet cough, dizziness, stuttering, flatulence, central nervous system damage, excess of saliva, cough, problems with urination, blockage of the airways, diseases of the genitals and kidneys, abscesses, frenzy, rabies, fistulas, facial flushing, sudden mental confusion, inflammation, high fever, kidney stones, itching, hemoptysis, tumors and growths, pockmarks, measles, frequent increase in temperature, hypertension, frequent and strong pulse, insanity, gout, tuberculosis, weakness, dropsy, cancer
Naturopathy: Healing#
- Key
med_healing - Access levels:
2
This section contains an analysis of the excessive humor and allies for each potential signification of the disease (a candidate).
[
{
"candidate": "Sun",
"humor_analysis": {
"humor_exceeded": "chole",
"degree": 2,
// The houses that indicate events or circumstances that
// could potentially trigger the psychosomatic disease
"provoking_houses": [10],
// The humor need to balance the exceeded humor
"humor_to_add": "phlegm"
},
"planetary_allies": {
"sympathy": ["Mars", "Sun"],
"antipathy": ["Saturn", "Venus"],
"recommended": [
{"ally": "Sun", "proportion": "3/5"},
{"ally": "Mars", "proportion": "1/5"},
{"ally": "Saturn", "proportion": "1/5"}
]
}
},
// Similar for the other planets
]