एक endpoint। पूरा 75-वर्षीय फ़ारसी चक्र, L1 मुख्य अवधियों और L2 sub-periods के साथ। Sect chart से detect होता है, manual flag से नहीं।
ज़्यादातर apps जो Firdaria use करते हैं वे ये भी use करते हैं
Production में हम जो numbers measure करते हैं
Developers के लिए designed, desktop UIs के लिए नहीं
Abu Ma'shar की 9वीं शताब्दी की तकनीक, JSON के रूप में
Firdaria (जिसे alfridaria, fardar, या firdar भी कहते हैं) एक फ़ारसी time-lord system है जो जीवन को ग्रह अवधियों में बाँटती है। यह वैदिक विम्शोत्तरी दशा नहीं है — यह पूरी तरह से अलग पारंपरिक पश्चिमी/फ़ारसी तकनीक है। Abu Ma'shar ने इसे 9वीं शताब्दी में describe किया, Bonatti ने 13वीं में reference किया, और Vivian Robson ने 20वीं शताब्दी में English-language astrologers के लिए इसे summarize किया। Day charts 75-वर्षीय चक्र चलाते हैं जो Sun से शुरू होता है। Night charts Moon से शुरू होते हैं और एक अलग planet order use करते हैं। हर मुख्य अवधि (L1) सात sub-periods (L2) में बाँटी जाती है, जो Chaldean order में rule की जाती हैं। हमारा API एक request से पूरा L1 + L2 cascade return करता है, birth data से सही sect pick करता है, और उन node अवधियों को include करता है जिन्हें ज़्यादातर implementations skip कर देती हैं। अगर आप medieval astrology app, traditional sources को quote करने वाला chatbot, या timing dashboard बना रहे हैं, तो यह math को re-implement किए बिना Firdaria add करने का सबसे तेज़ रास्ता है।
Firdaria किसी व्यक्ति के जीवन को L1 नामक ग्रह अवधियों में बाँटती है, फिर हर L1 को सात L2 sub-periods में split करती है। Day charts Sun से शुरू होते हैं: Sun 10 साल, Venus 8, Mercury 13, Moon 9, Saturn 11, Jupiter 12, Mars 7, फिर Mean Node और South Node 3 + 2 साल share करते हैं। इन्हें जोड़ें तो 75 साल मिलते हैं। Night charts Moon से शुरू होते हैं और एक अलग order में चलते हैं: Moon 9, Saturn 11, Jupiter 12, Mars 7, Sun 10, Venus 8, Mercury 13, फिर nodes। Total वही है। हर L1 अवधि सात बराबर L2 chunks में split होती है, जो Chaldean order में rule होती हैं (Saturn, Jupiter, Mars, Sun, Venus, Mercury, Moon), उस planet से शुरू होकर जो L1 को rule करता है। Nodes को L2 split नहीं मिलता। यह परंपरा है, bug नहीं। ध्यान दें — यह वैदिक विम्शोत्तरी दशा से बिल्कुल अलग है: Vimshottari 120 साल का है और nakshatra पर anchored है; Firdaria 75 साल का है और sect पर निर्भर है।
Sect पारंपरिक ज्योतिष में day/night का distinction है। अगर जन्म के समय Sun horizon के ऊपर है, तो chart diurnal है। नीचे है, तो nocturnal। Firdaria sect का use करता है यह decide करने के लिए कि कौनसा sequence चलेगा। एक day chart जो गलती से night order use करता है, जीवन की हर अवधि के लिए गलत शासक return करेगा। हमारा API birth data से Sun का house position check करता है और automatically सही sequence पर route कर देता है। आप day_chart flag pass नहीं करते। Endpoint check करता है, response में sect: "diurnal" या sect: "nocturnal" return करता है, और आप इसे अपने UI में show कर सकते हैं। अगर आप override करना चाहें (twilight births, polar latitudes), तो underlying logic response में exposed है ताकि आप reason कर सकें।
एक L1 entry में planet ruler, years (2 से 13 तक का integer), start_date और end_date ISO strings के रूप में, एक node_period boolean, और एक l2_periods array होता है। L2_periods array non-node अवधियों के लिए सात entries रखता है और node अवधियों के लिए खाली होता है। हर L2 entry में planet, start_date, end_date होता है। Split बराबर है: 12 साल के L1 में सात L2 अवधियाँ लगभग 1.71 साल की मिलती हैं। हम 365.2422 दिन प्रति वर्ष (tropical year length) use करते हैं ताकि math वैसा ही हो जैसे astrologers normally Firdaria अवधियाँ count करते हैं। अगर आप endpoint को as_of_date के साथ call करते हैं, तो response में एक active object भी आता है जो बताता है कि उस date पर कौनसा L1 और कौनसा L2 चल रहा है। यह chat apps के लिए useful है जो answer देते हैं "अभी मैं किस अवधि में हूँ?"।
Profections ascendant को 12-वर्षीय चक्र में हर साल एक house आगे बढ़ाती हैं। Simple, अक्सर repeat होती हैं, context में हल्की। Zodiacal releasing fixed sign-based अवधियों से गुज़रती है L1, L2, L3, L4 में। बहुत भारी, और अवधियाँ fixed length पर loop करती हैं (जैसे Lot of Spirit Aries के लिए 8 साल)। वैदिक Vimshottari Dasha 120 साल cover करती है, जन्म के समय Moon की nakshatra पर anchored नौ अवधियों के साथ — यह पूरी तरह अलग system है। Firdaria profections और ZR के बीच में आता है: profections से लंबा, ZR से simpler, और Vimshottari की तरह sect-sensitive नहीं। बहुत से traditional astrologers profections + Firdaria + ZR एक साथ चलाते हैं। हमारा /timing/timeline endpoint चारों (profections, ZR, decennials, Firdaria) को एक merged timeline में aggregate करता है, तो आपके front end को चार calls stitch नहीं करनी पड़तीं।
Firdaria annual reports, life-phase overviews, और chatbot context के लिए अच्छी तरह काम करता है। L1 अवधि multi-year theme देती है ("Mars years") जिसके around copy लिखना आसान है। L2 sub-period कुछ महीनों से दो साल का tighter window देता है, जो predictive prompts के लिए अच्छा है। Firdaria को transit hits के साथ pair करें ताकि known अवधि के अंदर specific events को flag कर सकें। उदाहरण: "आप अपने Mars L1 / Saturn L2 sub-period में हैं, और Mars अगले महीने आपके natal Sun को square कर रहा है।" यह combo coaching tool में naturally पढ़ता है और LLM को structure देता है grounded response के लिए। Firdaria educational apps के लिए भी अच्छा fit है क्योंकि rules short और सीखने योग्य हैं, ZR के विपरीत जिसे background का एक chapter चाहिए।
Firdaria खुद hard math नहीं है। यह planet-year constants पर timedelta arithmetic है। मुश्किल हिस्सा surrounding system है: sect detection, polar-latitude edge cases, परंपरा से match करने वाला node handling, ISO date output जो years पर drift न करे, और year boundaries पर consistent behavior। हमारी service इन सब के against hardened है। यह 100+ अन्य endpoints के साथ भी ship होती है, तो अगर आपको बाद में natal charts, transits, profections, या solar returns चाहिए, तो आप दूसरी integration tax नहीं देते। Free tier हर महीने 50 requests देती है, paid plans $11/महीना से शुरू होते हैं। आप एक दोपहर में live हो सकते हैं।
Traditional astrologers की सेवा करने वाले tools जो पहले से Firdaria, profections, और ZR के साथ काम करते हैं। एक API, चार time-lord systems।
Firdaria का Persian-Indian crossover appeal है। दोनों audiences को target करने वाले apps के लिए इसे Vimshottari Dasha के साथ pair करें।
L1 + L2 + active-period context prompt में feed करें। Bot answer देता है "मेरी current अवधि क्या है?" बिना dates hallucinate किए।
Firdaria के rules short और सीखने योग्य हैं। Abu Ma'shar और Bonatti पर courses के लिए API को calculation backend के रूप में use करें।
PDF या web reports generate करें जो active L1 + L2 को date ranges के साथ दिखाते हैं। Customers को clear yearly narrative मिलता है।
Firdaria को profections और transits के साथ एक view में combine करें। Practitioners desktop apps के बीच tab-hopping बंद करते हैं।
| Endpoint | POST /api/v3/timing/firdaria |
| औसत Response | ~220ms |
| P95 Response | <400ms |
| चक्र की लंबाई | 75 साल (दिन और रात) |
| L1 अवधियाँ Return | 9 (7 ग्रह + 2 nodes) |
| L2 Sub-Periods | हर non-node L1 के 7 (Chaldean order) |
| Sect Detection | Sun house position से Automatic |
| वर्ष की लंबाई | 365.2422 दिन (tropical year) |
| Ephemeris | Swiss Ephemeris (swisseph) |
| Date Format | ISO 8601 (YYYY-MM-DD) |
| Active अवधि Lookup | Optional as_of_date parameter |
| Timeline Aggregation | /timing/timeline के via combined output |
| Rate Limit (Free) | 50 requests/महीना |
| Rate Limit (Business) | 220,000 requests/महीना |
| Feature | Astrology API | Others |
|---|---|---|
| L1 + L2 एक call में | हाँ | केवल L1 |
| Sect auto-detection | हाँ, chart से | Manual day/night flag |
| Node अवधियाँ शामिल | हाँ (Mean + South) | Skipped |
| Response time | ~220ms | 1-3 seconds |
| Combined timeline endpoint | हाँ (4 तकनीकें) | उपलब्ध नहीं |
| Date पर active अवधि | हाँ (as_of_date param) | Client-side compute |
| Free tier | 50 requests/महीना | केवल paid |
| Ephemeris backend | Swiss Ephemeris | Proprietary / unclear |
12-वर्षीय चक्र, वर्ष का शासक, Firdaria से हल्का।
वैदिक 120-वर्षीय time-lord चक्र। फ़ारसी audiences के लिए useful crossover।
हेलेनिस्टिक L1-L4 sign-based अवधियाँ। जल्द आ रहा है।
हेलेनिस्टिक 10-वर्षीय ग्रह अवधियाँ। जल्द आ रहा है।
Sect, triplicity rulers, almuten — Firdaria जिस पर खड़ा है वो foundation।
एक endpoint जो profections, Firdaria, ZR, और decennials को single timeline पर merged return करता है।
मुफ्त शुरू करें, बढ़ते हुए स्केल करें। कोई छिपी हुई फीस नहीं, कोई आश्चर्य नहीं।
छोटे ऐप्स और व्यक्तिगत परियोजनाओं के लिए
बढ़ते ऐप्स और मध्यम ट्रैफिक के लिए
एंटरप्राइज-स्केल अनुप्रयोगों के लिए
सभी योजनाओं में व्यापक दस्तावेज़ीकरण और SDK शामिल हैं
प्रश्न? हमारी टीम से बात करें
Developers जो actually पूछते हैं वो questions