/api/astro/hora-chart/1 creditHora chart (D2)
The hora, the second divisional chart: each sign divided in half. Read for wealth and resources. Each half falls under the Sun or the Moon, so this division sorts the chart into two groups rather than twelve. Not to be confused with /api/astro/hora/, which returns the twenty-four planetary hours of the day - a different calculation that shares the name. Returns the same flat shape as /api/astro/planet-positions/: the planets as a list in traditional order with `name`, longitude, sign, nakshatra, pada and house on each, plus the ascendant and the ayanamsa applied. Send a date and a place; `ayanamsa` defaults to LAHIRI and all 48 are accepted. The chart is fixed by the route, so a `chart_name` in the body is ignored - this endpoint cannot return anything but the chart it is named for. /api/astro/chart/ is where to go for the other 24 divisions.
https://yogataraapi.prahlad.app/api/astro/hora-chart/Authentication
Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonRequest fields
| Field | Type | Required | Notes |
|---|---|---|---|
| chart_name | string | required | |
| datetime | string (date-time) | required | The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC. Same meaning as date_time, which other endpoints call the same thing by a different name. |
| latitude | number (double) | required | Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first. min -89.9 · max 89.9 |
| longitude | number (double) | required | Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China. min -180 · max 180 |
| aberration | boolean | optional | |
| apply_correction | boolean | optional | |
| ascendant_pos | string | optional | cuspstartend |
| ayanamsa | string | optional | |
| correction_deg | integer | optional | min 0 |
| correction_direction | string | optional | addsubtract |
| correction_min | integer | optional | min 0 · max 59 |
| correction_sec | integer | optional | min 0 · max 59 |
| extended_bodies | array | optional | Body groups to include: 'asteroids', 'planetary_moons', 'fictitious_bodies'. |
| notation | string | optional | astrologicaldegree |
| nutation | boolean | optional | |
| rahu | string | optional | Node type to include. 'true' returns true nodes only, 'mean' returns mean nodes only, 'both' returns both. truemeanboth |
| refraction | boolean | optional | |
| true_mean | string | optional | TrueMean |
| use_28_nakshatras | boolean | optional |
Example request
curl -X POST https://yogataraapi.prahlad.app/api/astro/hora-chart/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"datetime":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"ayanamsa":"LAHIRI"}'Response
{
"data": {
"planets": [
{
"name": "sun",
"longitude": 148.76166666666666,
"latitude": 0,
"nakshatra": "Uttara Phalguni",
"pada": 1,
"kakshya": "ascendant",
"zodiac_name": "Leo",
"house": 1
},
{
"name": "moon",
"longitude": 122.95555555555556,
"latitude": 4.37,
"nakshatra": "Makha",
"pada": 1,
"kakshya": "saturn",
"zodiac_name": "Leo",
"house": 1
},
{
"name": "mars",
"longitude": 98.34944444444444,
"latitude": 0.535,
"nakshatra": "Pushyami",
"pada": 2,
"kakshya": "mars",
"zodiac_name": "Cancer",
"house": 12
},
{
"name": "mercury",
"longitude": 97.01555555555557,
"latitude": 1.574,
"nakshatra": "Pushyami",
"pada": 2,
"kakshya": "jupiter",
"zodiac_name": "Cancer",
"house": 12
},
{
"name": "jupiter",
"longitude": 128.9438888888889,
"latitude": 0.529,
"nakshatra": "Makha",
"pada": 3,
"kakshya": "mars",
"zodiac_name": "Leo",
"house": 1
},
{
"name": "venus",
"longitude": 147.91166666666666,
"latitude": -3.391,
"nakshatra": "Uttara Phalguni",
"pada": 1,
"kakshya": "ascendant",
"zodiac_name": "Leo",
"house": 1
},
{
"name": "saturn",
"longitude": 128.89388888888888,
"latitude": -2.651,
"nakshatra": "Makha",
"pada": 3,
"kakshya": "mars",
"zodiac_name": "Leo",
"house": 1
},
{
"name": "northtruenode",
"longitude": 131.13166666666666,
"latitude": 0,
"nakshatra": "Makha",
"pada": 4,
"kakshya": "mars",
"zodiac_name": "Leo",
"house": 1
},
{
"name": "southtruenode",
"longitude": 131.13166666666666,
"latitude": 0,
"nakshatra": "Makha",
"pada": 4,
"kakshya": "mars",
"zodiac_name": "Leo",
"house": 1
},
{
"name": "uranus",
"longitude": 112.84777777777778,
"latitude": -0.154,
"nakshatra": "Aasresha",
"pada": 2,
"kakshya": "moon",
"zodiac_name": "Cancer",
"house": 12
},
{
"name": "neptune",
"longitude": 108.86555555555556,
"latitude": -1.412,
"nakshatra": "Aasresha",
"pada": 1,
"kakshya": "Mercury",
"zodiac_name": "Cancer",
"house": 12
},
{
"name": "pluto",
"longitude": 108.55777777777776,
"latitude": -4.3,
"nakshatra": "Aasresha",
"pada": 1,
"kakshya": "venus",
"zodiac_name": "Cancer",
"house": 12
}
],
"ascendant": {
"longitude": 144.37555555555556,
"zodiac_name": "Leo",
"nakshatra": "Makha",
"pada": 4
},
"ayanamsa": {
"name": "LAHIRI",
"corrected": false,
"value_degrees": 24.229599,
"formatted": "24°13'47\""
}
},
"status": 200,
"is_error": false,
"message": "successful"
}Captured from a real call using the exact request above. Results sit under data.
Errors
Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.