API Documentation

Quick Start

From zero to astrology data in under a minute.

Register

curl -X POST https://api.moon-bot.cc/register \ -H "Content-Type: application/json" \ -d '{"email": "[email protected]", "name": "My App"}'

import requests resp = requests.post("https://api.moon-bot.cc/register", json={ "email": "[email protected]", "name": "My App" }) data = resp.json() api_key = data["api_key"]

const resp = await fetch("https://api.moon-bot.cc/register", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "[email protected]", name: "My App" })
});
const { api_key } = await resp.json();

Get Panchanga

curl -X POST https://api.moon-bot.cc/panchanga \
  -H "X-API-Key: pnc_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-03-17T12:00:00+05:30","latitude":28.6139,"longitude":77.2090}'

# Returns: tithi, nakshatra, yoga, karana, vara, inauspicious_periods

import requests

resp = requests.post("https://api.moon-bot.cc/panchanga",
    json={"datetime": "2026-03-17T12:00:00+05:30",
          "latitude": 28.6139, "longitude": 77.2090},
    headers={"X-API-Key": api_key})
data = resp.json()
print(data["tithi"]["name"])  # e.g. "Dvadashi"

const res = await fetch("https://api.moon-bot.cc/panchanga", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": api_key },
  body: JSON.stringify({
    datetime: "2026-03-17T12:00:00+05:30",
    latitude: 28.6139, longitude: 77.2090
  })
});
const data = await res.json();
console.log(data.tithi.name); // e.g. "Dvadashi"

Get a Birth Chart

curl -X POST https://api.moon-bot.cc/kundali \
  -H "X-API-Key: pnc_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-06-15T14:30:00+05:30",
    "latitude": 28.6139,
    "longitude": 77.2090
  }'

# Returns: lagna, planets, houses, aspects, yogas, doshas, ashtakavarga

import requests

resp = requests.post("https://api.moon-bot.cc/kundali",
    headers={"X-API-Key": api_key},
    json={"datetime": "1990-06-15T14:30:00+05:30",
          "latitude": 28.6139, "longitude": 77.2090})
chart = resp.json()
print(chart["lagna"]["rashi"])  # e.g. "Kanya"

const res = await fetch("https://api.moon-bot.cc/kundali", {
  method: "POST",
  headers: {
    "X-API-Key": api_key,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    datetime: "1990-06-15T14:30:00+05:30",
    latitude: 28.6139, longitude: 77.2090
  })
});
const chart = await res.json();
console.log(chart.lagna.rashi); // e.g. "Kanya"

Endpoint Reference

Complete endpoint reference with request/response examples.

Chart Tools

POST /kundali 3 credits

Generate a full Vedic birth chart (Kundali) with planetary positions, house placements, Lagna, Ayanamsha, aspects, and strengths.

Request

{
  "datetime": "1990-06-15T14:30:00+05:30",
  "latitude": 28.6139,
  "longitude": 77.2090
}

Response (abbreviated)

{
  "lagna": {
    "longitude": 177.86, "rashi": "Kanya",
    "degree_in_rashi": 27.86, "nakshatra": "Chitra"
  },
  "planets": [
    { "planet": "sun", "rashi": "Vrishabha", "house": 9, "dignity": "neutral" },
    { "planet": "moon", "rashi": "Kumbha", "house": 6, "dignity": "neutral" },
    ...
  ],
  "houses": [ ... ]
}

POST /compatibility 5 credits

Ashtakoot Guna matching between two birth charts. Returns compatibility score (0-36), individual Koot scores, and recommendation.

Request

{
  "groom_datetime": "1990-06-15T14:30:00+05:30",
  "groom_latitude": 28.6139,
  "groom_longitude": 77.2090,
  "bride_datetime": "1992-03-22T09:15:00+05:30",
  "bride_latitude": 19.0760,
  "bride_longitude": 72.8777
}

POST /vargas 3 credits

Divisional charts (D-1 through D-60). Returns planetary positions in all requested divisional charts for detailed analysis.

POST /shadbala 3 credits

Six-fold planetary strength analysis: Sthana Bala, Dig Bala, Kala Bala, Cheshta Bala, Naisargika Bala, and Drig Bala for all planets.

POST /bhava-chalit 3 credits

Bhava Chalit chart with cusp positions. Shows actual house boundaries based on mid-point calculation, revealing which house each planet truly occupies.

POST /kp 3 credits

Krishnamurti Paddhati (KP) chart with sub-lord positions, cuspal sub-lords, and significator analysis. A unique feature for KP astrology practitioners.

Request

{
  "datetime": "1990-06-15T14:30:00+05:30",
  "latitude": 28.6139,
  "longitude": 77.2090
}

Prediction Tools

POST /dasha 2 credits

Vimshottari Dasha periods from Mahadasha down to Pratyantardasha level. Precise start and end dates for every planetary period cycle.

POST /transits 2 credits

Current planetary transits overlaid on the natal chart. Shows which natal houses and planets are activated by current planetary positions.

POST /prashna 2 credits

Horary (Prashna) astrology chart cast for the current moment. Used for answering specific questions based on the chart at the time of asking.

POST /varshaphal 2 credits

Solar return (Varshaphal) chart for yearly predictions. Calculates the chart for the exact moment the Sun returns to its natal position each year.

Analysis Tools

GET /panchanga 1 credit

Complete daily Vedic almanac. Returns all five elements (Tithi, Nakshatra, Yoga, Karana, Vara) with transition times, qualities, and astronomical data.

Request

GET /panchanga?date=2026-03-16&latitude=28.6139&longitude=77.2090

POST /panchanga/search 5 credits

Search for dates matching a specific combination of Panchanga parameters. Find the nearest date when tithi=Ekadashi AND vara=Thursday, or any combination. A unique feature -- no other API offers parametric Panchanga search.

Request

{
  "latitude": 28.6139,
  "longitude": 77.2090,
  "after": "2026-03-16T00:00:00+05:30",
  "criteria": {
    "tithi": "Ekadashi",
    "vara": "Thursday"
  },
  "max_results": 3
}

POST /muhurta 1 credit

Find auspicious time windows for events. Evaluates Tithi, Nakshatra, Yoga, Karana, and planetary positions to score quality of each window.

GET /choghadiya 1 credit

Choghadiya muhurta divisions and Hora planetary hours for a given date and location.

POST /remedies 3 credits

Personalized Vedic remedies and Upaya recommendations based on birth chart analysis. Suggests gemstones, mantras, charities, and rituals for planetary afflictions.

POST /pancha-pakshi new 2 credits

Pancha Pakshi Shastra -- the ancient Tamil timing system based on five birds (Vulture, Owl, Crow, Cock, Peacock). Returns the ruling bird for your birth nakshatra, current activity state (ruling, eating, walking, sleeping, dying), and optimal timing windows for the day.

Request

{
  "datetime": "1990-06-15T14:30:00+05:30",
  "latitude": 28.6139,
  "longitude": 77.2090,
  "query_datetime": "2026-03-16T10:00:00+05:30"
}

Response (abbreviated)

{
  "birth_bird": "Peacock",
  "current_activity": "Ruling",
  "current_period": {
    "bird": "Peacock",
    "activity": "Ruling",
    "start": "2026-03-16T06:15:00+05:30",
    "end": "2026-03-16T08:39:00+05:30",
    "quality": "excellent"
  },
  "day_periods": [ ... ],
  "night_periods": [ ... ]
}

Data Tools

GET /ephemeris 1 credit

Planetary positions for a given date. Returns longitude, latitude, speed, retrograde status, and rashi for all 9 Vedic planets.

POST /panchanga/range 1 cr/day

Panchanga data for a date range (up to 31 days per request). Returns an array of daily Panchanga entries with all five elements.

GET /festivals/{year} 10 credits

Hindu festival calendar for a given year. Dates are astronomically computed from planetary positions, not from static lookup tables.

GET /vrata 5 credits

Religious observance and fasting (Vrata) calendar. Returns Ekadashi, Pradosh, Chaturthi, Amavasya, Purnima, and other Vrata dates with astronomical precision.

New in v4.2

POST /aspects new 3 credits

Calculate planetary aspects: Parashari Graha Drishti (house-based, 25/50/75/100% strength), Jaimini Rashi Drishti (sign-based), and mutual aspect detection. Special aspects for Mars (4th/8th), Jupiter (5th/9th), Saturn (3rd/10th).

Request

{
  "datetime": "1990-06-15T14:30:00+05:30",
  "latitude": 28.6139,
  "longitude": 77.2090
}

Response (abbreviated)

{
  "graha_drishti": [
    { "from": "Mars", "to": "Moon", "type": "special", "strength_pct": 100 },
    ...
  ],
  "rashi_drishti": [ ... ],
  "mutual_aspects": [ ... ]
}

POST /upagrahas new 2 credits

Calculate all 11 Upagrahas (sub-planets) per BPHS. Sun-based (5): Dhuma, Vyatipata, Parivesha, Indrachapa, Upaketu. Time-based (6): Gulika, Mandi, Kaala, Mrityu, Ardhaprahara, Yamaghantaka. Each returns longitude, sign, and nakshatra.

Request

{
  "datetime": "1990-06-15T14:30:00+05:30",
  "latitude": 28.6139,
  "longitude": 77.2090
}

Response (abbreviated)

{
  "sun_based": [
    { "name": "Dhuma", "longitude": 196.42, "sign": "Tula", "nakshatra": "Swati" },
    ...
  ],
  "time_based": [
    { "name": "Gulika", "longitude": 87.15, "sign": "Mithuna", "nakshatra": "Punarvasu" },
    ...
  ]
}

POST /kp/ruling-planets new 1 credit

Calculate the 5 KP ruling planets for the current moment: Ascendant sign lord, Ascendant star lord, Moon sign lord, Moon star lord, and Day lord. Essential for KP horary (Prashna) analysis and number-based predictions.

Request

{
  "datetime": "2026-03-17T10:30:00+05:30",
  "latitude": 28.6139,
  "longitude": 77.2090
}

Response (abbreviated)

{
  "ruling_planets": {
    "ascendant_sign_lord": "Venus",
    "ascendant_star_lord": "Mercury",
    "moon_sign_lord": "Jupiter",
    "moon_star_lord": "Saturn",
    "day_lord": "Mars"
  }
}

Webhooks

POST /webhooks/subscribe new 1 credit

Subscribe to astrological event notifications. Get webhook callbacks for eclipses, Ekadashi, retrogrades, Purnima, Amavasya, and 10 event types.

Request

{
  "url": "https://your-app.com/webhook",
  "events": ["ekadashi", "eclipse", "retrograde"],
  "latitude": 28.6139,
  "longitude": 77.2090
}

GET /webhooks new free

List your active webhook subscriptions. Returns all registered URLs and event types.

DELETE /webhooks/{id} new free

Unsubscribe from a webhook. Removes the subscription and stops all future event deliveries.

Account

POST /register free

Create a new account and receive an API key. Free tier gives 2 requests per day. Supports email or Telegram registration.

GET /account free

Check your current account balance, usage statistics, and tier information. Requires X-API-Key header.

POST /verify free

Verify your account using the code from email or Telegram. Returns your activated API key on success.

POST /topup free

Add credits to your account via payment hash verification. Supports Telegram Stars and NOWPayments crypto transactions.

OpenAPI Spec (JSON)

Quick Start

Register

Get Panchanga

Get a Birth Chart

24 Endpoints

Endpoint Reference