अनुप्रयोग-निर्देश-पुस्तकम्
Anuprayoga-nirdeśa-pustakam
A sovereign-Bhāratīya REST surface — twelve live endpoints, machine-checked against JPL Horizons.
The Bharat Ephemeris API is the same engine that powers every chart, every pañcāṅga, every utsava on this site — exposed as a stateless REST surface. No Astrodienst dependency, no Swiss Ephemeris fallback, no upstream foreign authority anywhere in the numeric chain. Every output is independently verifiable against JPL Horizons over a 200-year window; every algebraic claim carries a Tier-S or Tier-W tag deposited at Zenodo DOI 10.5281/zenodo.20024273.
Built for engineers and product leads who need an integration they can audit. The surface is small on purpose: twelve endpoints, each with a single, named purpose. Computational routes (chart · pañcāṅga · utsava · rectify · dispatch) carry the Tier-S badge — they return only what (R, g, k) actually says. Witness routes (sahaja · press · rss · indexnow) carry Tier-W — outreach surfaces, machine-readable fact-sheets, no structural claims.
The four licence tiers below are the only commercial knobs. AGPL-3.0 stays free forever for AGPL-compatible builds. Closed-source builds need a Commercial annual licence scaled to user-count. Institutional and Enterprise tiers include white-label deployment, paramparā-config, and a direct engineering line — the engine source remains sovereign-Bhāratīya across all four.
Open Source
Commercial
Institutional
Enterprise
/api/chartFull janma-kuṇḍalī computation. Returns the SovereignChart: 9 grahas, 12 bhāvas, 16 vargas, KP sub-lord ladder, Vimśottarī daśā tree, ṣaḍ-bala, jaimini-kāraka assignment.
Input: BirthChartInput {date, time, lat, lon, tz, ayanamsa?}. Stateless · no persistence · no telemetry.
curl -X POST https://lunarluxury.in/api/chart -H 'Content-Type: application/json' \
-d '{"date":"1990-08-15","time":"04:32","lat":28.61,"lon":77.21,"tz":"Asia/Kolkata"}'/api/panchangLive 5-limb pañcāṅga for the current instant: vāra · tithi · nakṣatra · yoga · karaṇa, plus Sun + Moon longitudes against Lahirī ayanāṃśa.
Accepts no query parameters — historical pañcāṅga is out of scope. Use /api/utsavas for festival dates, /api/chart for any other moment.
curl https://lunarluxury.in/api/panchang
/api/utsavasVedic festival calendar for any year between 1900 and 2100. Deterministic — same inputs always return the same dates.
Required query: ?year=YYYY. Edge cache: 1 hour. Returns count + utsavas[] with date, tithi, nakṣatra, śāstra anchor.
curl 'https://lunarluxury.in/api/utsavas?year=2026'
/api/rectifyBirth-time rectification by reverse-fit. Submit a window (±N hours), a list of past events (marriage · loss · relocation · promotion · childbirth), receive the top 3-5 candidate moments ranked by Vimśottarī congruence.
Reverse-fit only — never issues a future prediction (Truth #5). No persistence.
curl -X POST https://lunarluxury.in/api/rectify -H 'Content-Type: application/json' \
-d '{"approx":"1985-03-12T11:00:00+05:30","windowMinutes":120,"lat":19.07,"lon":72.88, \
"events":[{"date":"2012-06-04","category":"marriage"}]}'/api/sahajaMulti-turn śāstric counsel. The model is permitted to call /api/chart, /api/panchang, /api/utsavas as tools mid-turn; never issues predictions; every reply is post-classified for prediction-slip and carries the Truth #5 disclaimer.
Accepts either legacy {message, history?} or modern {messages: [{role,content}, …]}. DEMO mode (no ANTHROPIC_API_KEY) returns canned guidance — useful for local dev.
curl -X POST https://lunarluxury.in/api/sahaja -H 'Content-Type: application/json' \
-d '{"messages":[{"role":"user","content":"Explain Saturn through the 7th in Kanyā lagna."}]}'/api/operator/dispatchOperator dispatch surface — α-gate · mukha selection · bridge probe · handler · handshake. Returns the full OperatorResponse envelope so external systems can inspect framework behaviour.
Open · 30 req/hr/IP via in-memory bucket. No predictions, no stored user data, no external calls by default.
curl -X POST https://lunarluxury.in/api/operator/dispatch -H 'Content-Type: application/json' \
-d '{"mukha":"east","intent":"probe","payload":{}}'/api/operator/dispatchOperator handshake status. Read-only echo of α-time, current mukha, bridge availability — useful for liveness probes.
No side effects · no rate limit.
curl https://lunarluxury.in/api/operator/dispatch
/api/pressMachine-readable PRESS_FACTS — every fact, number, DOI, quote, founder bio, asset URL in one stable JSON object. Useful for newsrooms, citation tools, and CMS sync.
Edge cache: 6 hours · CORS: open to '*' · revalidates on redeploy.
curl https://lunarluxury.in/api/press
/api/rssMeta-feed listing every Bharat Ephemeris RSS surface. Aggregators subscribe here and auto-discover child feeds.
curl https://lunarluxury.in/api/rss
/api/rss/dailyDaily pañcāṅga feed — one item per day with vāra · tithi · nakṣatra · yoga · karaṇa and the day's principal utsava if any.
curl https://lunarluxury.in/api/rss/daily
/api/indexnowIndexNow ping proxy. Notifies Bing + Yandex (and partners) the instant new content publishes, instead of waiting for the next crawl pass.
Accepts {urlList: string[]} POST body, or pings the homepage + top 10 routes on bare GET.
curl -X POST https://lunarluxury.in/api/indexnow -H 'Content-Type: application/json' \
-d '{"urlList":["https://lunarluxury.in/substrate","https://lunarluxury.in/accuracy"]}'/api/indexnowIndexNow homepage helper — pings the apex + top 10 routes with one call. Used by the daily build pipeline.
curl https://lunarluxury.in/api/indexnow
Every endpoint is public by default. CORS is opened to * on /api/press, /api/rss, and the RSS children so external newsrooms and aggregators can fetch directly.
Two POST routes carry a per-IP hourly bucket. POST /api/chart permits three unauthenticated computations per hour — past that, send x-bharat-key: <commercial-key> in the request header. POST /api/sahaja follows the same pattern. POST /api/operator/dispatch is capped at thirty requests per hour per IP via an in-memory bucket — no key required, no quota carryover.
Every 429 response includes a Retry-After header with the cooldown in seconds. Back off, replay, continue — the bucket refills on the wall clock, not on the request stream.
Every error response carries the same envelope: { error: code, message: string, hint?: string, incidentId?: string }. HTTP semantics are preserved — no 200 wrappers around failures. Idempotent retries are safe on every GET route and on POST /api/chart + POST /api/rectify (same input always yields the same output).
Bad input
Required field missing or out of range. Response includes per-field hints — read the `hint` key, fix, retry.
Missing key
Rate-limited route called past the unauthenticated quota. Provide x-bharat-key header (commercial tier).
Quota exceeded
Per-IP hourly bucket consumed. Response carries Retry-After (seconds) — back off and replay.
Substrate fault
Engine fault during computation. Response includes an incident-id — quote it when emailing support@.
Every numeric output is reproducible against JPL Horizons over a 200-year window. The quarterly bake-off (1,000 dates × 9 grahas) lives at /accuracy with raw residuals, p50, p95, and per-graha Tier-S/Tier-W verdicts. Bharat beats Swiss on six of seven grahas; the seventh (Moon, 0.47″ p95) carries an open improvement track published at /research.
The algebraic substrate is deposited at Zenodo DOI 10.5281/zenodo.20024273 — 890 propositions, 775/775 machine-checked, every claim wears a Tier-S algebraic tag (i)–(ix) or a Tier-W witness tag. Reproducible proof scripts ship in the kaal-sacred-discovery sister-repo under CC BY 4.0 + AGPL.
Open-source friendly
Run the engine inside any AGPL-3.0 compatible project. Your derivative source remains open and AGPL-licenced. Free forever, no royalty, no per-call meter. Suitable for research mirrors, peer-review reproductions, academic syllabi, and AGPL applications.
Closed-source builds
Ship the engine inside a proprietary product without opening your derivative. Annual fee scaled to active user-count — write to developers@bharatephemeris.in with your platform name, user-count band, and integration surface. Quotes returned the same week.
Building on top of Bharat Ephemeris?
We deliver Institutional and Enterprise tiers as white-label deployments — paramparā-config, sovereign infrastructure, direct engineering line, scoped SLA. Universities, observatories, banks, broadcasters, and regulators welcome.