Try Astrologer API

Subscribe to support and grow the project.

Subject Context Example #

Endpoint: /api/v5/context/subject

Request Body #

{
  "subject": {
    "name": "John Doe",
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 30,
    "city": "London",
    "nation": "GB",
    "longitude": -0.1278,
    "latitude": 51.5074,
    "timezone": "Europe/London",
    "zodiac_type": "Tropical",
    "houses_system_identifier": "P"
  }
}

Response Body #

{
  "status": "OK",
  "subject_context": "Chart for \"John Doe\"\nBirth data: 1990-01-01 12:30, London, GB\nCoordinates: 51.51\u00b0N, -0.13\u00b0W\nTimezone: Europe/London\nZodiac system: Tropical\nHouse system: Placidus\nPerspective: Apparent Geocentric\n\nPlanetary positions:\n  - Sun at 10.84\u00b0 in Capricorn in Ninth House, absolute position 280.84\u00b0, quality: Cardinal, element: Earth, direct motion, speed 1.0195\u00b0/day, declination -23.00\u00b0\n  - Moon at 3.55\u00b0 in Pisces in Eleventh House, absolute position 333.55\u00b0, quality: Mutable, element: Water, direct motion, speed 13.4742\u00b0/day, declination -8.81\u00b0\n  - Mercury at 25.67\u00b0 in Capricorn in Tenth House, absolute position 295.67\u00b0, quality: Cardinal, element: Earth, retrograde, speed -0.2987\u00b0/day, declination -20.39\u00b0\n  - Venus at 6.22\u00b0 in Aquarius in Tenth House, absolute position 306.22\u00b0, quality: Fixed, element: Air, retrograde, speed -0.1312\u00b0/day, declination -16.87\u00b0\n  - Mars at 10.01\u00b0 in Sagittarius in Seventh House, absolute position 250.01\u00b0, quality: Mutable, element: Fire, direct motion, speed 0.7038\u00b0/day, declination -21.99\u00b0\n  - Jupiter at 5.15\u00b0 in Cancer in Third House, absolute position 95.15\u00b0, quality: Cardinal, element: Water, retrograde, speed -0.1345\u00b0/day, declination 23.23\u00b0\n  - Saturn at 15.66\u00b0 in Capricorn in Ninth House, absolute position 285.66\u00b0, quality: Cardinal, element: Earth, direct motion, speed 0.1183\u00b0/day, declination -22.23\u00b0\n  - Uranus at 5.79\u00b0 in Capricorn in Ninth House, absolute position 275.79\u00b0, quality: Cardinal, element: Earth, direct motion, speed 0.0600\u00b0/day, declination -23.59\u00b0\n  - Neptune at 12.04\u00b0 in Capricorn in Ninth House, absolute position 282.04\u00b0, quality: Cardinal, element: Earth, direct motion, speed 0.0379\u00b0/day, declination -22.05\u00b0\n  - Pluto at 17.09\u00b0 in Scorpio in Seventh House, absolute position 227.09\u00b0, quality: Fixed, element: Water, direct motion, speed 0.0273\u00b0/day, declination -2.25\u00b0\n  - Chiron at 13.81\u00b0 in Cancer in Third House, absolute position 103.81\u00b0, quality: Cardinal, element: Water, retrograde, speed -0.0685\u00b0/day, declination 15.46\u00b0\n  - Mean_Lilith at 6.47\u00b0 in Scorpio in Sixth House, absolute position 216.47\u00b0, quality: Fixed, element: Water, direct motion, speed 0.1120\u00b0/day, declination -18.42\u00b0\n\nImportant points:\n  - Ascendant at 10.21\u00b0 in Taurus in First House, absolute position 40.21\u00b0, quality: Fixed, element: Earth, direct motion, speed 360.0000\u00b0/day\n  - Descendant at 10.21\u00b0 in Scorpio in Seventh House, absolute position 220.21\u00b0, quality: Fixed, element: Water, direct motion, speed 360.0000\u00b0/day\n  - Medium_Coeli at 16.85\u00b0 in Capricorn in Tenth House, absolute position 286.85\u00b0, quality: Cardinal, element: Earth, direct motion, speed 360.0000\u00b0/day\n  - Imum_Coeli at 16.85\u00b0 in Cancer in Fourth House, absolute position 106.85\u00b0, quality: Cardinal, element: Water, direct motion, speed 360.0000\u00b0/day\n  - True_North_Lunar_Node at 16.87\u00b0 in Aquarius in Eleventh House, absolute position 316.87\u00b0, quality: Fixed, element: Air, direct motion, speed 0.0236\u00b0/day, declination -15.78\u00b0\n  - True_South_Lunar_Node at 16.87\u00b0 in Leo in Fifth House, absolute position 136.87\u00b0, quality: Fixed, element: Fire, direct motion, speed -0.0236\u00b0/day, declination 15.78\u00b0\n\nHouse cusps:\n  - First_House cusp at 10.21\u00b0 in Tau\n  - Second_House cusp at 10.24\u00b0 in Gem\n  - Third_House cusp at 29.34\u00b0 in Gem\n  - Fourth_House cusp at 16.85\u00b0 in Can\n  - Fifth_House cusp at 7.64\u00b0 in Leo\n  - Sixth_House cusp at 10.18\u00b0 in Vir\n  - Seventh_House cusp at 10.21\u00b0 in Sco\n  - Eighth_House cusp at 10.24\u00b0 in Sag\n  - Ninth_House cusp at 29.34\u00b0 in Sag\n  - Tenth_House cusp at 16.85\u00b0 in Cap\n  - Eleventh_House cusp at 7.64\u00b0 in Aqu\n  - Twelfth_House cusp at 10.18\u00b0 in Pis\n\nLunar phase: Waxing Crescent (phase 5), 52.71\u00b0 separation between Sun and Moon, emoji: \ud83c\udf12",
  "subject": {
    "name": "John Doe",
    "city": "London",
    "nation": "GB",
    "lng": -0.1278,
    "lat": 51.5074,
    "tz_str": "Europe/London",
    "iso_formatted_local_datetime": "1990-01-01T12:30:00+00:00",
    "iso_formatted_utc_datetime": "1990-01-01T12:30:00+00:00",
    "julian_day": 2447893.0208333335,
    "day_of_week": "Monday",
    "zodiac_type": "Tropical",
    "sidereal_mode": null,
    "houses_system_identifier": "P",
    "houses_system_name": "Placidus",
    "perspective_type": "Apparent Geocentric",
    "sun": {
      "name": "Sun",
      "quality": "Cardinal",
      "element": "Earth",
      "sign": "Cap",
      "sign_num": 9,
      "position": 10.835494501905885,
      "abs_pos": 280.8354945019059,
      "emoji": "\u2651\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Ninth_House",
      "retrograde": false,
      "speed": 1.0194718584324671,
      "declination": -23.000137587783012
    },
    "moon": {
      "name": "Moon",
      "quality": "Mutable",
      "element": "Water",
      "sign": "Pis",
      "sign_num": 11,
      "position": 3.5483579330368684,
      "abs_pos": 333.54835793303687,
      "emoji": "\u2653\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Eleventh_House",
      "retrograde": false,
      "speed": 13.474246484787328,
      "declination": -8.81298773914876
    },
    "mercury": {
      "name": "Mercury",
      "quality": "Cardinal",
      "element": "Earth",
      "sign": "Cap",
      "sign_num": 9,
      "position": 25.666624459288926,
      "abs_pos": 295.6666244592889,
      "emoji": "\u2651\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Tenth_House",
      "retrograde": true,
      "speed": -0.2986964214829841,
      "declination": -20.38662403310331
    },
    "venus": {
      "name": "Venus",
      "quality": "Fixed",
      "element": "Air",
      "sign": "Aqu",
      "sign_num": 10,
      "position": 6.219109996580983,
      "abs_pos": 306.219109996581,
      "emoji": "\u2652\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Tenth_House",
      "retrograde": true,
      "speed": -0.13116322140085515,
      "declination": -16.873189098956463
    },
    "mars": {
      "name": "Mars",
      "quality": "Mutable",
      "element": "Fire",
      "sign": "Sag",
      "sign_num": 8,
      "position": 10.01474833049312,
      "abs_pos": 250.01474833049312,
      "emoji": "\u2650\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Seventh_House",
      "retrograde": false,
      "speed": 0.7037680792288851,
      "declination": -21.987262405885662
    },
    "jupiter": {
      "name": "Jupiter",
      "quality": "Cardinal",
      "element": "Water",
      "sign": "Can",
      "sign_num": 3,
      "position": 5.145924049654369,
      "abs_pos": 95.14592404965437,
      "emoji": "\u264b\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Third_House",
      "retrograde": true,
      "speed": -0.1344694034107826,
      "declination": 23.225447225503117
    },
    "saturn": {
      "name": "Saturn",
      "quality": "Cardinal",
      "element": "Earth",
      "sign": "Cap",
      "sign_num": 9,
      "position": 15.659986106942313,
      "abs_pos": 285.6599861069423,
      "emoji": "\u2651\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Ninth_House",
      "retrograde": false,
      "speed": 0.11827322348412281,
      "declination": -22.232019534339987
    },
    "uranus": {
      "name": "Uranus",
      "quality": "Cardinal",
      "element": "Earth",
      "sign": "Cap",
      "sign_num": 9,
      "position": 5.786725406933215,
      "abs_pos": 275.7867254069332,
      "emoji": "\u2651\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Ninth_House",
      "retrograde": false,
      "speed": 0.060006472091970554,
      "declination": -23.585674533268072
    },
    "neptune": {
      "name": "Neptune",
      "quality": "Cardinal",
      "element": "Earth",
      "sign": "Cap",
      "sign_num": 9,
      "position": 12.038909407239942,
      "abs_pos": 282.03890940723994,
      "emoji": "\u2651\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Ninth_House",
      "retrograde": false,
      "speed": 0.03791058396847335,
      "declination": -22.053131899388784
    },
    "pluto": {
      "name": "Pluto",
      "quality": "Fixed",
      "element": "Water",
      "sign": "Sco",
      "sign_num": 7,
      "position": 17.093735645856583,
      "abs_pos": 227.09373564585658,
      "emoji": "\u264f\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Seventh_House",
      "retrograde": false,
      "speed": 0.027313518160729595,
      "declination": -2.2485032427503753
    },
    "ascendant": {
      "name": "Ascendant",
      "quality": "Fixed",
      "element": "Earth",
      "sign": "Tau",
      "sign_num": 1,
      "position": 10.206357251516188,
      "abs_pos": 40.20635725151619,
      "emoji": "\u2649\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "First_House",
      "retrograde": false,
      "speed": 360.0,
      "declination": null
    },
    "descendant": {
      "name": "Descendant",
      "quality": "Fixed",
      "element": "Water",
      "sign": "Sco",
      "sign_num": 7,
      "position": 10.206357251516181,
      "abs_pos": 220.20635725151618,
      "emoji": "\u264f\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Seventh_House",
      "retrograde": false,
      "speed": 360.0,
      "declination": null
    },
    "medium_coeli": {
      "name": "Medium_Coeli",
      "quality": "Cardinal",
      "element": "Earth",
      "sign": "Cap",
      "sign_num": 9,
      "position": 16.852998924128883,
      "abs_pos": 286.8529989241289,
      "emoji": "\u2651\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Tenth_House",
      "retrograde": false,
      "speed": 360.0,
      "declination": null
    },
    "imum_coeli": {
      "name": "Imum_Coeli",
      "quality": "Cardinal",
      "element": "Water",
      "sign": "Can",
      "sign_num": 3,
      "position": 16.852998924128883,
      "abs_pos": 106.85299892412888,
      "emoji": "\u264b\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Fourth_House",
      "retrograde": false,
      "speed": 360.0,
      "declination": null
    },
    "chiron": {
      "name": "Chiron",
      "quality": "Cardinal",
      "element": "Water",
      "sign": "Can",
      "sign_num": 3,
      "position": 13.811836466986122,
      "abs_pos": 103.81183646698612,
      "emoji": "\u264b\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Third_House",
      "retrograde": true,
      "speed": -0.06847574362766261,
      "declination": 15.457339430329565
    },
    "earth": null,
    "pholus": null,
    "mean_lilith": {
      "name": "Mean_Lilith",
      "quality": "Fixed",
      "element": "Water",
      "sign": "Sco",
      "sign_num": 7,
      "position": 6.466322896187762,
      "abs_pos": 216.46632289618776,
      "emoji": "\u264f\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Sixth_House",
      "retrograde": false,
      "speed": 0.11200484040813168,
      "declination": -18.42377315967041
    },
    "true_lilith": null,
    "ceres": null,
    "pallas": null,
    "juno": null,
    "vesta": null,
    "eris": null,
    "sedna": null,
    "haumea": null,
    "makemake": null,
    "ixion": null,
    "orcus": null,
    "quaoar": null,
    "regulus": null,
    "spica": null,
    "pars_fortunae": null,
    "pars_spiritus": null,
    "pars_amoris": null,
    "pars_fidei": null,
    "vertex": null,
    "anti_vertex": null,
    "first_house": {
      "name": "First_House",
      "quality": "Fixed",
      "element": "Earth",
      "sign": "Tau",
      "sign_num": 1,
      "position": 10.206357251516188,
      "abs_pos": 40.20635725151619,
      "emoji": "\u2649\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "second_house": {
      "name": "Second_House",
      "quality": "Mutable",
      "element": "Air",
      "sign": "Gem",
      "sign_num": 2,
      "position": 10.237193272164902,
      "abs_pos": 70.2371932721649,
      "emoji": "\u264a\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "third_house": {
      "name": "Third_House",
      "quality": "Mutable",
      "element": "Air",
      "sign": "Gem",
      "sign_num": 2,
      "position": 29.34468649767578,
      "abs_pos": 89.34468649767578,
      "emoji": "\u264a\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "fourth_house": {
      "name": "Fourth_House",
      "quality": "Cardinal",
      "element": "Water",
      "sign": "Can",
      "sign_num": 3,
      "position": 16.852998924128883,
      "abs_pos": 106.85299892412888,
      "emoji": "\u264b\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "fifth_house": {
      "name": "Fifth_House",
      "quality": "Fixed",
      "element": "Fire",
      "sign": "Leo",
      "sign_num": 4,
      "position": 7.638172509881485,
      "abs_pos": 127.63817250988149,
      "emoji": "\u264c\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "sixth_house": {
      "name": "Sixth_House",
      "quality": "Mutable",
      "element": "Earth",
      "sign": "Vir",
      "sign_num": 5,
      "position": 10.177198195457322,
      "abs_pos": 160.17719819545732,
      "emoji": "\u264d\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "seventh_house": {
      "name": "Seventh_House",
      "quality": "Fixed",
      "element": "Water",
      "sign": "Sco",
      "sign_num": 7,
      "position": 10.206357251516181,
      "abs_pos": 220.20635725151618,
      "emoji": "\u264f\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "eighth_house": {
      "name": "Eighth_House",
      "quality": "Mutable",
      "element": "Fire",
      "sign": "Sag",
      "sign_num": 8,
      "position": 10.237193272164916,
      "abs_pos": 250.23719327216492,
      "emoji": "\u2650\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "ninth_house": {
      "name": "Ninth_House",
      "quality": "Mutable",
      "element": "Fire",
      "sign": "Sag",
      "sign_num": 8,
      "position": 29.344686497675752,
      "abs_pos": 269.34468649767575,
      "emoji": "\u2650\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "tenth_house": {
      "name": "Tenth_House",
      "quality": "Cardinal",
      "element": "Earth",
      "sign": "Cap",
      "sign_num": 9,
      "position": 16.852998924128883,
      "abs_pos": 286.8529989241289,
      "emoji": "\u2651\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "eleventh_house": {
      "name": "Eleventh_House",
      "quality": "Fixed",
      "element": "Air",
      "sign": "Aqu",
      "sign_num": 10,
      "position": 7.638172509881485,
      "abs_pos": 307.6381725098815,
      "emoji": "\u2652\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "twelfth_house": {
      "name": "Twelfth_House",
      "quality": "Mutable",
      "element": "Water",
      "sign": "Pis",
      "sign_num": 11,
      "position": 10.177198195457322,
      "abs_pos": 340.1771981954573,
      "emoji": "\u2653\ufe0f",
      "point_type": "House",
      "house": null,
      "retrograde": null,
      "speed": null,
      "declination": null
    },
    "mean_north_lunar_node": null,
    "true_north_lunar_node": {
      "name": "True_North_Lunar_Node",
      "quality": "Fixed",
      "element": "Air",
      "sign": "Aqu",
      "sign_num": 10,
      "position": 16.86916241757058,
      "abs_pos": 316.8691624175706,
      "emoji": "\u2652\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Eleventh_House",
      "retrograde": false,
      "speed": 0.023616439022742144,
      "declination": -15.782160851349627
    },
    "mean_south_lunar_node": null,
    "true_south_lunar_node": {
      "name": "True_South_Lunar_Node",
      "quality": "Fixed",
      "element": "Fire",
      "sign": "Leo",
      "sign_num": 4,
      "position": 16.86916241757058,
      "abs_pos": 136.86916241757058,
      "emoji": "\u264c\ufe0f",
      "point_type": "AstrologicalPoint",
      "house": "Fifth_House",
      "retrograde": false,
      "speed": -0.023616439022742144,
      "declination": 15.782160851349627
    },
    "houses_names_list": [
      "First_House",
      "Second_House",
      "Third_House",
      "Fourth_House",
      "Fifth_House",
      "Sixth_House",
      "Seventh_House",
      "Eighth_House",
      "Ninth_House",
      "Tenth_House",
      "Eleventh_House",
      "Twelfth_House"
    ],
    "active_points": [
      "Sun",
      "Moon",
      "Mercury",
      "Venus",
      "Mars",
      "Jupiter",
      "Saturn",
      "Uranus",
      "Neptune",
      "Pluto",
      "True_North_Lunar_Node",
      "True_South_Lunar_Node",
      "Mean_Lilith",
      "Chiron",
      "Ascendant",
      "Medium_Coeli",
      "Descendant",
      "Imum_Coeli"
    ],
    "lunar_phase": {
      "degrees_between_s_m": 52.712863431130984,
      "moon_phase": 5,
      "moon_emoji": "\ud83c\udf12",
      "moon_phase_name": "Waxing Crescent"
    },
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 30
  }
}