Composite Horoscope

The Composite horoscope, which also calculates relationships between people has another calculation method than the Synastry Horoscope. It calculates the compatibility between 2 persons and results in 1 final horoscope. Naturally for this type of horoscope 2 sets of birthdata are needed.

Basic Flow

To generate a Composite Horoscope from the AstroAPI, the system (your implementation) makes a POST-request to the /api/composite endpoint with the necessary parameters. With correct parameters the AstroAPI will provide a full composite horoscope in JSON-format + astrological wheel image url.

Generating a Composite Horoscope

POST /api/composite

Header Value
Accept-Encoding application/json
Content-Type application/json
Authorization Bearer [accessToken]


    "name_1": "Matthias",
    "date_1": "1984-03-27",
    "time_1": "13:13",
    "place_id_1": 1250015082,

    "name_2": "Lady Gaga",
    "date_2": "1986-03-28",
    "time_2": "22:55",
    "place_id_2": 1840034016,

    "lang": "en",

    "orbs": { // Customise orbs
      "opposition": { // Specify aspect type
        "0": 5, // Sun. Specify planet ID
        "1": 5, // Moon
        "default": 3 // Default value for unspecified planets
      "conjunction": 3, // Orb value for all planets for a specific aspect type
      "square": 3

Params explanation

Header Value
name The name of the person or event you wish to create a composite horoscope for
date The (birth)date of the person or event in format YYYY-mm-dd
time The (birth)time of the person or event in format HH:mm
lang The language you wish to receive the astrological interpretation texts associated with the horoscope in. Default: 'nl'


Example response for Composite

Full JSON-response File

JSON-object Astrological naming Explanation Custom Text
profile1 Information about Person 1 this astrological profile is about. Info about converted Birthdata to UTC, latitude/longitude, timezone -
profile2 Information about Person 2 this astrological profile is about. Info about converted Birthdata to UTC, latitude/longitude, timezone -
intro Text as intro with general info about the composite horoscope. Yes
planets Planets in Signs Influence of the planets on the person/event. Calculation for each planet. *e.g. Jupiter in Aries in House 4 Yes
elements Basic Elements Strength of the basic elements on the horoscope based on the planetary connotations. e.g. Mercury = Fire planet With lots of Fire planets in the horoscope the Fire strength increases. Yes
zodiacpoints Zodiac Elements Strength Strength of the zodiac signs in the horoscope. e.g. Taurus: strength 5 Yes (for strength > 4)
housecusps House Cusps The signs on the different house cusps of the astrological chart Yes
aspects Aspects The interplanetary relations in degrees that form bonds. *e.g. 180° = Opposite aspect Yes
wheel Astrological Wheels URL to the generated Astrological wheel based on the horoscope calculation. -

Astrological wheel

    "wheel": "/img/composite_example.png",

Composite wheel