Morphemeris DocsBeta

Chart

GET /v1/chart — Compute planetary positions and house cusps in a single request.

Chart

Combines positions and houses into one response. This is the most common use case for natal or transit chart computation.

GET  /v1/chart
POST /v1/chart

Credit cost: 1 (cheaper than calling /v1/positions + /v1/houses separately)

Parameters

Accepts all parameters from both /v1/positions and /v1/houses.

lat and lon are required since house calculation needs a location.

Response

{
  "data": {
    "positions": [
      {
        "body": "sun",
        "longitude": 0.0042,
        "latitude": 0.0001,
        "distance": 0.9960,
        "speed": 1.0096,
        "sign": "Aries",
        "sign_degree": 0.0042,
        "retrograde": false,
        "declination": 0.0012,
        "out_of_bounds": false
      }
    ],
    "houses": {
      "system": "placidus",
      "cusps": [198.45, 228.12, "..."],
      "ascendant": 198.4521,
      "midheaven": 118.9012,
      "armc": 117.2345,
      "vertex": 42.6789
    },
    "ayanamsha": null
  },
  "meta": { "..." }
}

The ayanamsha field is included (as the ayanamsha value in degrees) when sidereal mode is active, and null otherwise.

Examples

curl "https://api.morphemeris.com/v1/chart?datetime=1990-06-15T14:30:00Z&lat=40.7128&lon=-74.0060&system=placidus&bodies=sun,moon,mercury,venus,mars,jupiter,saturn" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"
const res = await fetch(
  "https://api.morphemeris.com/v1/chart?datetime=1990-06-15T14:30:00Z&lat=40.7128&lon=-74.0060&system=placidus&bodies=sun,moon,mercury,venus,mars,jupiter,saturn",
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const data = await res.json();
import requests

res = requests.get(
    "https://api.morphemeris.com/v1/chart",
    params={
        "datetime": "1990-06-15T14:30:00Z",
        "lat": 40.7128,
        "lon": -74.0060,
        "system": "placidus",
        "bodies": "sun,moon,mercury,venus,mars,jupiter,saturn",
    },
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

On this page