# Full Chart (computed)

`POST https://api.astroway.info/v1/ziwei/chart`

Real star placement: soul and body palaces, the five-element class, all 14 main stars plus auxiliaries, the twelve stages, the 12 decade limits and the 四化 marked on the stars that carry them.

Group: Zi Wei Dou Shu (Purple Star). Auth: `X-Api-Key` header. Operation ID: `ziwei_chart`.

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `date` | string | yes |  |
| `time` | string | yes |  |
| `timezoneOffset` | number | no |  |
| `gender` | "male" \| "female" | yes |  |
| `school` | "zhongzhou" \| "quanji" \| "quanshu" \| "beipai" | no |  |
| `yearDivide` | "lunar" \| "lichun" | no |  |
| `fixLeap` | boolean | no |  |
| `dayDivide` | "forward" \| "current" | no |  |
| `tianmaSchool` | "year" \| "month" | no |  |
| `age` | integer | no |  |
| `language` | string | no |  |

```json
{
  "date": "2000-08-16",
  "time": "04:00:00",
  "gender": "male"
}
```

## Responses

| Status | Meaning |
|---|---|
| 200 | Successful calculation |
| 400 | Validation error |
| 401 | Missing or invalid API key |

### Success fields, under `data`

| Field | Type | Required | Description |
|---|---|---|---|
| `lunar` | object | no |  |
| `lunar.month` | number | no |  |
| `lunar.isLeapMonth` | boolean | no |  |
| `lunar.day` | number | no |  |
| `lunar.monthStart` | string | no |  |
| `fiveElementClass` | object | no |  |
| `fiveElementClass.key` | string | no |  |
| `fiveElementClass.chinese` | string | no |  |
| `fiveElementClass.value` | number | no |  |
| `soulPalace` | object | no |  |
| `soulPalace.index` | number | no |  |
| `soulPalace.branch` | string | no |  |
| `ziwei` | object | no |  |
| `ziwei.index` | number | no |  |
| `ziwei.branch` | string | no |  |
| `palaces` | object[] | no |  |
| `computed` | boolean | no |  |

## Example

```bash
curl -X POST https://api.astroway.info/v1/ziwei/chart \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "2000-08-16", "time": "04:00:00", "gender": "male" }'
```

---

Rendered from https://api.astroway.info/v1/openapi.json. HTML page: https://api.astroway.info/docs/api/operations/ziwei_chart/