Four Pillars (full)

POST

/bazi/four-pillars

• Production

All four pillars: year, month, day, hour. Day pillar uses HKO-canonical 60-jiazi cycle (anchor 1990-01-01 = Yi-Wei). Pass time to compute hour pillar; pass time + timezoneOffset for traditional 23:00-CST day-shift handling.

Authorizations

• ApiKeyAuth

Code Samples

cURL

curl -X POST https://api.astroway.info/v1/bazi/four-pillars \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3 }'

Node.js

const res = await fetch('https://api.astroway.info/v1/bazi/four-pillars', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3
  }),
});
const { ok, data, error } = await res.json();
if (!ok) throw new Error(error.message);
console.log(data);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/bazi/four-pillars',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
      'date': "1990-05-15",
      'time': "14:30:00",
      'timezoneOffset': 3
    },
)
result = r.json()
if not result['ok']:
    raise RuntimeError(result['error']['message'])
print(result['data'])

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('bazi/four-pillars', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-05-15',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
    ],
]);
$result = json_decode($r->getBody(), true);
if (!$result['ok']) throw new \RuntimeException($result['error']['message']);
print_r($result['data']);

Request Body ^required

object

Example

{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3
}

Responses

200

Successful calculation

object

ok

boolean

Example

true

data

object

yearPillar

object

pillar

string

monthPillar

object

pillar

string

dayPillar

object

pillar

string

stem

string

branch

string

animal

string

stemElement

string

branchElement

string

yin

boolean

hourPillar

object

pillar

string

400

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"
      }
    ]
  }
}

401

Missing or invalid API key

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}