# True solar time

`POST https://api.astroway.info/v1/chinese/true-solar-time`

The clock corrected to the sun over the birth longitude, split into the meridian term and the equation of time. China runs one zone across sixty degrees, so a Kashgar birth reads nearly three hours from solar noon on a Beijing clock, which moves the hour pillar.

Group: Chinese: Zodiac & Feng Shui. Auth: `X-Api-Key` header. Operation ID: `chinese_true-solar-time`.

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `date` | string | yes |  |
| `time` | string | yes |  |
| `timezoneOffset` | number | yes |  |
| `longitude` | number | yes |  |
| `language` | string | no |  |

```json
{
  "date": "1995-06-15",
  "time": "09:20:00",
  "timezoneOffset": 8,
  "longitude": 75.9
}
```

## Responses

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

### Success fields, under `data`

| Field | Type | Required | Description |
|---|---|---|---|
| `input` | object | no |  |
| `input.date` | string | no |  |
| `input.time` | string | no |  |
| `input.timezoneOffset` | number | no |  |
| `input.longitude` | number | no |  |
| `clockTime` | string | no |  |
| `trueSolarTime` | string | no |  |
| `totalCorrectionMinutes` | number | no |  |
| `longitudeCorrectionMinutes` | number | no |  |
| `equationOfTimeMinutes` | number | no |  |
| `dayShift` | number | no |  |
| `date` | string | no |  |
| `hourBranchNote` | string | no |  |
| `methodology` | string | no |  |
| `note` | string | no |  |
| `source` | string | no |  |

## Example

```bash
curl -X POST https://api.astroway.info/v1/chinese/true-solar-time \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1995-06-15", "time": "09:20:00", "timezoneOffset": 8, "longitude": 75.9 }'
```

---

Rendered from https://api.astroway.info/v1/openapi.json. HTML page: https://api.astroway.info/docs/api/operations/chinese_true-solar-time/