Temi Natali

Calcola temi natali completi con posizioni planetarie, cuspidi delle case e aspetti.

Calcolo di Base

cURLJavaScriptPython

bash

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

javascript

const response = await fetch("https://api.astroapi.cloud/api/calc/natal", {
    method: "POST",
    headers: {
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        dateTime: "1990-06-15T14:30",
        location: {
            latitude: 51.5074,
            longitude: -0.1278,
            timezone: "Europe/London"
        }
    })
});

const data = await response.json();
console.log(JSON.stringify(data, null, 2));

python

import requests

response = requests.post(
    "https://api.astroapi.cloud/api/calc/natal",
    headers={
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    json={
        "dateTime": "1990-06-15T14:30",
        "location": {
            "latitude": 51.5074,
            "longitude": -0.1278,
            "timezone": "Europe/London"
        }
    }
)

print(response.json())

Parametri

Parametro	Tipo	Obbligatorio	Descrizione
`dateTime`	string	Sì	Data/ora nel formato YYYY-MM-DDTHH:mm
`location.latitude`	number	Sì	Latitudine (da -90 a 90)
`location.longitude`	number	Sì	Longitudine (da -180 a 180)
`location.timezone`	string	Sì	Identificatore di fuso orario IANA
`houseSystem`	string	No	Sistema delle case (predefinito: "placidus")
`moonCenter`	string	No	Centro di riferimento della Luna: `topocentric` (predefinito, corretto per la parallasse in base al luogo di nascita) o `geocentric` (centro della Terra). Influisce solo sulla Luna. Vedi Precisione dei Calcoli
`points`	array	No	Punti celesti da calcolare (vedi Punti Disponibili sotto)
`orbs`	object	No	Valori di orbita personalizzati per tipo di aspetto (es. `{ "conjunction": 8, "opposition": 6 }`)
`language`	string	No	Codice lingua per il contenuto testuale (predefinito: `"en"`)
`includeText`	boolean	No	Includi testo interpretativo (predefinito: `false`)
`includeReadableEntities`	boolean	No	Includi titoli leggibili delle entità (predefinito: `false`)

Sistemi delle Case

placidus - Placidus (predefinito)
koch - Koch
equal - Case Uguali
whole - Segni Interi
campanus - Campanus
regiomontanus - Regiomontanus
porphyry - Porfirio

Risposta

json

{
  "data": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "longitude": 84.5,
        "sign": "gemini",
        "signTitle": "Gemini",
        "degreesInSign": 24.5,
        "degreesInSignDms": [24, 30, 0],
        "houseNumber": 10,
        "houseId": "house-10",
        "retrograde": false,
        "pointTitle": "Sun",
        "houseTitle": "10th House"
      },
      "moon": {
        "pointId": "moon",
        "longitude": 245.2,
        "sign": "sagittarius",
        "signTitle": "Sagittarius",
        "degreesInSign": 5.2,
        "degreesInSignDms": [5, 12, 0],
        "houseNumber": 4,
        "houseId": "house-4",
        "retrograde": false,
        "pointTitle": "Moon",
        "houseTitle": "4th House"
      }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries" },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn" },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer" }
    },
    "houses": {
      "cusps": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 210.3, "longitudeDms": { "degrees": 210, "minutes": 18, "seconds": 0 }, "sign": "scorpio" }
      ],
      "ascmc": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 270.2, "longitudeDms": { "degrees": 270, "minutes": 12, "seconds": 0 }, "sign": "capricorn" }
      ]
    },
    "aspects": [
      {
        "pointA": "sun",
        "pointB": "moon",
        "aspect": "opposition",
        "angle": 160.7,
        "orb": 0.7,
        "applying": false,
        "pointATitle": "Sun",
        "pointBTitle": "Moon",
        "aspectTitle": "Opposition"
      }
    ],
    "chart": {
      "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..."
    }
  }
}

Cuspidi delle Case

Ogni oggetto cuspide include longitude (gradi eclittici), longitudeDms (gradi/minuti/secondi) e sign (ID del segno zodiacale). La prima cuspide (cusps[0]) è l'Ascendente. L'array ascmc contiene l'Ascendente, il MC, l'ARMC e il Vertex.

Punti Disponibili

Usa il parametro points per selezionare quali punti celesti calcolare. Se omesso, viene utilizzato il set predefinito.

Punti Predefiniti

sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, meanNode, trueNode, meanApogee, osculatingApog

Tutti i Punti Disponibili

Point ID	Descrizione
`sun`	Sole
`moon`	Luna
`mercury`	Mercurio
`venus`	Venere
`mars`	Marte
`jupiter`	Giove
`saturn`	Saturno
`uranus`	Urano
`neptune`	Nettuno
`pluto`	Plutone
`meanNode`	Nodo Nord Medio
`trueNode`	Nodo Nord Vero
`meanApogee`	Lilith Media (Luna Nera)
`osculatingApog`	Lilith Vera (Luna Nera)
`chiron`	Chirone
`pholus`	Folo
`ceres`	Cerere
`pallas`	Pallade
`juno`	Giunone
`vesta`	Vesta
`interpolatedLunarApogee`	Apogeo Lunare Interpolato
`interpolatedLunarPerigee`	Perigeo Lunare Interpolato (Priapo)
`earth`	Terra

Esempio: Calcola Solo Sole e Marte

bash

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "points": ["sun", "mars"]
  }'

La risposta conterrà sun e mars nell'oggetto points, e tutti e quattro gli angoli nell'oggetto angles:

json

{
  "data": {
    "points": {
      "sun": { "pointId": "sun", "longitude": 84.5, "sign": "gemini", ... },
      "mars": { "pointId": "mars", "longitude": 12.3, "sign": "aries", ... }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", ... },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", ... },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", ... }
    },
    "houses": { ... },
    "aspects": [ ... ]
  }
}

Angoli

Tutti e quattro gli angoli (ascendant, descendant, midheaven, imumCoeli) sono sempre inclusi nell'oggetto angles, indipendentemente dal parametro points. Gli angoli sono derivati dai calcoli delle case, non dall'effemeride, e hanno quindi una struttura più semplice (nessun dato di velocità o retrogradazione). L'array ascmc nella risposta houses contiene sempre anche le longitudini grezze degli angoli.

Luna & Sole

Calcola la fase lunare, l'illuminazione, gli orari di alba/tramonto e i dati sulla posizione del Sole.

POST `/api/calc/moon-sun`

bash

curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    }
  }'

Parametri

Parametro	Tipo	Obbligatorio	Descrizione
`dateTime`	string	Sì	Data/ora nel formato YYYY-MM-DDTHH:mm
`location.latitude`	number	Sì	Latitudine (da -90 a 90)
`location.longitude`	number	Sì	Longitudine (da -180 a 180)
`location.timezone`	string	Sì	Identificatore di fuso orario IANA

Modulo Richiesto

Questo endpoint richiede il modulo module:moon.

Risposta

json

{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

Precisione dei Calcoli

AstroAPI legge direttamente l'effemeride JPL DE442 della NASA per posizioni planetarie con precisione sub-milliarcsecondo. Consulta la pagina Precisione dei Calcoli per tutti i dettagli sulle nostre fonti dati e correzioni.

Temi Natali ​

Calcolo di Base ​

Parametri ​

Sistemi delle Case ​

Risposta ​

Punti Disponibili ​

Punti Predefiniti ​

Tutti i Punti Disponibili ​

Esempio: Calcola Solo Sole e Marte ​

Luna & Sole ​

POST /api/calc/moon-sun ​

Parametri ​

Risposta ​

Precisione dei Calcoli ​

Temi Natali

Calcolo di Base

Parametri

Sistemi delle Case

Risposta

Punti Disponibili

Punti Predefiniti

Tutti i Punti Disponibili

Esempio: Calcola Solo Sole e Marte

Luna & Sole

POST `/api/calc/moon-sun`

Parametri

Risposta

Precisione dei Calcoli