Jyotish API
A REST API for Jyotish (Vedic Astrology) calculations, built on top of the kunjara/jyotish library. Jyotish API containerized and provides a wide range of Vedic astrology calculations, including planetary positions, Dashas, Yogas, and more.
Features
Chart Calculations
- Varga (Divisional) Charts: D1, D2, D3, D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D45, D60
- Planetary Positions: Detailed positions of planets, Surya (Sun), Chandra (Moon), Mangal (Mars), Buddha (Mercury), Guru (Jupiter), Shukra (Venus), Shani (Staurn), Rahu and Ketu.
- Lagna (Ascendant) Calculations.
- Nakshatra Positions: Lunar mansions.
Advanced Calculations
- Astangata (Combustion): Analysis of planets combust due to proximity to the Sun.
- Rashi Avastha (Planetary Dignity): Calculation of planetary dignity in different signs.
- Vargottama: Identification of planets occupying the same sign in both Rashi and Navamsa charts.
- Planetary War (Yuddha): Detection of planetary wars when planets are within 1 degree of each other.
Panchanga Elements
- Tithi: Lunar day calculation.
- Nakshatra: Determination of the current lunar mansion.
- Yoga: Calculation of the Yoga formed by the positions of the Sun and Moon.
- Karana: Half of a Tithi, used in muhurta (electional astrology).
- Vara: Day of the week.
Strength Calculations
- Ashtakavarga: Point-based system to analyze planetary strengths.
- Graha Bala (Planetary Strength): Comprehensive strength analysis of planets.
- Rashi Bala (Sign Strength): Strength of the zodiac signs.
Yoga Calculations
- Dhana Yoga: Wealth-producing combinations.
- Mahapurusha Yoga: Great person yogas formed by certain planetary positions.
- Nabhasha Yoga: Yogas based on planetary patterns.
- Parivarthana Yoga: Mutual exchange of signs between planets.
- Raja Yoga: Combinations indicating power and authority.
- Sannyasa Yoga: Combinations indicating renunciation.
Additional Features
Automatic Timezone Detection: Adjusts calculations based on the provided location. [DISABLED]- DST Handling: Accounts for Daylight Saving Time shifts.
- Ayanamsha Calculations: Adjustments for the precession of the equinoxes.
- Dasha Calculations (Vimshottari): Planetary periods analysis.
- Supported Ayanamshas: Deluce ,Djwhalkhul ,Fagan ,Jnbhasin ,Krishnamurti ,Lahiri ,Raman ,Sassanian ,Ushashashi ,Yukteshwar
Literature
Most of the calculations are based on the following classical texts:
Installation
To install and run the Vedic Astrology API locally, follow these steps:
-
Clone the repository:
git clone https://github.com/teal33t/jyotish-api.git
cd jyotish-api
-
Build and start the Docker container:
docker-compose up --build -d
-
Compile the Swiss Ephemeris library inside the container:
docker-compose exec jyotish_api bash -c "cd swetest/src && make clean && make && chmod 777 swetest/src && chmod +x swetest/src/swetest"
-
Verify the API is running:
Visit http://localhost:9393/api/ping to check if the API is up and running.
API Documentation
The API documentation is available via Swagger UI:
API Endpoints
Health Check
GET /api/ping
Verifies if the API is running.
Response:
{
"pong": "success"
}
Calculate Chart
GET /api/calculate
Calculates chart based on provided parameters.
Request
http://localhost:9393/api/calculate?latitude=28.6139&longitude=77.209&year=2023&month=12&day=25&hour=12&min=0&sec=0&time_zone=%2B03%3A30&dst_hour=0&dst_min=0&nesting=0&varga=D1%2CD9&infolevel=basic%2Cpanchanga%2Ctransit
Query Parameters:
| Parameter |
Type |
Required |
Description |
Example |
| latitude |
float |
Yes |
Location latitude |
28.6139 |
| longitude |
float |
Yes |
Location longitude |
77.2090 |
| year |
integer |
Yes |
Year for calculation |
2023 |
| month |
integer |
Yes |
Month for calculation (1-12) |
12 |
| day |
integer |
Yes |
Day for calculation (1-31) |
25 |
| hour |
integer |
Yes |
Hour for calculation (0-23) |
12 |
| min |
integer |
Yes |
Minute for calculation (0-59) |
0 |
| sec |
integer |
Yes |
Second for calculation (0-59) |
0 |
| time_zone |
string |
No |
Timezone for calculation, |
+03:30 |
| dst_hour |
integer |
No |
DST hours offset |
0 |
| dst_min |
integer |
No |
DST minutes offset |
0 |
| nesting |
integer |
No |
Nesting level for calculations |
0 |
| varga |
string |
No |
Varga divisions (comma-separated) |
D1,D9 |
| infolevel |
string |
No |
Info levels to include |
basic,ashtakavarga,grahabala,rashibala,yogas,panchanga,transit |
- You should specify timezone, for example if you are living in Iran you can put that on +03:30.
Timezones:
Please consider time_zone should pad with zero with two digit length and have sign:
Correct: “+01:00”, “-01:00”
Incorrect: 1:00, +1:00, 1:0, -1:0, 1, +1, -1
| Timezone |
City |
Country |
| -03:00 |
Rio de Janeiro |
Brazil |
| -05:00 |
New York (EST) |
USA |
| -04:00 |
New York (EDT) |
USA |
| +00:00 |
London (GMT) |
UK |
| +01:00 |
London (BST) |
UK |
| +09:00 |
Tokyo |
Japan |
| +10:00 |
Sydney (AEST) |
Australia |
| +11:00 |
Sydney (AEDT) |
Australia |
| +04:00 |
Dubai |
UAE |
| +03:00 |
Moscow |
Russia |
| +08:00 |
Beijing |
China |
| +05:30 |
Delhi |
India |
| +01:00 |
Paris (CET) |
France |
| +02:00 |
Paris (CEST) |
France |
| -08:00 |
Los Angeles (PST) |
USA |
| -07:00 |
Los Angeles (PDT) |
USA |
| -06:00 |
Chicago (CST) |
USA |
| -05:00 |
Chicago (CDT) |
USA |
| +02:00 |
Johannesburg |
South Africa |
| +02:00 |
Cairo |
Egypt |
| +03:00 |
Istanbul |
Turkey |
| +08:00 |
Singapore |
Singapore |
| +07:00 |
Bangkok |
Thailand |
| +09:00 |
Seoul |
South Korea |
| +07:00 |
Jakarta (WIB) |
Indonesia |
| +08:00 |
Jakarta (WITA) |
Indonesia |
| +09:00 |
Jakarta (WIT) |
Indonesia |
| +08:00 |
Manila |
Philippines |
| +01:00 |
Berlin (CET) |
Germany |
| +02:00 |
Berlin (CEST) |
Germany |
| +02:00 |
Helsinki (EEST) |
Finland |
| +03:00 |
Helsinki (EET) |
Finland |
| +02:00 |
Tel Aviv (IDT) |
Israel |
| +03:00 |
Tel Aviv (IST) |
Israel |
| +03:00 |
Riyadh |
Saudi Arabia |
| +03:00 |
Doha |
Qatar |
| +03:00 |
Abu Dhabi |
UAE |
| +03:30 |
Tehran |
Iran |
| -03:00 |
Buenos Aires |
Argentina |
| -05:00 |
Toronto |
Canada |
| +01:00 |
Rome |
Italy |
| +02:00 |
Athens |
Greece |
| +01:00 |
Madrid |
Spain |
| +00:00 |
Lisbon |
Portugal |
| +01:00 |
Amsterdam |
Netherlands |
| +01:00 |
Brussels |
Belgium |
| +01:00 |
Vienna |
Austria |
| +01:00 |
Zurich |
Switzerland |
| +08:00 |
Hong Kong |
Hong Kong |
| +08:00 |
Kuala Lumpur |
Malaysia |
| +12:00 |
Auckland |
New Zealand |
| -06:00 |
Mexico City |
Mexico |
| -03:00 |
Santiago |
Chile |
| +05:00 |
Karachi |
Pakistan |
Response:
{
"chart": {
"user": {
"datetime": "2023-12-25 12:00:00",
"timezone": "+03:30",
"longitude": 49.583057,
"latitude": 37.28077,
"altitude": 0
},
"graha": {
"Su": {
"longitude": 248.983163,
"latitude": 0.0001772,
"speed": 1.0183709,
"ascension": 273.4600331,
"declination": -23.3978588,
"rashi": 9,
"degree": 8.98316299999999,
"nakshatra": {
"anga": "nakshatra",
"key": 19,
"ratio": 1,
"abhijit": false,
"left": 32.62627750000016,
"name": "Moola",
"pada": 3
},
"astangata": null,
"rashiAvastha": "friend",
"vargottama": false,
"yuddha": null,
"gocharastha": 0,
"bhavaCharacter": "mishra",
"tempRelation": {
"Mo": -1,
"Ma": 1,
"Me": -1,
"Ju": -1,
"Ve": 1,
"Sa": 1,
"Ra": 1,
"Ke": 1
},
"relation": {
"Mo": 0,
"Ma": 2,
"Me": -1,
"Ju": 0,
"Ve": 0,
"Sa": 0,
"Ra": 0,
"Ke": 0,
"Su": null
},
"yogakaraka": false,
"mrityu": false,
"pushkaraNavamsha": 0,
"pushkaraBhaga": false,
"avastha": {
"baladi": "kumara",
"jagradi": "swapna",
"deeptadi": [
"shanta"
]
},
"dispositor": "Ju"
},
"Mo": {},
"Ma": {},
"Me": {},
"Ju": {},
"Ve": {},
"Sa": {},
"Ra": {},
"Ke": {},
},
"bhava": {
"1": {
"longitude": 327.9252867,
"ascension": 330.1017467,
"declination": -12.1928517,
"rashi": 11,
"degree": 27.925286700000015
},
"2": {},
"3": {},
"4": {},
"5": {},
"6": {},
"7": {},
"8": {},
"9": {},
"10": {},
"11": {},
"12": {},
},
"lagna": {
"Lg": {
"longitude": 327.9252867,
"ascension": 330.1017467,
"declination": -12.1928517,
"rashi": 11,
"degree": 27.925286700000015,
"nakshatra": {
"anga": "nakshatra",
"key": 25,
"ratio": 1,
"abhijit": false,
"left": 40.56034975,
"name": "Purva Bhadrapada",
"pada": 3
}
},
"MLg": {
"longitude": 240.7308939,
"ascension": 238.5809717,
"declination": -20.3009012,
"rashi": 9,
"degree": 0.7308939000000123
}
},
"varga": {
"D9": {
"bhava": {
"1": {
"rashi": 3,
"degree": 11.327580300000125,
"longitude": 71.32758030000012
},
"2": {},
"3": {},
"4": {},
"5": {},
"6": {},
"7": {},
"8": {},
"9": {},
"10": {},
"11": {},
"12": {},
},
"graha": {
"Su": {
"rashi": 3,
"degree": 20.84846699999991,
"speed": 1.0183709,
"longitude": 80.84846699999991
},
"Mo": {},
"Ma": {},
"Me": {},
"Ju": {},
"Ve": {},
"Sa": {},
"Ra": {},
"Ke": {},
},
"lagna": {
"Lg": {
"rashi": 3,
"degree": 11.327580300000125,
"longitude": 71.32758030000012
},
"MLg": {
"rashi": 1,
"degree": 6.578045100000111,
"longitude": 6.578045100000111
}
}
}
},
"panchanga": {
"tithi": {
"anga": "tithi",
"key": 14,
"name": "Chaturdashi",
"paksha": "shukla",
"left": 75.43356083333303
},
"nakshatra": {
"anga": "nakshatra",
"key": 4,
"ratio": 1,
"abhijit": false,
"left": 40.51648225000003,
"name": "Rohini",
"pada": 3
},
"yoga": {
"anga": "yoga",
"key": 23,
"name": "Shubha",
"left": 73.14275974999997
},
"vara": {
"anga": "vara",
"left": 81.29129302863754,
"key": "Mo",
"week": "1",
"name": "Somavar"
},
"karana": {
"anga": "karana",
"key": 5,
"name": "Gara",
"left": 50.867121666666065
}
},
"rising": {
"Su": [
{
"rising": "2023-12-24 07:30:04",
"setting": "2023-12-24 17:40:54"
},
{
"rising": "2023-12-25 07:30:31",
"setting": "2023-12-25 17:41:27"
},
{
"rising": "2023-12-26 07:30:56",
"setting": "2023-12-26 17:42:02"
}
]
},
"kala": {
"hora": {
"number": 7,
"key": "Me",
"interva
提示：代码过长已自动截断
Current Time Chart
GET /api/now
Calculates chart for the current moment.
Query Parameters:
| Parameter |
Type |
Required |
Description |
Default |
| latitude |
float |
No |
Location latitude |
35.7219 |
| longitude |
float |
No |
Location longitude |
51.3347 |
Response:
{
"chart": { /* Chart data */ },
"duration_of_response": 0.123,
"created_at": "2023-12-25 12:00:00"
}
Error Handling
In case of errors, the API returns a JSON response with an error message and appropriate HTTP status code:
{
"status": 400,
"message":"No route found for GET http://localhost:9393/api/not_registered_route/"
}
Support
For issues, feature requests, or questions, please open an issue in the GitHub repository.
License
It’s free.
Om Tat Sat
评论