---
title: "Chinese sign reading of the day (public, no key)"
method: GET
path: "/public/chinese/zodiac/daily-reading"
tags: ["Public"]
---

# Chinese sign reading of the day (public, no key)

`GET /public/chinese/zodiac/daily-reading`

## Request

- Base URL: `https://api.astroway.info/v1`
- URL: `https://api.astroway.info/v1/public/chinese/zodiac/daily-reading`
- Auth: none required

GET /public/chinese/zodiac/daily read into prose in the requested language: the same fields plus `reading` with `overview`, `love`, `career` and `advice`, and `disclaimer`, `model`, `language`. The reading uses only the facts in the answer (pillars, branch relations, Ben Ming Nian, energy and its factors): no lucky numbers, colours or directions. Generated once per animal, date and language and cached for the day, so every site gets the same text. 503 `AI_UNAVAILABLE` if no model answers. Costs 1 unit of the public bucket.

## Query parameters

- `animal` 'rat' | 'ox' | 'tiger' | 'rabbit' | 'dragon' | 'snake' | 'horse' | 'goat' | 'monkey' | 'rooster' | 'dog' | 'pig', required
- `date` string, date
- `lang` string
- `fields` string
- `precision` integer

## Headers

- `Accept-Language` string

## Response `200`

OK

- object
  - `ok` boolean
  - `data` object
    - `animal` string, nullable
    - `animalName` string, nullable
    - `date` string, nullable
    - `dayPillar` object, nullable
      - `stem` string, nullable
      - `branch` string, nullable
      - `animal` string, nullable
      - `element` string, nullable
      - `yin` boolean, nullable
    - `year` object, nullable
      - `relation` string, nullable
      - `chinese` unknown
    - `day` object, nullable
      - `relation` string, nullable
      - `chinese` string, nullable
    - `benMingNian` boolean, nullable
    - `energy` object, nullable
      - `score` number, nullable
      - `factors` object[], nullable
        - `source` string, nullable
        - `relation` string, nullable
        - `chinese` string, nullable
        - `effect` number, nullable
    - `reading` object, nullable
      - `overview` string, nullable
      - `love` string, nullable
      - `career` string, nullable
      - `advice` string, nullable
    - `disclaimer` string, nullable
    - `model` string, nullable
    - `language` string, nullable
  - `_footer` string: Free-tier watermark, present on every public response. Keys on a paid plan do not receive it.

## Other responses

- `400`: Invalid sign or date

## Changes

- **2026-10-08** `20df311a9098`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/public/chinese/zodiac/daily-reading/get.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/astroway/apis/astroway-calculation-api/revisions/593d763ba9a5?raw)