Panchang API

Tithi Nakshatra Yoga Karana Calculator

POST/vedic-astrology/panchang/basicPOST/vedic-astrology/panchang/choghadiyaPOST/vedic-astrology/panchang/detailedPOST/vedic-astrology/panchang/hora

Calculate Panchang elements (Hindu calendar) for any date: Tithi (lunar day), Nakshatra (lunar mansion), Yoga, and Karana. Daily panchang API for determining auspicious timings (muhurta), festival dates, and planetary influences. Tithi calculator with Shukla/Krishna paksha. Accurate nakshatra today with ruling planet. Essential for Hindu calendar integration, muhurta selection, and Vedic timekeeping in astrology apps.

Location first, chart second

The Panchang API needs latitude, longitude, and timezone. Never ask users to type coordinates. Resolve a city with the Location endpoint first, then feed the result into the request. Timezone accepts a decimal offset or an IANA name.

1 Resolve the location

GET
curl "https://roxyapi.com/api/v2/location/search?q=New York" \
  -H "X-API-Key: YOUR_KEY"
# -> cities[0]: { latitude, longitude, timezone: "America/New_York" }

2 Call the Panchang endpoint

POST /vedic-astrology/panchang/basic
# feed latitude, longitude and timezone from step 1
POST https://roxyapi.com/api/v2/vedic-astrology/panchang/basic

Request

POST /api/v2/vedic-astrology/panchang/basic

Parameters

ParameterTypeDescription
langquerystring enumResponse language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English. Default en.

Request body

FieldTypeDescription
date*string (date)Date in YYYY-MM-DD format. Panchang elements (Tithi, Nakshatra, Yoga, Karana) are calculated for this date.
time*string (time)Time in HH:MM:SS format (24-hour). Determines the exact Moon and Sun positions for tithi and nakshatra calculation.
latitude*numberObserver latitude in decimal degrees. Determines sunrise/sunset times which define the Vara (weekday) and muhurta boundaries.
longitude*numberObserver longitude in decimal degrees. Affects local time calculations for sunrise/sunset-dependent panchang elements.
timezonenumber or stringTimezone offset from UTC in decimal hours. Defaults to 5.5 (IST).

Example request

POST /vedic-astrology/panchang/basic
{
  "date": "2025-12-17",
  "time": "12:00:00",
  "latitude": 28.6139,
  "longitude": 77.209
}

Response

Structured JSON with documented fields, verified against NASA JPL Horizons across 828 gold-standard tests. Not hallucinated text.

200 OK
{
  "tithi": {
    "number": 5,
    "name": "Panchami",
    "paksha": "Shukla",
    "percent": 67.5
  },
  "nakshatra": {
    "number": 1,
    "name": "Ashwini",
    "lord": "Ketu",
    "pada": 2
  },
  "yoga": {
    "number": 1,
    "name": "Vishkumbha"
  },
  "karana": {
    "number": 7,
    "name": "Bava"
  },
  "sunLongitude": 265.42,
  "moonLongitude": 315.67
}

Response fields

FieldTypeDescription
tithi*objectLunar day (tithi) information with interpretations. Central panchang element for determining auspicious timings.
tithi.number*integerTithi number (1-30). 1-15 are Shukla Paksha (waxing), 16-30 are Krishna Paksha (waning). Purnima is 15, Amavasya is 30.
tithi.name*stringSanskrit name of the tithi (lunar day). One of 30 tithis in the lunar month cycle.
tithi.paksha*string enumLunar fortnight: Shukla (waxing, bright half) or Krishna (waning, dark half).
tithi.percent*numberPercentage of the current tithi elapsed (0-100). Useful for determining tithi strength and transition proximity.
tithi.deitystringPresiding deity of this tithi from Vedic tradition.
tithi.rulingPlanetstringPlanetary ruler of this tithi. Influences the day energy and activities.
tithi.elementstringElemental quality of this tithi (Fire, Earth, Air, Water, Ether).
nakshatra*objectNakshatra (lunar mansion) information with interpretations
nakshatra.number*integerNakshatra index (1-27) in the zodiac sequence starting from Ashwini. Each nakshatra spans 13 degrees 20 minutes.
nakshatra.name*stringSanskrit name of the nakshatra (lunar mansion). One of 27 nakshatras spanning the zodiac belt.
nakshatra.lord*stringPlanetary ruler of this nakshatra. Determines Vimshottari dasha lord and influences nakshatra characteristics.
nakshatra.pada*integerPada (quarter, 1-4) of the nakshatra. Each nakshatra has 4 padas spanning 3 degrees 20 minutes each. Determines the navamsha sign and fine-tunes nakshatra predictions.
nakshatra.deitystringPresiding deity of this nakshatra from Vedic mythology. Influences spiritual qualities and karmic themes.
Show all fields
FieldTypeDescription
nakshatra.symbolstringTraditional symbol representing this nakshatra. Reflects core energy and life themes.
nakshatra.characteristicsstringPersonality traits and behavioral tendencies when the Moon occupies this nakshatra. Useful for daily panchang readings.
yoga*objectNitya Yoga information. Yoga is the third panchang element, derived from combined Sun-Moon longitude.
yoga.number*integerNitya Yoga index (1-27). Calculated from the sum of Sun and Moon sidereal longitudes divided by 13 degrees 20 minutes.
yoga.name*stringSanskrit name of the Nitya Yoga. One of 27 yogas formed by combined Sun-Moon motion, each with distinct auspiciousness.
yoga.characteristicsstringCharacteristics and auspiciousness of this yoga for activity planning.
karana*objectKarana (half-tithi) information. Fourth panchang element, changes twice per tithi.
karana.number*integerKarana index. There are 11 karanas total (4 fixed + 7 movable) cycling through 60 half-tithis per lunar month.
karana.name*stringSanskrit name of the karana. 7 movable karanas (Bava through Naga) repeat 8 times, plus 4 fixed karanas.
karana.typestringKarana type: Movable (repeating, generally auspicious) or Fixed (occur once per month).
karana.characteristicsstringActivity suitability and characteristics of this karana for muhurta selection.
sunLongitude*numberSidereal longitude of the Sun in degrees (0-360). Used for tithi and yoga calculations.
moonLongitude*numberSidereal longitude of the Moon in degrees (0-360). Moon moves ~13 degrees per day through the nakshatras.

Supported options

lang

entrdeeshiptfrru

Call it in your language in seconds.

Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.

TypeScript
import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.vedicAstrology.getBasicPanchang({ body: { date: '2025-12-17', time: '12:00:00', latitude: 28.6139, longitude: 77.209 } })
Install: npm install @roxyapi/sdk

Prefer to try before you write code? Run this Vedic Astrology endpoint live in the API playground and inspect a real production response.

More Panchang endpoints

The Panchang API bundles these related endpoints under one key.

POST/vedic-astrology/panchang/choghadiya

Get Choghadiya - 8 Muhurta divisions of day and night

Calculate Choghadiya (Chaughadia) muhurta timings for any date and location. Divides day (sunrise to sunset) and night (sunset to next sunrise) into 8 equal auspicious/inauspicious periods. Each period ruled by a planet: Udveg (Sun, bad), Amrit (Moon, good), Rog (Mars, bad), Labh (Mercury, good), Shubh (Jupiter, good), Char (Venus, good), Kaal (Saturn, bad). Essential for muhurta selection, daily planning, and traditional Hindu timekeeping. Choghadiya calculator API, daily muhurat timings, auspicious time finder.

Try it live
POST/vedic-astrology/panchang/detailed

Get detailed Panchang with Rahu Kaal, Yamaganda, Gulika

Complete daily panchang with all five limbs (Tithi, Nakshatra, Yoga, Karana, Vara) plus sunrise, sunset, moonrise, moonset times. Includes inauspicious periods (Rahu Kaal, Yamaganda, Gulika Kaal) and auspicious windows (Abhijit Muhurta, Brahma Muhurta). Current planetary hora with start/end times. Essential for muhurta selection, daily horoscope apps, Hindu calendar integration, and electional astrology. Accurate calculations based on observer location.

Try it live
POST/vedic-astrology/panchang/hora

Get Hora - 24 Planetary Hours (12 day + 12 night)

Calculate all 24 Hora (planetary hour) periods for any date and location. Day is divided into 12 equal horas from sunrise to sunset, night into 12 equal horas from sunset to next sunrise. Each hora is ruled by a planet in the Chaldean sequence starting from the day lord. Hora timings API, planetary hours calculator, Vedic hora chart, electional astrology timing.

Try it live

Remote MCP for AI agents

Every Vedic Astrology endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.

Claude Code / Cursor
claude mcp add --transport http \
  roxy-vedic-astrology https://roxyapi.com/mcp/vedic-astrology \
  --header "X-API-Key: YOUR_KEY"

Tool name for POST /vedic-astrology/panchang/basic: post_vedic_astrology_panchang_basic. Full MCP setup guide

What you can build

Matrimonial matchmaking platforms - automate Gun Milan compatibility scoring, Manglik dosha checks, Navamsa spouse analysis, and generate match reports with remedies for Shaadi.com-style features

Daily horoscope and prediction apps - fetch planetary transits, current Dasha periods, Panchang data, and birth star forecasts to power personalized daily readings at consumer-app scale

Kundli generation and PDF report services - combine D1/D9 charts, planetary positions, Dasha timelines, yoga detection, and dosha analysis into automated birth chart reports

KP horary and event prediction apps - build stellar astrology software with significator analysis, cusp sub-lords, and 249-level precision for answering when/yes-no questions

Spiritual wellness and calendar apps - integrate Panchang for Hindu festival dates, fasting calendars, temple muhurat selection, and Nakshatra-based meditation schedules

AI astrology chatbots and virtual consultants - power conversational AI with structured Vedic calculations, compatibility queries, Dasha predictions, and remedy suggestions via ChatGPT plugins or MCP integration

Drop-in UI components

Render Panchang API responses without building charts yourself. These open source, framework-agnostic web components take the typed response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.

<roxy-panchang-table><roxy-hora-table><roxy-choghadiya-grid>
See them live on Roxy UI

Related capabilities

Panchang API FAQ

What does the Panchang API return?

Calculate Panchang elements (Hindu calendar) for any date: Tithi (lunar day), Nakshatra (lunar mansion), Yoga, and Karana. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.

How do I authenticate with the Panchang API?

Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.

Does the Panchang API support multiple languages?

Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.

Do I need coordinates to call the Panchang API?

No. Call GET /location/search with a city name first, then pass latitude, longitude, and timezone from the first result into the request. Never ask users to type coordinates. Timezone accepts a decimal offset or an IANA name.

Is the Panchang API available over Remote MCP for AI agents?

Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/vedic-astrology over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.

How is the Panchang API billed?

Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 12 domains, so the Panchang API is included at no extra cost.

What lang values does the Panchang API accept?

The lang parameter accepts en, tr, de, es, hi, pt, fr, ru. Case-insensitive where it is a path value.

Start using Panchang API today.

Launch your Jyotish or KP astrology product in days. Not months.

All 12 domains included with every plan. Every endpoint, MCP server, SDK, and starters.

Plans from $39/mo, starting at $2.70 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key