Planetary Hours
curl -X POST https://api.astroway.info/v1/planetary-hours \ -H "X-Api-Key: aw_live_..." \ -H "Content-Type: application/json" \ -d '{ "date": "2026-06-21", "latitude": 50.45, "longitude": 30.52, "timezoneOffset": 3, "atLocalHour": 15.2 }'const res = await fetch('https://api.astroway.info/v1/planetary-hours', { method: 'POST', headers: { 'X-Api-Key': process.env.ASTROWAY_API_KEY, 'Content-Type': 'application/json', }, body: JSON.stringify({ "date": "2026-06-21", "latitude": 50.45, "longitude": 30.52, "timezoneOffset": 3, "atLocalHour": 15.2 }),});const { ok, data, error } = await res.json();if (!ok) throw new Error(error.message);console.log(data);import os, requests
r = requests.post( 'https://api.astroway.info/v1/planetary-hours', headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'}, json={ 'date': "2026-06-21", 'latitude': 50.45, 'longitude': 30.52, 'timezoneOffset': 3, 'atLocalHour': 15.2 },)result = r.json()if not result['ok']: raise RuntimeError(result['error']['message'])print(result['data'])<?phpuse GuzzleHttp\Client;
$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);$r = $client->post('planetary-hours', [ 'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')], 'json' => [ 'date' => '2026-06-21', 'latitude' => 50.45, 'longitude' => 30.52, 'timezoneOffset' => 3, 'atLocalHour' => 15.2, ],]);$result = json_decode($r->getBody(), true);if (!$result['ok']) throw new \RuntimeException($result['error']['message']);print_r($result['data']);Chaldean planetary hours for a date and place: 12 from sunrise to sunset and 12 from sunset to sunrise, so an hour is rarely 60 minutes. startHour and endHour are decimal local hours. Send atLocalHour (decimal local time, e.g. 15.2 for 15:12) to have the hour containing it marked isCurrent; without it no hour carries the field, because the answer is cacheable and a flag from the server clock would be stale by the time it renders. sunTimes.polarState is normal, polar-day or polar-night, and in the two polar cases there is nothing to divide, so hours comes back empty with a warning saying why.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.
Local time of day in decimal hours, e.g. 15.2 for 15:12. When sent, the hour containing it carries isCurrent: true and every other hour carries false. When omitted, no hour carries the field at all: it is not false, it is unasked.
Example
{ "date": "2026-06-21", "latitude": 50.45, "longitude": 30.52, "timezoneOffset": 3, "atLocalHour": 15.2}Responses
Section titled “ Responses ”Successful calculation
object
object
object
object
Example
{ "ok": true, "data": { "date": "2026-06-21", "latitude": 50.45, "longitude": 30.52, "timezone": 3, "sunTimes": { "riseJD": 2461212.573777389, "setJD": 2461213.2591750845, "riseHour": 4.770657330751419, "setHour": 21.220202028751373, "polarState": "normal" }, "dayRulerPlanetId": 0, "dayRulerPlanetName": "Sun", "dayOfWeek": 0, "hours": [ { "number": 1, "planetId": 0, "planetName": "Sun", "startHour": 4.770657330751419, "endHour": 6.141452722251415, "isDaytime": true, "isCurrent": false }, { "number": 8, "planetId": 0, "planetName": "Sun", "startHour": 14.366225071251392, "endHour": 15.737020462751389, "isDaytime": true, "isCurrent": true } ] }}Validation error
Example
{ "ok": false, "error": { "code": "INVALID_INPUT", "message": "Validation failed: date: Date must be YYYY-MM-DD", "details": [ { "path": "date", "message": "Date must be YYYY-MM-DD" } ] }}Missing or invalid API key
Example
{ "ok": false, "error": { "code": "INVALID_API_KEY", "message": "Invalid API key" }}