Carta natal

El endpoint POST /v1/chart es la base de la mayoría de las solicitudes. Devuelve la carta natal completa: posiciones de los planetas, cúspides de las casas, aspectos entre planetas y la secta de la carta. Costo: 20 créditos (Tier 2).

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción
`date`	string	Sí	Fecha de nacimiento `YYYY-MM-DD`
`time`	string	Sí	Hora de nacimiento `HH:mm:ss` o `HH:mm` (se lee como `HH:mm:00`)
`timezoneOffset`	number	Sí	Desplazamiento respecto a UTC en horas (p. ej. `2` para Kiev en verano)
`latitude`	number	No (0)	Latitud en grados decimales
`longitude`	number	No (0)	Longitud en grados decimales
`houseSystem`	string	No (`P`)	Sistema de casas: `P` Placidus, `K` Koch, `W` Whole Sign, `E` Equal y otros
`name`	string	No	Nombre (se devuelve en la respuesta)
`city`	string	No	Ciudad (se devuelve en la respuesta)
`zodiacType`	string	No	`tropical` (por defecto) o `sidereal`
`cosmogram`	boolean	No	`true` - sin casas (cuando el lugar es desconocido)

Ejemplo de solicitud

Carta natal para Kiev, 14 de julio de 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

Ejemplo de respuesta

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

Nombres en tu idioma

Añade ?lang= para obtener los nombres de planetas, signos y aspectos en ese idioma junto con los identificadores en inglés, que no cambian. Sirve cualquiera de los 21 idiomas, por ejemplo alemán:

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

Sin ?lang=, el bloque localized no aparece en la respuesta.

Sistemas de casas

Código	Sistema	Nota
`P`	Placidus	Por defecto, el más popular
`K`	Koch	Popular en Alemania
`W`	Whole Sign	Clásico helenístico
`E`	Equal	Iguales desde el ASC
`R`	Regiomontanus	Astrología horaria
`C`	Campanus	Sistema espacial
`T`	Topocentric	Polich-Page
`B`	Alcabitius	Tradición medieval

La lista completa de 15 sistemas está en la API reference.

Cosmograma (sin lugar de nacimiento)

Si conoces la hora de nacimiento pero no el lugar, pasa "cosmogram": true. Las casas y el ASC/MC no se calculan; el costo en créditos es el mismo (20).

Headers de la respuesta

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

Siguientes pasos

Sinastría: compatibilidad de dos cartas
Tránsitos: overlay de tránsitos y calendario de eventos
Human Design: carta HD completa
API reference completa: los 771 endpoints

¿Útil?

Sugerir edición

Última actualización: 7 oct 2026