---
title: "Get Current BaZi Pillars (Time Now)"
method: GET
path: "/api/v1/chinese/today"
tags: ["Chinese", "chinese"]
---

# Get Current BaZi Pillars (Time Now)

`GET /api/v1/chinese/today`

## Request

- Base URL: `https://api.freeastroapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.freeastroapi.com/api/v1/chinese/today`
- Auth: none declared

Get current year, month, day, and hour pillars for the present moment.
Useful for "Today's energy" or quick transit checks.

## Query parameters

- `include_pinyin` boolean
- `lang` string: Response language. Supported: en, zh-Hans, zh-CN, zh_hans.

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/freeastroapi/apis/astroservice-api.md) · [All operations](https://skmtc.dev/freeastroapi/apis/astroservice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/freeastroapi/apis/astroservice-api/revisions/0c9b4a759522?raw)