Lunar Return API

Το endpoint lunar-return διαβάζει το ακριβές γεωγραφικό μήκος της Σελήνης από τα παρεχόμενα δεδομένα γέννησης, μετά ψάχνει μπροστά από την ημερομηνία έναρξης για την πρώτη στιγμή που η τρέχουσα Σελήνη επιστρέφει στο ίδιο μήκος. Επειδή η Σελήνη ολοκληρώνει έναν sidereal κύκλο περίπου κάθε 27.3 ημέρες, αυτή η επιστροφή είναι περίπου μηνιαία. Το endpoint μετατρέπει τη στιγμή σε Julian day, παίρνει γεωκεντρικές θέσεις και ταχύτητες από τη μηχανή Swiss Ephemeris, και δημιουργεί ένα full chart – επιστρεφόμενους πλανήτες με signs και house placements, house cusps, και το complete aspect grid με applying και separating flags και exact orbs. Από προεπιλογή το chart είναι για το natal place, αλλά μπορείς να δώσεις άλλη latitude και longitude για να μετακινήσεις την επιστροφή, που αλλάζει τις angles και τα houses ενώ κρατά την ίδια στιγμή. Το αποτέλεσμα είναι ένας emotional και rhythmic theme map για το επόμενο lunar month.

curl -X POST https://api.astroway.info/v1/lunar-return \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "afterDate": "2026-06-15"
}'

{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Moon",
        "longitude": 282.7,
        "sign": "Capricorn",
        "house": 6
      }
    ],
    "houses": {
      "ascendant": 201.5,
      "mc": 110.3,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      "…"
    ]
  }
}

Χρησιμοποίησε το lunar return για σύντομες, περίπου μηνιαίες προβλέψεις – μια λειτουργία 'lunar month ahead', έναν emotional-rhythm tracker, ή έναν πιο λεπτομερή σύντροφο του ετήσιου solar return. Όπου το solar return καλύπτει ολόκληρο το έτος, το lunar return καλύπτει τις επόμενες τέσσερις εβδομάδες, κάνοντάς το ιδανικό για επαναλαμβανόμενες μηνιαίες αναφορές και κύκλους συνήθειας ή διάθεσης. Δώσε την start date ως το σημείο που θέλεις την επόμενη επιστροφή – συχνά σήμερα ή την ημερομηνία της τελευταίας επιστροφής – και το endpoint προχωρά μπροστά στην επόμενη. Η προαιρετική location override σου επιτρέπει να φτιάξεις το return για όπου βρίσκεται το άτομο εκείνο το μήνα αντί για το birthplace, κάτι που μετράει για τα angle-sensitive houses. Συνέχισε διαδοχικές κλήσεις για να χτίσεις μια rolling σειρά από monthly charts.

Το endpoint επιστρέφει την επόμενη μοναδική επιστροφή στην ή μετά την δεδομένη ημερομηνία, όχι σειρά – κάλεσέ το επανειλημμένα, προωθώντας την start date, για να φτιάξεις μια ακολουθία. Ο αριθμός ~27.3-ημέρες είναι το sidereal month, οπότε οι επιστροφές μετατοπίζονται σε σχέση με το calendar. Αν δεν δοθεί location, το chart γίνεται στο natal place· ένα override μετακινεί μόνο τις angles και τα houses. Tropical zodiac και Swiss Ephemeris παντού.