Carte natale

L’endpoint POST /v1/chart est la base de la plupart des requêtes. Il renvoie une carte natale complète : positions des planètes, cuspides des maisons, aspects entre les planètes, secte de la carte. Coût : 20 crédits (Tier 2).

Paramètres de la requête

Paramètre	Type	Obligatoire	Description
`date`	string	Oui	Date de naissance `YYYY-MM-DD`
`time`	string	Oui	Heure de naissance `HH:mm:ss` ou `HH:mm` (lue comme `HH:mm:00`)
`timezoneOffset`	number	Oui	Décalage par rapport à UTC en heures (par ex. `2` pour Kyiv en été)
`latitude`	number	Non (0)	Latitude en degrés décimaux
`longitude`	number	Non (0)	Longitude en degrés décimaux
`houseSystem`	string	Non (`P`)	Système de maisons : `P` Placidus, `K` Koch, `W` Whole Sign, `E` Equal et autres
`name`	string	Non	Nom (renvoyé dans la réponse)
`city`	string	Non	Ville (renvoyée dans la réponse)
`zodiacType`	string	Non	`tropical` (par défaut) ou `sidereal`
`cosmogram`	boolean	Non	`true` - sans maisons (quand le lieu est inconnu)

Exemple de requête

Carte natale pour Kyiv, 14 juillet 1990, 14:30 :

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"
  }'

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

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])  # Sun position

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->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]); // Sun position

Exemple de réponse

{
  "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"
}

Noms dans ta langue

Ajoute ?lang= pour obtenir les noms des planètes, des signes et des aspects dans cette langue, à côté des identifiants anglais qui ne changent pas. N’importe laquelle des 21 langues convient, par exemple l’allemand :

curl -X POST "https://api.astroway.info/v1/chart?lang=de" \
  -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" }'

{
  "localized": {
    "planets": { "Sun": "Sonne", "Moon": "Mond", "Mercury": "Merkur" },
    "signs": { "cancer": "Krebs", "leo": "Löwe", "aries": "Widder" },
    "aspects": { "Conjunction": "Konjunktion", "Opposition": "Opposition" }
  }
}

Sans ?lang=, le bloc localized est absent de la réponse.

Systèmes de maisons

Code	Système	Remarque
`P`	Placidus	Par défaut, le plus populaire
`K`	Koch	Populaire en Allemagne
`W`	Whole Sign	Classique hellénistique
`E`	Equal	Égales depuis l’ASC
`R`	Regiomontanus	Astrologie horaire
`C`	Campanus	Système spatial
`T`	Topocentric	Polich-Page
`B`	Alcabitius	Tradition médiévale

La liste complète des 15 systèmes se trouve dans la référence API.

Cosmogramme (sans lieu de naissance)

Si l’heure de naissance est connue mais pas le lieu, passe "cosmogram": true. Les maisons et l’ASC/MC ne sont pas calculés, le coût en crédits reste le même (20).

Headers de la réponse

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

Pour aller plus loin

Synastrie : compatibilité de deux cartes
Transits : overlay de transits et calendrier des événements
Human Design : carte HD complète
Référence API complète : les 771 endpoints

Utile?

Proposer une modification

Dernière mise à jour : 7 oct. 2026