Four Pillars (full)

POST

/bazi/four-pillars

request.sh

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 }'

• 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

Request Body ^required

Media type application/json

object

Example

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

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

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

Example

{
  "ok": true
}

400

Validation error

Media type application/json

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

Media type application/json

Example

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