Παντσανγκ (βεδική αλμανάχ)

Panchang (पञ्चाङ्ग, “πέντε μέρη”) είναι ένα ιεραρχικό αλμανάχ για μια συγκεκριμένη ημέρα και γεωγραφία. Πέντε κύρια συστατικά (tithi, vara, nakshatra, yoga, karana) καθορίζουν την ευνοϊκότητα του χρόνου για ενέργειες – από γάμο μέχρι την εκκίνηση προϊόντος. AstroWay καλύπτει όλα τα πέντε συν τα επιπλέον χρονικά διαστήματα (choghadia, hora, rahu-kaal) με ένα API.

Τι υπολογίζουμε

• Tithi (μηνιαία ημέρα): 30 tithi σε συνδική κύκλο, κάθε μία 12° διαφορά Σελήνη–Ήλιος. Κύριος δείκτης για τις περισσότερες μυχουρτ.
• Karana (μισή tithi): 11 karana, κάθε μία 6° μήκος. Κατατάσσουν τη δραστηριότητα της ημέρας.
• Yoga (σύνδεση): 27 yoga, άθροισμα των μηκών Ήλιου και Σελήνης, διαιρεμένο σε 13°20’. Ενεργειακό χαρακτηριστικό της ημέρας.
• Nakshatra-of-day: κύρια αστρική θέση για την ημερομηνία (με ένδειξη μετάβασης αν μέσα στην ημέρα υπάρχει περισσότερη από μία).
• Choghadia: 8 ημερομηνιακές + 8 νυχτερινές θέσεις των 1,5 ώρας, με ετικέτες “Amrit / Shubh / Labh / Char” (ευνοϊκές) και “Kaal / Rog / Udveg” (μη ευνοϊκές).
• Hora: πλανητικές ώρες (ιεραρχική εκδοχή, από την ανατολή του Ήλιου, 24 hora περίπου 1 ώρα η καθεμία).
• Rahu Kaal: μη ευνοϊκό διάστημα (1/8 της ημέρας φωτός, εξαρτάται από την ημέρα της εβδομάδας).
• Full panchang: όλα τα παραπάνω σε ένα αίτημα (βολικό για το daily widget).

Τελικά σημεία

Endpoint	Credits	Τι επιστρέφει
/v1/vedic/panchang/tithi	20	Τρέχον tithi + στιγμή μετάβασης στο επόμενο
/v1/vedic/panchang/karana	20	Τρέχουσα karana + μετάβαση
/v1/vedic/panchang/yoga	20	Τρέχουσα yoga + μετάβαση
/v1/vedic/panchang/nakshatra-of-day	20	Nakshatra της ημέρας + pada + μετάβαση
/v1/vedic/panchang/choghadia	20	16 θέσεις (8 ημέρα + 8 νύχτα) με ετικέτες
/v1/vedic/panchang/hora	20	24 πλανητικές ώρες
/v1/vedic/panchang/rahu-kaal	20	Διαστήματα Rahu/Yama/Gulika Kaal
/v1/vedic/panchang/full	20	Όλα τα παραπάνω σε μία απάντηση

Παράδειγμα

cURL

curl -X POST https://api.astroway.info/v1/vedic/panchang/full \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-05-11",
    "time": "06:00:00",
    "timezoneOffset": 5.5,
    "latitude": 28.6139,
    "longitude": 77.2090,
    "ayanamsa": "lahiri"
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/vedic/panchang/full', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '2026-05-11',
    time: '06:00:00',
    timezoneOffset: 5.5,
    latitude: 28.6139,
    longitude: 77.2090,
    ayanamsa: 'lahiri',
  }),
});
const { data } = await r.json();
console.log(`Tithi: ${data.tithi.name}, Nakshatra: ${data.nakshatra.name}`);
console.log(`Rahu Kaal: ${data.rahuKaal.startTime} - ${data.rahuKaal.endTime}`);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/vedic/panchang/full',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '2026-05-11', 'time': '06:00:00', 'timezoneOffset': 5.5,
        'latitude': 28.6139, 'longitude': 77.2090,
        'ayanamsa': 'lahiri',
    },
)
data = r.json()['data']
print(f"Tithi: {data['tithi']['name']}, Nakshatra: {data['nakshatra']['name']}")

Παράδειγμα απάντησης

{
  "jd": 2461171.520833,
  "ayanamsa": 24.225277,
  "sunrise": "05:33:04",
  "sunset": "19:02:21",
  "tithi": {
    "number": 24,
    "name": "Navami",
    "paksha": "krishna",
    "indexInPaksha": 9,
    "elongation": 283.301369,
    "percentComplete": 0.608447
  },
  "vara": { "number": 1, "name": "Somavara", "ruler": "Moon" },
  "karana": { "index": 48, "name": "Garaja", "isFixed": false },
  "yoga": { "number": 2, "name": "Priti", "sumLongitude": 23.999794 },
  "nakshatra": {
    "number": 24,
    "name": "Shatabhisha",
    "ruler": "Rahu",
    "startDeg": 306.6667,
    "endDeg": 320,
    "pada": 1,
    "longitude": 309.423644
  },
  "rahuKaal": { "name": "Rahu Kaal", "weekdaySlot": 2, "startHour": 7.237123, "endHour": 8.923138, "startTime": "07:14:14", "endTime": "08:55:23" },
  "yamaganda": { "name": "Yamaganda", "weekdaySlot": 4, "startHour": 10.609153, "endHour": 12.295168, "startTime": "10:36:33", "endTime": "12:17:43" },
  "gulika": { "name": "Gulika", "weekdaySlot": 6, "startHour": 13.981183, "endHour": 15.667198, "startTime": "13:58:52", "endTime": "15:40:02" },
  "abhijitMuhurat": { "startHour": 11.845564, "endHour": 12.744772, "midHour": 12.295168, "muhurtaMinutes": 53.952481, "startTime": "11:50:44", "endTime": "12:44:41" }
}

Ακρίβεια και πηγές

• Κανονικό κείμενο: Surya Siddhanta (για tithi/karana/yoga), Brihat Samhita (για choghadia/muhurta), Phaladipika (για hora). Υπολογισμοί της αληθινής Σελήνης με Swiss Ephemeris (DE441/440), όχι μέσου – είναι κρίσιμο για τις μεταβάσεις tithi (η διαφορά μπορεί να φτάσει έως 3 ώρες).
• Reference cross-check: drikpanchang.com - η μεγαλύτερη δημόσια πηγή panchang. Οι μεταβάσεις tithi/nakshatra μας ταιριάζουν με το drikpanchang εντός ±30 δευτερολέπτων για Lahiri ayanamsa.
• Choghadia: χρησιμοποιούμε την κλασική σειρά των 7 πλανητικών κυβερνητών. Η πρώτη θέση της ημέρας = κυβερνήτης της ημέρας της εβδομάδας (Κυριακή – Ήλιος κλ.).
• Rahu Kaal: σταθερά 1/8 διαστήματα από την ανατολή μέχρι τη δύση του Ήλιου, χάρτης ημέρας εβδομάδας → αριθμός θέσης κατά την κλασική (Δευτέρα = 2η, Τρίτη = 7η, κλ.).
• Το σημείο παρατήρησης έχει σημασία. Η Nakshatra και το tithi αλλάζουν την ίδια στιγμή UTC παντού – αλλά οι ορατές ημερομηνίες εξαρτώνται από τη ζώνη ώρας. Στείλε το timezoneOffset του ακριβούς τόπου όπου ο χρήστης θέλει να διαβάσει το panchang.

Συμβουλή

Daily widget pattern. Για το widget “panchang για σήμερα” κάλεσε /v1/vedic/panchang/full μία φορά την ημέρα (μεσάνυχτα κατά τη TZ του χρήστη) με τις ίδιες συντεταγμένες. Cache για 24 ώρες. 20 credits × 30 ημέρες = 600 credits/μήνα ανά χρήστη – χωράει στο Indie πακέτο.

Σχετικό

• Δασί: μακροπρόθεσμες περίοδοι (για χρόνια/δεκαετίες), panchang – βραχυπρόθεσμες (για ημέρα)
• Shadbala: η δύναμη των πλανητών τη στιγμή του panchang
• Vargas: divisional charts για πιο βαθιά ανάλυση της μούρθι
• Ακρίβεια: snapshot-τεστ του panchang εναντίον drikpanchang
• Credits: πλήρης πίνακας τιμών
• Αυθεντικοποίηση: πώς να πάρεις το κλειδί aw_live_*