Natal Chart

The POST /v1/chart endpoint is the foundation of most requests. It returns a full natal chart: planet positions, house cusps, aspects between planets, chart sect. Cost: 20 credits (Tier 2).

Request parameters

Parameter	Type	Required	Description
date	string	Yes	Birth date YYYY-MM-DD
time	string	Yes	Birth time HH:mm:ss
timezoneOffset	number	Yes	UTC offset in hours (e.g. 2 for Kyiv in summer)
latitude	number	No (0)	Latitude in decimal degrees
longitude	number	No (0)	Longitude in decimal degrees
houseSystem	string	No (P)	House system: P Placidus, K Koch, W Whole Sign, E Equal and others
name	string	No	Name (echoed in response)
city	string	No	City (echoed in response)
zodiacType	string	No	tropical (default) or sidereal
cosmogram	boolean	No	true - no houses (when location unknown)

Example request

Natal chart for Kyiv, July 14, 1990, 14:30:

cURL

curl -X POST https://api.astroway.info/v1/chart \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P"
  }'

Node.js

const res = await fetch('https://api.astroway.info/v1/chart', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  }),
});
const { data: chart } = await res.json();
console.log(chart.planets[0]); // Sun position

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/chart',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
        'houseSystem': 'P',
    },
)
chart = r.json()['data']
print(chart['planets'][0])

PHP

<?php
use GuzzleHttp\Client;

$aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $aw->post('chart', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-07-14',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
        'latitude' => 50.4501,
        'longitude' => 30.5234,
        'houseSystem' => 'P',
    ],
]);
$chart = json_decode($r->getBody(), true)['data'];
print_r($chart['planets'][0]);

Example response

{
  "input": {
    "name": "",
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P",
    "city": "",
    "cosmogram": false
  },
  "julianDay": 2448086.979167,
  "siderealTime": 6.971672,
  "planets": [
    {
      "id": 0,
      "name": "Sun",
      "longitude": 111.77244,
      "latitude": 0.000162,
      "distance": 1.016462,
      "speedLong": 0.953753,
      "isRetrograde": false,
      "declination": 21.681363
    },
    {
      "id": 1,
      "name": "Moon",
      "longitude": 9.061363,
      "latitude": 4.639701,
      "distance": 0.002511,
      "speedLong": 13.770219,
      "isRetrograde": false,
      "declination": 7.854711
    }
  ],
  "houses": {
    "system": "P",
    "cusps": [
      212.0953,
      239.7536,
      274.2018,
      312.6334,
      346.2069,
      12.1755,
      32.0953,
      59.7536,
      94.2018,
      132.6334,
      166.2069,
      192.1755
    ],
    "ascendant": 212.0953,
    "mc": 132.6334
  },
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Jupiter",
      "type": {
        "name": "Conjunction",
        "angle": 0,
        "isMajor": true
      },
      "orb": 0.548,
      "isApplying": true
    }
  ],
  "chartSect": "diurnal"
}

Note

Response is abbreviated for clarity. The full response includes 13 bodies, 12 house cusps, and all aspects between them. Each body’s name carries its Swiss Ephemeris label rather than the astrological one: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, true Node (the true North Node), mean Apogee (mean Lilith), Chiron. The South Node is not returned as its own body: it is true Node plus 180°.

House systems

Code	System	Notes
P	Placidus	Default, most popular
K	Koch	Popular in Germany
W	Whole Sign	Classical Hellenistic
E	Equal	Equal from ASC
R	Regiomontanus	Horary astrology
C	Campanus	Spatial system
T	Topocentric	Polich-Page
B	Alcabitius	Medieval tradition

Full list of 15 systems - in API reference.

Cosmogram (no birthplace)

If birth time is known but location isn’t, pass "cosmogram": true. Houses and ASC/MC are not calculated, cost is the same (20 credits).

Response headers

X-Credits-Used: 20
X-Credits-Remaining: 4980
X-Credits-Reset: 2026-05-01T00:00:00Z
X-Request-Id: 8aec43e9bc749b37e998a489bbad1757

Next

• Synastry: compatibility of two charts
• Transits: transit overlay and event calendar
• Human Design: full HD chart
• Full API reference: all 760 endpoints