Skip to content
96Astro API

Western astrology

Available

Planetary Hours API

The 24 planetary hours for a date and place: the Chaldean order from the weekday's ruler, twelve unequal hours from sunrise to sunset and twelve from sunset to the next sunrise, each with its ruler, start, end and traditional use. Give a time to get the hour in effect.

  • POST /v1/western/planetary-hours
  • 1 credit
Request
curl https://api.96astroapi.com/v1/western/planetary-hours \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "date": "2026-11-20",
      "timezone": "Asia/Kolkata",
      "latitude": 28.6139,
      "longitude": 77.209
    }'

Overview

The 24 planetary hours for a date and place: the Chaldean order from the weekday's ruler, twelve unequal hours from sunrise to sunset and twelve from sunset to the next sunrise, each with its ruler, start, end and traditional use. Give a time to get the hour in effect.

Call it with POST /v1/western/planetary-hours. Input: date and place. Output: JSON, as a direct response. Each successful call costs 1 credit.

  • POST /v1/western/planetary-hours
  • 1 credit
  • Date and place

Try it

Runs the real calculation, free and without a key, a few times a minute. For more, and for AI readings, get a free sandbox key.

Response

Ready when you are

Press Run it to see the live response here.

Example response

Fields in dataInferred from the example response: a guide to the shape, not a contract.

  • datestring
  • weekdaystring
  • day_rulerstring
  • sunrisestring
  • sunsetstring
  • next_sunrisestring
  • day_hour_minutesnumber
  • night_hour_minutesnumber
  • hoursarray of object
  • methodstring
  • notestring
200Example response

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and image data is shortened.

Loading the example…

Request schema and every field: the Western astrology reference.

FAQ

Planetary Hours API: common questions

4answers

Ask the team
01What does the Planetary Hours API return?

The 24 planetary hours for a date and place: the Chaldean order from the weekday's ruler, twelve unequal hours from sunrise to sunset and twelve from sunset to the next sunrise, each with its ruler, start, end and traditional use. Give a time to get the hour in effect. The response's data object includes date, weekday, day_ruler, sunrise, sunset, next_sunrise, day_hour_minutes and night_hour_minutes. See the reference for an example response.

02What input does Planetary Hours need?

Date and place.

03How much does a Planetary Hours call cost?

1 credit per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.

04Can I try it before paying?

Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.

Send us feedback

What is it about?