---
title: "Annual flying stars and afflictions"
method: POST
path: "/chinese/feng-shui/annual-stars"
tags: ["Chinese: Zodiac & Feng Shui"]
---

# Annual flying stars and afflictions

`POST /chinese/feng-shui/annual-stars`

The nine annual stars for a solar year, plus Tai Sui, Sui Po, San Sha, the five yellow and the two black with the sectors they occupy. Optionally the monthly layer. The year turns at Li Chun, computed from the exact solar term.

## Request body

- ChineseAnnualStarsInput
  - `year` integer
  - `date` string
  - `time` string
  - `timezoneOffset` number, nullable — 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.
  - `includeMonthly` boolean

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `solarYear` number, nullable
    - `yearBranch` string, nullable
    - `animal` string, nullable
    - `centreStar` object, nullable
      - `star` number, nullable
      - `chinese` string, nullable
    - `palaces` object[], nullable
      - `palace` string, nullable
      - `star` number, nullable
      - `chinese` string, nullable
      - `nature` string, nullable
    - `afflictions` object[], nullable
      - `id` string, nullable
      - `chinese` string, nullable
      - `name` string, nullable
      - `mountains` string[], nullable
      - `sector` string, nullable
      - `advice` string, nullable

## Other responses

- `400` — Validation error
- `401` — Missing or invalid API key

---

[API](https://skmtc.net/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.net/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astroway/astroway-calculation-api/revisions/529d7d36d7d6/schema)