Symbolic stars (Shen Sha)

POST

/bazi/symbolic-stars

request.sh

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

▸ Спробувати POST /bazi/symbolic-stars

• Production

Peach Blossom, Travelling Horse, Canopy, Heavenly Nobleman, Blade and Void, computed from BOTH the year and the day reference pillar because the transmissions disagree about which one the rules read from. Where two transmissions place a star differently, both placements ship and each names the other.

Authorizations

• ApiKeyAuth

Request Body ^required

Media type application/json

object

date required

string

/^\d{4}-\d{2}-\d{2}$/

time

string

/^\d{2}:\d{2}(:\d{2})?$/

timezoneOffset

number

>= -14 <= 14

longitude

number

>= -180 <= 180

trueSolarTime

boolean

stageSchool

string

Allowed values: classical unified

includeFullTable

boolean

language

string

Example

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

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

solarYear

number

nullable

pillars

Array<object>

nullable

object

name

string

nullable

stem

string

nullable

branch

string

nullable

pillar

string

nullable

byYearPillar

Array<object>

nullable

object

key

string

nullable

chinese

string

nullable

pinyin

string

nullable

english

string

nullable

pillars

Array<string>

nullable

meaning

string

nullable

schoolNote

string

nullable

byDayPillar

Array<object>

nullable

object

key

string

nullable

chinese

string

nullable

pinyin

string

nullable

english

string

nullable

pillars

Array<string>

nullable

meaning

string

nullable

referenceNote

string

nullable

notes

Array

nullable

methodology

string

nullable

source

string

nullable

disclaimer

string

nullable

Example

{
  "ok": true,
  "data": {
    "solarYear": 1990,
    "pillars": [
      {
        "name": "year",
        "stem": "Geng",
        "branch": "Wu",
        "pillar": "Geng-Wu"
      },
      {
        "name": "month",
        "stem": "Xin",
        "branch": "Si",
        "pillar": "Xin-Si"
      },
      {
        "name": "day",
        "stem": "Geng",
        "branch": "Chen",
        "pillar": "Geng-Chen"
      },
      {
        "name": "hour",
        "stem": "Gui",
        "branch": "Wei",
        "pillar": "Gui-Wei"
      }
    ],
    "byYearPillar": [
      {
        "key": "nobleman",
        "chinese": "天乙貴人",
        "pinyin": "Tian Yi Gui Ren",
        "english": "Heavenly Nobleman",
        "pillars": [
          "hour"
        ],
        "meaning": "help arriving from outside, the patron and the timely intervention",
        "schoolNote": "The 三命通會 reading for 庚 (甲戊庚牛羊). 淵海子平 puts the 庚 nobleman at 午 and 寅 instead; that reading is reported separately."
      },
      {
        "key": "noblemanAlt",
        "chinese": "天乙貴人",
        "pinyin": "Tian Yi Gui Ren",
        "english": "Heavenly Nobleman (淵海子平 reading)",
        "pillars": [
          "year"
        ],
        "meaning": "help arriving from outside, the patron and the timely intervention",
        "schoolNote": "The 淵海子平 and 星平會海 reading for 庚 (庚辛逢馬虎). The 三命通會 reading is reported under `nobleman`."
      }
    ],
    "byDayPillar": [
      {
        "key": "canopy",
        "chinese": "華蓋",
        "pinyin": "Hua Gai",
        "english": "Canopy",
        "pillars": [
          "day"
        ],
        "meaning": "solitude and study, the scholar and the recluse"
      },
      {
        "key": "nobleman",
        "chinese": "天乙貴人",
        "pinyin": "Tian Yi Gui Ren",
        "english": "Heavenly Nobleman",
        "pillars": [
          "hour"
        ],
        "meaning": "help arriving from outside, the patron and the timely intervention",
        "schoolNote": "The 三命通會 reading for 庚 (甲戊庚牛羊). 淵海子平 puts the 庚 nobleman at 午 and 寅 instead; that reading is reported separately."
      },
      {
        "key": "noblemanAlt",
        "chinese": "天乙貴人",
        "pinyin": "Tian Yi Gui Ren",
        "english": "Heavenly Nobleman (淵海子平 reading)",
        "pillars": [
          "year"
        ],
        "meaning": "help arriving from outside, the patron and the timely intervention",
        "schoolNote": "The 淵海子平 and 星平會海 reading for 庚 (庚辛逢馬虎). The 三命通會 reading is reported under `nobleman`."
      }
    ],
    "referenceNote": "Star rules key off a reference pillar. The older transmission reads from the year, later practice from the day, and the two disagree often enough that picking one silently would be a school choice disguised as a result.",
    "notes": [],
    "methodology": "神煞. Only the six stars every transmission carries with the same rule are implemented: 桃花, 驛馬, 華蓋, 天乙貴人, 羊刃 and 空亡. The full register runs to hundreds of entries, most of them local to one almanac, and those are deliberately absent rather than guessed.",
    "source": "三命通會 (Wan Minying, Ming), public domain",
    "disclaimer": "BaZi pillars use the canonical 60-jiazi cycle, anchored at 1990-01-01 = Bing-Yin. Year and month boundaries are the exact Lichun and 節 instants from the ephemeris, stated in China Standard Time; pass time and timezoneOffset for births near a boundary. Day and hour follow the birthplace clock, with the day rolling at 23:00 local."
  }
}

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