Temi Natali
Calcola temi natali completi con posizioni planetarie, cuspidi delle case e aspetti.
Calcolo di Base
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"
}
}'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));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- Kochequal- Case Ugualiwhole- Segni Intericampanus- Campanusregiomontanus- Regiomontanusporphyry- Porfirio
Risposta
{
"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
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:
{
"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.
Declinazione
Un tema natale è una proiezione sull'eclittica e quindi non dice nulla su quanto a nord o a sud dell'equatore celeste si trovi un corpo. Dalla versione API 2026-09-10 in poi, ogni punto qui sopra porta anche declination e outOfBounds, così che una ruota possa marcare un corpo che sta oltre la declinazione massima del Sole senza una seconda chiamata.
Paralleli, contro-paralleli e le date di fuori limite lungo un periodo stanno su endpoint propri — vedi Declinazioni.
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
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
{
"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.