Natal Chart 3D Visualization#

/api/3dview/

Use this endpoint to retrieve plot data for creating a 3D horoscope with primary directions using the Plotly library.

The access level for this endpoint is m1 (see access levels).

Request#

Method POST

It requires the same parameters as a standard natal chart data endpoint

Response#

It returns a set of plot data for adding traces to a figure in the Plotly library. The plot data typically has the following format:

{
    // A set of coordinates
    "x": [0.995, 0.994, ...],
    "y": [0.055, 0.056, ...],
    "z": [-0.44, -0.43, ...],
    // followed by plot params
    "mode": "markers+text",
    "marker": {
        "color": "rgb(0,120,200)",
        "size": 3
    },
    "type": "scatter3d",
    // ..and other params for Plotly library.
}

The full set of data is grouped this way:

{
    "sphere_and_planets": [...], // A list of plot data to draw the celestial sphere with planets
    "ecliptic": [...], // A list of plot data to draw the ecliptic line with zodiac signs
    "equator": [...], // A list of plot data to draw the equator line
    "edges_of_neverascending_stars": [...],
    "house_dividers": [...], // A list of plot data to draw house curves on a 3D sphere
    "house_cusps": [...], // The same to draw cusps in a zodiac circle
    "equatorial_projections": {
        "Sun": [...], // A list of plot data to show the equatorial projection of the Sun,
        "Moon": [...],
        // ... the same for other planets
    },
    // Use these data to display a circle/curve of the position of each planet and the mundane
    // point (an intersection of the circle/curve with the equator)
    "mundane_positions": {
        "Sun": [...],
        "Moon": [...],
        // ... the same for other planets
    },
    // Use these data to display a circle of declination and its intersection with the ecliptic
    // (two mundane antiscia) for each planet
    "mundane_antiscia": {
        "Sun": [...],
        "Moon": [...],
        // ... the same for other planets
    },
    // Use this dictionary to quickly find the direction you need. The key has the following
    // format: "s: <significator: str>, p: {aspect degree: str} of {planet name: str}". Here
    // "s:" stand for significator and "p" for ptomittor. Significators are the planets and
    // cusps (numbers from 1 to 12). Promittors are the aspects of the planet. Data in each
    // direction represent a directiona arc, a mundane aspect (if aspect != 0), and the
    // circle/curve of positions of the end termini in direction
    "directions": {
        "s: Sun, p: -120 of Moon": [...], // Direction of sinister tri of the Moon to the Sun
        "s: Sun, p: -90 of Moon": [...],
        // ...
        "s: 1, p: -120 of Sun": [...],
        "s: 1, p: -90 of Sun": [...],
        // ...
    },

    "layout_settings": {...} // Settings for the PlotLy Figure
}