API de carta natal

La carta natal es el fundamento de cualquier aplicación astrológica (Co-Star, Sanctuary, The Pattern, Chani, todas se basan en ella). La API de AstroWay ofrece un conjunto completo de endpoints para construir y analizar una carta en una sola llamada: desde las posiciones planetarias básicas utilizando el mismo Swiss Ephemeris que Solar Fire y Astrodienst, hasta técnicas raras que no tienen los competidores, parte de los más de 700 endpoints de toda la plataforma.

Qué se calcula

Una carta natal completa incluye la astrology trinity (trinidad astrológica), las tres “caras” de la personalidad que los usuarios vuelven a estudiar una y otra vez (impulsa la retención):

Posiciones planetarias: Sol (identidad/propósito), Luna (núcleo emocional/necesidades), Mercurio, Venus, Marte, Júpiter, Saturno, Urano, Neptuno, Plutón + Nodo Norte (en la respuesta true Node), Lilith (mean Apogee), Quirón. Longitud, latitud, velocidad, signo, casa, retrogradación.
Cúspides de las casas: 15 sistemas a elegir (Placidus, Koch, Whole Sign, Equal y otros). ASC (cómo te ven los demás), MC (carrera/imagen pública), Vértice.
Aspectos: conjunción, oposición, trígono, cuadratura, sextil, quincuncio. Orbe, aplicando/separando.
Secta de la carta: diurna/nocturna (para astrología helenística clásica al estilo de Chris Brennan / Demetra George).

Para ver estos datos dibujados y no en JSON, abre la carta natal en la aplicación AstroWay: el mismo motor, el mismo cálculo, rueda y tablas listas.

Endpoints

Endpoint	Créditos	Qué devuelve
`/v1/chart`	20	Carta natal completa (planetas + casas + aspectos)
`/v1/planets`	10	Solo posiciones planetarias (sin casas ni aspectos)
`/v1/essential-dignities`	20	Tabla de dignidades esenciales (domicilio, exaltación, triplicidad, término, faz)
`/v1/almuten`	20	Almuten figuris - técnica medieval
`/v1/arabic-parts`	20	Partes arábigas/suertes (Fortuna, Spirit, y otras)
`/v1/fixed-stars`	20	Conjunciones planetarias con estrellas fijas
`/v1/midpoints`	20	Midpoints planetarios
`/v1/disposition-chains`	20	Cadenas de disposición (grafos de regencia)
`/v1/firdaria`	20	Períodos Firdaria
`/v1/profections`	20	Profecciones anuales
`/v1/planetary-phases`	20	Fases orientales/occidentales
`/v1/receptions`	20	Recepciones mutuas

Ejemplo

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 r = await fetch('https://api.astroway.info/v1/chart', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  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 r.json();
console.log(`ASC: ${chart.houses.ascendant.toFixed(2)}° MC: ${chart.houses.mc.toFixed(2)}°`);

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(f"ASC: {chart['houses']['ascendant']:.2f}° MC: {chart['houses']['mc']:.2f}°")

<?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'];
printf("ASC: %.2f° MC: %.2f°\n", $chart['houses']['ascendant'], $chart['houses']['mc']);

Quién lo usa

Aplicaciones astrológicas: aplicaciones web y móviles con construcción de cartas
Agentes de IA: a través del servidor MCP o /interpret/natal para interpretaciones de IA
Investigadores: cálculos masivos para estudios estadísticos
Plataformas de contenido: cartas natales como una característica sobre un producto existente