v2 Engine Swiss Ephemeris 2.10 • Sub-50ms Latency

The API for Vedic & Financial Astrology

Enterprise-grade calculation engine for planetary positions, D1–D60 divisional charts, Panchang, Dashas, Ashtakoot matchmaking, and financial market transits.

Get API Key Interactive Docs

Free 100 API credits

No credit card required

Instant activation

POST /v2/astrology/planets

// Request payload curl -X POST https://api.jyotish.today/v2/astrology/planets \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "year": 1995, "month": 8, "day": 15, "hour": 14, "min": 30, "sec": 0, "lat": 28.6139, "lon": 77.2090, "tzone": 5.5, "ayanamsha": "lahiri" }'

// Response in 18ms • HTTP 200 OK

{ "status": "success", "data": { "ascendant": { "sign": "Scorpio", "degree": 14.28 }, "Sun": { "sign": "Leo", "degree": 28.14, "nakshatra": "Uttara Phalguni" }, "Jupiter": { "sign": "Scorpio", "retrograde": false } } }

Engine Modules

Complete Suite for Modern Astrologers & Apps

All endpoints accept standard geo-coordinates and UTC offsets, delivering clean structured JSON outputs.

Core Kundli & Planetary Math

True and Mean planetary calculations, Bhavas (Houses), Shadbala strengths, Ashtakavarga points, and all divisional charts (D1 to D60).

D1–D60 Charts Shadbala Bhav Madhyam

Panchang & Muhurata

Real-time calculations for Tithi, Nakshatra, Yoga, Karana, Rahu Kaal, Gulika, Yamaganda, Choghadiya, Hora, and auspicious Muhurata timings.

Choghadiya Rahu Kaal Sunrise/Sunset

Vimshottari & Chara Dashas

Deep 5-level Vimshottari dasha hierarchy (Maha, Antar, Pratyantar, Sookshma, Pran) and Jaimini Chara Dasha with timeline predictions.

Vimshottari Jaimini Chara Timeline Range

Kundli Milan (Match Making)

Comprehensive 36-Guna Ashtakoot matching (Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi) plus Dashakoot, Mangal Dosha & Rajju Vedha.

36 Guna Milan Dashakoot Mangal Dosha

Financial & Market Astrology

First-of-its-kind financial transit engine, Sarvatobhadra Chakra nakshatra aspects, and planetary wealth profile for stocks and commodities.

Sarvatobhadra Market Transit Wealth Profile

PDF Horoscope Report Studio

Automated generation of beautifully formatted, print-ready multi-page Kundli reports, complete with charts, tables, remedies, and personalized predictions.

Multi-page PDF White-label Multi-Language

FIRST IN VEDIC ASTROLOGY Model Context Protocol (MCP) Ready

Power Your AI Agents with Real-Time Swiss Ephemeris

Equip Claude Desktop, Cursor IDE, Antigravity, and autonomous LLMs with native astrology tools. Query planetary degrees, panchang, kundli milan, and financial transits with zero custom API code.

Cursor & Claude Ready

Add 3 lines of JSON to connect Jyotish Today natively as an MCP tool server.

Anti-Hallucination

Replaces LLM hallucinations with verified sub-50ms Swiss Ephemeris C calculations.

Setup MCP in 30 Seconds →

claude_desktop_config.json

MCP JSON-RPC 2.0

{
  "mcpServers": {
    "jyotish-today": {
      "command": "npx",
      "args": ["-y", "@jyotish-today/mcp-server"],
      "env": {
        "JYOTISH_API_KEY": "jt_live_your_key"
      }
    }
  }
}

AI-FIRST DEVELOPER EXPERIENCE Prompt-to-Integrate

Ship in 30 Seconds with Cursor, Claude & Copilot

Skip reading 50 pages of documentation. Click "Copy AI Prompt" in your dashboard, paste it into Cursor, v0.dev, Lovable, or Claude Code, and watch your AI write bug-free integration code immediately.

1. Click "Copy AI Prompt"

Pre-populated with your real API key, endpoint contracts, and error handlers.

2. Paste into Cursor, Claude Code, or v0

Your AI coding assistant instantly understands the exact data shapes and headers.

3. Ship Your Astrology App in Minutes

Full-stack React, Flutter, Python, or Node.js code generated without manual typing.

Explore Prompt-to-Integrate →

Cursor / Claude / Copilot Prompt

1-CLICK PROMPT

You are an expert full-stack engineer integrating Jyotish Today API.

### API BASE CONFIGURATION
- Base URL: https://api.jyotish.today
- Auth: Authorization: Bearer jt_live_your_key
- Precision: Swiss Ephemeris C-Math (<50ms)

### CORE ENDPOINTS
1. POST /v2/planets (Planetary Houses & Signs)
2. POST /v2/panchang (Tithi, Vaar, Muhuratas)
3. POST /v2/match_making/ashtakoot_points (36 Gunas)
4. POST /v2/ai/chat (Conversational Astrologer)

// Paste this prompt into Cursor Composer or Claude Code
> "Create a React Native horoscope screen calling /v2/planets"

Built for Developers

Why Engineering Teams Choose Jyotish Today

We eliminated the deceptive credit math, high latency, and expired quotas common in legacy astrology APIs.

1 Call = 1 Credit

No 10x or 800x hidden credit penalties. 50,000 calls mean 50,000 calculations of any type (Kundli, Panchang, or Matchmaking).

Never-Expiring Wallet

Say goodbye to "use-it-or-lose-it" quotas. Pre-funded rollover credits never expire and seamlessly protect your app from overage downtime.

Sub-50ms C Math

Compiled Swiss Ephemeris C library executing in 8ms–17ms average. Fast enough for real-time mobile charts and algorithmic trading.

Domain & IP Locks

Lock API keys to your website domain or backend server IPs with 24-hour zero-downtime key rotation.

Developer Experience

Integrate in 5 Minutes

Connect with our API using standard HTTP REST libraries in Python, JavaScript/Node, PHP, Go, Java, or cURL.

Consistent JSON Schema: Standardized coordinates, ISO dates, and unambiguous error codes.
Sub-Second Precision: High-precision geocoding timezone offset integration.
Interactive API Playground: Test endpoints with your API key directly in your browser.

View Full API Reference →

import requests

url = "https://api.jyotish.today/v2/astrology/planets"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "year": 1995, "month": 8, "day": 15,
    "hour": 14, "min": 30, "sec": 0,
    "lat": 28.6139, "lon": 77.2090, "tzone": 5.5,
    "ayanamsha": "lahiri"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const axios = require('axios');

async function getKundli() {
  const res = await axios.post('https://api.jyotish.today/v2/astrology/planets', {
    year: 1995, month: 8, day: 15,
    hour: 14, min: 30, sec: 0,
    lat: 28.6139, lon: 77.2090, tzone: 5.5,
    ayanamsha: 'lahiri'
  }, {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });
  console.log(res.data);
}
getKundli();

<?php
$ch = curl_init('https://api.jyotish.today/v2/astrology/planets');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode([
        'year' => 1995, 'month' => 8, 'day' => 15,
        'hour' => 14, 'min' => 30, 'sec' => 0,
        'lat' => 28.6139, 'lon' => 77.2090, 'tzone' => 5.5
    ]),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ]
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($data);

Start Building Today

Ready to power your application with Swiss Ephemeris?

Join developers and astrology businesses building world-class birth charts, horoscope apps, and financial analytics.

Create Free Account Explore Plans