# Kshana Panchang API

> Kshana Panchang API is a paid API for AI agents from dev.api.kshana.thirdorigin.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns Hindu almanac (Panchang) data for a given date, time, and location, including auspicious timings and Vedic calendar details

## Facts

- Endpoint: POST https://dev.api.kshana.thirdorigin.io/api/panchang
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kshana-panchang-api-4bb8197c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xhElY1Uv6xASSKz_-uvn6

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kshana-panchang-api-4bb8197c -d '<json body>'
```

Example prompt: What's the panchang for Mumbai (lat 19.076, lon 72.877, timezone Asia/Kolkata) on March 15, 2025 at 06:00 AM — can you get the Vedic calendar details for that day?

## When to prefer this

Use this endpoint when you need Vedic/Hindu Panchang data (Tithi, Nakshatra, Yoga, Karana, muhurta timings) for a specific date and geographic location. It supports batch queries for up to 31 consecutive days and preset city shortcuts, making it suitable for scheduling auspicious dates, religious observance planning, or Jyotish (Vedic astrology) applications. Prefer this over generic calendar APIs when the use case requires authentic Hindu almanac calculations.

## Known failure modes

- Missing required 'date' field returns a validation error
- Invalid date format (non-ISO) causes a parse error
- Unsupported IANA timezone string results in an error
- Latitude/longitude out of valid geographic range returns an error
- 'days' value exceeding 31 is rejected
- Invalid city shortcut in 'locations' field returns an error
- Payment not provided or insufficient USDC triggers a 402 Payment Required response

## How this service works

Panchang (Hindu almanac) REST API

## Output

Returns Panchang (Hindu almanac) data for the requested date(s) and location, including Tithi, Nakshatra, Yoga, Karana, auspicious/inauspicious periods (Rahu Kaal, Abhijit Muhurta, etc.), sunrise/sunset times, and other Vedic calendar details. Can cover up to 31 consecutive days in a single response.

## Example request

```json
{
 "at": "06:00",
 "tz": "Asia/Kolkata",
 "lat": 19.076,
 "lon": 72.877,
 "date": "2025-03-15",
 "days": 1
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "date"
 ],
 "properties": {
  "at": {
   "type": "string",
   "description": "Time of day as HH:MM"
  },
  "tz": {
   "type": "string",
   "description": "IANA timezone, e.g. Asia/Kolkata"
  },
  "lat": {
   "type": "number",
   "description": "Latitude"
  },
  "lon": {
   "type": "number",
   "description": "Longitude"
  },
  "date": {
   "type": "string",
   "format": "date",
   "description": "ISO date, e.g. 2026-02-28"
  },
  "days": {
   "type": "integer",
   "default": 1,
   "maximum": 31,
   "minimum": 1,
   "description": "Consecutive days (1-31)"
  },
  "locations": {
   "type": "string",
   "description": "Comma-separated city shortcuts (antwerp, dubai, london, mumbai, newyork, paris)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kshana-panchang-api-4bb8197c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from dev.api.kshana.thirdorigin.io](https://www.zero.xyz/host/dev.api.kshana.thirdorigin.io/llms.txt)