Complete daily panchang with tithi, nakshatra, yoga, karana, rahu kaal, abhijit muhurta, and 15 auspicious windows. One key. Location-aware. Roxy Ephemeris verified against NASA JPL Horizons.
The Panchang API returns a complete Hindu calendar (panchang) for any date and observer location. One call delivers all five limbs: Tithi (lunar day), Nakshatra (lunar mansion), Yoga, Karana, and Vara. It then adds sunrise, sunset, moonrise, moonset, Rahu Kaal, Yamaganda, Gulika Kaal, Abhijit Muhurta, Brahma Muhurta, Chandrabalam, Tarabalam, Varjyam, and Amrit Kalam. Powered by Roxy Ephemeris, verified against NASA JPL Horizons, and available through 12+ spiritual domains in one subscription. The Remote MCP server at https://roxyapi.com/mcp/vedic-astrology makes the panchang API instantly usable in Claude, Cursor, or any MCP-compatible agent.
| Property | Value |
|---|---|
| Coverage | 12+ spiritual domains in one subscription |
| Calculation | Roxy Ephemeris, verified against NASA JPL Horizons |
| MCP server | https://roxyapi.com/mcp/vedic-astrology (Streamable HTTP, no local setup) |
| SDKs | TypeScript on npm @roxyapi/sdk, Python on PyPI roxy-sdk, PHP on Packagist roxyapi/sdk, C# on NuGet RoxyApi.Sdk, Go github.com/RoxyAPI/sdk-go, WordPress plugin roxyapi |
| Pricing | One key, flat per call, from $39/mo |
| Licensing | Personal and commercial use, including closed source apps. No AGPL or GPL entanglement. Full terms |
| Last verified | 2026-Q3 |
- Get a key at roxyapi.com/pricing
- Pick a language below
- Copy the snippet, run, ship
# Step 1: geocode the city
curl -s "https://roxyapi.com/api/v2/location/search?q=New+Delhi" \
-H "X-API-Key: $ROXY_API_KEY"# Step 2: detailed panchang using coordinates from step 1
curl -X POST https://roxyapi.com/api/v2/vedic-astrology/panchang/detailed \
-H "X-API-Key: $ROXY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-05-03","latitude":28.6139,"longitude":77.209,"timezone":"Asia/Kolkata"}'importosfromroxy_sdkimportcreate_roxyroxy=create_roxy(os.environ["ROXY_API_KEY"])
# Step 1: geocode the city - never hardcode coordinatesloc=roxy.location.search_cities(q="New Delhi")
city=loc["cities"][0]
latitude, longitude, timezone=city["latitude"], city["longitude"], city["timezone"]
# Step 2: detailed panchang for that locationpanchang=roxy.vedic_astrology.get_detailed_panchang(
date="2026-05-03", latitude=latitude, longitude=longitude, timezone=timezone,
)
tithi=panchang["tithi"]
print(tithi["name"], tithi["paksha"], "paksha")
print("Rahu Kaal:", panchang["rahuKaal"]["start"], "to", panchang["rahuKaal"]["end"])import{createRoxy}from'@roxyapi/sdk';constroxy=createRoxy(process.env.ROXY_API_KEY);// Step 1: geocode the city - never hardcode coordinatesconst{data: loc}=awaitroxy.location.searchCities({query: {q: 'New Delhi'}});const{ latitude, longitude, timezone }=loc.cities[0];// Step 2: detailed panchang for that locationconst{ data }=awaitroxy.vedicAstrology.getDetailedPanchang({body: {date: '2026-05-03', latitude, longitude, timezone },});console.log(data.tithi.name,data.tithi.paksha,'paksha');console.log('Rahu Kaal:',data.rahuKaal.start,'to',data.rahuKaal.end);import{createRoxy}from'@roxyapi/sdk';constroxy=createRoxy(process.env.ROXY_API_KEY!);// Step 1: geocode the city - never hardcode coordinatesconst{data: loc}=awaitroxy.location.searchCities({query: {q: 'New Delhi'}});const{ latitude, longitude, timezone }=loc!.cities[0];// Step 2: detailed panchang for that locationconst{ data }=awaitroxy.vedicAstrology.getDetailedPanchang({body: {date: '2026-05-03', latitude, longitude, timezone },});console.log(data?.tithi.name,data?.tithi.paksha,'paksha');console.log('Rahu Kaal:',data?.rahuKaal.start,'to',data?.rahuKaal.end);| Field | Type | Required | Description |
|---|---|---|---|
date | string | yes | Date in YYYY-MM-DD format. Panchang is calculated for this date. |
latitude | number | yes | Observer latitude in decimal degrees (-90 to 90). Determines sunrise and sunset times which define day/night boundaries for muhurta calculations. |
longitude | number | yes | Observer longitude in decimal degrees (-180 to 180). Affects local time calculations for sunrise, sunset, and muhurta period boundaries. |
timezone | number | no | Timezone offset from UTC in decimal hours. Defaults to 5.5 (IST). Used for sunrise/sunset/moonrise/moonset search accuracy and output time formatting. |
{
"date": "2026-05-03",
"vara": { "name": "Sunday", "lord": "Sun" },
"sunrise": "2026-05-03T05:39:00",
"sunset": "2026-05-03T18:57:00",
"moonrise": "2026-05-03T20:15:00",
"moonset": "2026-05-04T07:30:00",
"tithi": {
"number": 17,
"name": "Dvitiya",
"paksha": "Krishna",
"percent": 18.38,
"deity": "Brahma",
"rulingPlanet": "Moon",
"element": "Earth"
},
"nakshatra": {
"number": 16,
"name": "Vishakha",
"lord": "Jupiter",
"pada": 4,
"deity": "Indra and Agni",
"symbol": "Triumphal Arch"
},
"yoga": { "number": 18, "name": "Variyaana", "percent": 32.17 },
"karana": { "number": 4, "name": "Taitil", "type": "char" },
"rahuKaal": { "start": "2026-05-03T17:17:00", "end": "2026-05-03T18:57:00" },
"abhijitMuhurta": { "start": "2026-05-03T11:51:00", "end": "2026-05-03T12:44:00" },
"brahmaMuhurta": { "start": "2026-05-03T04:03:00", "end": "2026-05-03T04:51:00" },
"chandrabalam": {
"favorableRashis": ["Aries", "Gemini", "Virgo", "Scorpio", "Capricorn", "Aquarius"],
"ashtamaChandraRashi": "Pisces"
},
"tarabalam": {
"favorableNakshatras": ["Bharani", "Rohini", "Ardra", "Pushya"],
"unfavorableNakshatras": ["Krittika", "Mrigashira"]
}
}| Field | Type | Description |
|---|---|---|
date | string | Date for which panchang is calculated. |
vara | object | Hindu weekday (Vara) with name and ruling planet. Vara begins at local sunrise, not midnight. |
sunrise | string | Local sunrise time. Marks the start of the Hindu day. |
sunset | string | Local sunset time. Marks the transition to night muhurtas. |
moonrise | string or null | Moonrise time in the requested timezone. Null if Moon does not rise on this date. |
moonset | string or null | Moonset time in the requested timezone. Null if Moon does not set on this date. |
moonSign | object | Moon rashi (sidereal zodiac sign) at sunrise with Sanskrit name. Determines Chandrabalam and Tarabalam. |
sunSign | object | Sun rashi (sidereal zodiac sign) at sunrise with Sanskrit name. Determines the solar month (Saura Masa). |
sunNakshatra | object | Nakshatra the Sun occupies: number, name, lord, pada. Sun spends ~13-14 days per nakshatra. |
tithi | object | Lunar day (1-30). Includes name, paksha, percent elapsed, presiding deity, ruling planet, element. |
nakshatra | object | Lunar mansion (1-27). Includes name, lord, pada (1-4), deity, symbol, characteristics. |
yoga | object | Nitya Yoga (1-27) derived from combined Sun-Moon longitude. Includes name and characteristics. |
karana | object | Half-tithi (changes twice per tithi). Includes name, type (Movable/Fixed), characteristics. |
hora | object | Current planetary hora with ruling planet, sequence number, start and end times. |
rahuKaal | object | Rahu Kaal start/end. Inauspicious period ruled by Rahu. Avoid starting new ventures. |
yamaganda | object | Yamaganda start/end. Inauspicious period ruled by Yama. |
gulika | object | Gulika Kaal start/end. Inauspicious period ruled by Saturn son Gulika. |
abhijitMuhurta | object or null | Most auspicious ~48-minute window around solar noon. Null on Wednesdays per Muhurta Chintamani. |
brahmaMuhurta | object | Sacred pre-dawn period ~96 minutes before sunrise. Best for meditation and spiritual sadhana. |
vijayaMuhurta | object | Auspicious for journeys, legal proceedings, and competitions. |
nishitaMuhurta | object | Sacred midnight period. Significant for Shivaratri and Janmashtami celebrations. |
godhuliMuhurta | object or null | Universally auspicious 24-minute window around sunset. |
durMuhurta | array | Inauspicious muhurta periods per weekday. Each period lasts ~48 minutes. |
varjyam | array | Inauspicious ~96-minute nakshatra-based periods. Avoid auspicious ceremonies. |
amritKalam | array | Most auspicious ~96-minute nakshatra-based periods for muhurta selection. |
chandrabalam | object | Moon strength: favorable rashis and the Ashtama Chandra rashi. |
tarabalam | object | Star strength via the 9-Tara system: favorable and unfavorable birth nakshatras. |
panchaka | object | Active status and type when Moon transits nakshatras 23-27. |
bhadra | object | Active status and timing for Vishti (Bhadra) karana. |
transitions | object | Precise transition times for tithi, yoga, karana, nakshatra, and Moon sign. |
| Use case | Endpoint flow |
|---|---|
| Hindu calendar app | POST /vedic-astrology/panchang/detailed with date and user location. Display all five limbs. |
| Muhurta selection | Check abhijitMuhurta, brahmaMuhurta, vijayaMuhurta, amritKalam. Exclude rahuKaal, yamaganda, durMuhurta. |
| Daily astrology notification | Combine tithi, nakshatra, vara for a morning push notification. |
| Marriage and naming ceremonies | Check chandrabalam, tarabalam, bhadra, panchaka before selecting an auspicious time. |
| Electional astrology tools | Use transitions to determine precise panchang change boundaries to the minute. |
| Hindu festival dates | Feed daily tithi number into festival lookup (Purnima, Amavasya, Ekadashi) for dynamic calendar generation. |
- POST
/vedic-astrology/panchang/basic(getBasicPanchang) for Tithi, Nakshatra, Yoga, Karana without time-based muhurtas - POST
/vedic-astrology/panchang/choghadiya(getChoghadiya) for 8-period day/night muhurta divisions - POST
/vedic-astrology/panchang/hora(getHora) for all 24 planetary hours with ruling planets
Connect Claude, GPT, Gemini, or Cursor to RoxyAPI through the remote MCP server. No Docker. No self hosting. The full MCP tool catalog for this domain is at https://roxyapi.com/mcp/vedic-astrology.
{
"mcpServers": {
"vedic-astrology": {
"url": "https://roxyapi.com/mcp/vedic-astrology",
"headers": { "X-API-Key": "$ROXY_API_KEY" }
}
}
}See docs/mcp for Claude Desktop, Cursor, Windsurf, VS Code, and Claude Code setup.
This repo ships an AGENTS.md execution playbook. Cursor, Claude Code, Aider, Codex, Windsurf, RooCode, and Gemini CLI will pick it up automatically. Top level overview lives at roxyapi.com/AGENTS.md.
- Methodology and gold standard tests verified against NASA JPL Horizons
- Full API reference interactive Scalar UI
- TypeScript SDK on npm
- Python SDK on PyPI
- PHP SDK on Packagist
- C# SDK on NuGet
- Go SDK on pkg.go.dev
- WordPress plugin
- llms.txt full LLM citation index
- Top level AGENTS.md
MIT for this sample repo. See LICENSE.
Catalog licensing: Personal and commercial use, including closed source proprietary apps. No AGPL or GPL entanglement. RoxyAPI APIs and SDKs are safe to embed in commercial products. Full terms at roxyapi.com/policy/license.
- Site: roxyapi.com
- Status: roxyapi.com/api-reference