---
title: "24 Solar Terms for a Year"
method: POST
path: "/chinese/bazi/solar-terms"
tags: ["chinese"]
---

# 24 Solar Terms for a Year

`POST /chinese/bazi/solar-terms`

## Request

- Base URL: `https://api.openephemeris.com`
- URL: `https://api.openephemeris.com/chinese/bazi/solar-terms`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-OpenEphemeris-API-Key`
  - API key in header `X-API-Key`
  - API key in header `X-Service-Key`

Return all 24 Jiéqì (节气) solar terms for a given Gregorian year, with exact datetime (UTC) computed from true apparent solar longitude.

Includes both the 12 Jié (节, month-starting terms used in BaZi) and the 12 Qì (气, mid-month terms). Dates are computed via the same ephemeris bridge used by /chinese/bazi.

**Metering**: 3 units per call.

## Request body

- BaZiSolarTermsRequest
  - `year` integer, required: Gregorian year for which to compute all 24 solar terms.

## Response `200`

All 24 solar terms for the requested year.

- BaZiSolarTermsResponse
  - `success` boolean
  - `terms` BaZiSolarTermEntry[], required
    - `chinese` string, required
    - `datetime_utc` string, date-time, required
    - `julian_day` number, double, required
    - `kind` 'jie' | 'qi', required: 'jie' = month-starting term (used in BaZi month calculation); 'qi' = mid-month term.
    - `name` string, required
    - `solar_longitude` number, double, required: Sun's ecliptic longitude at which this term begins (degrees).
  - `year` integer, required

## Other responses

- `422`: Validation error.

---

[API](https://skmtc.dev/openephemeris/apis/open-ephemeris-api.md) · [All operations](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/revisions/d195a769cb89?raw)