---
title: "Chinese zodiac sign texts (public, no key)"
method: GET
path: "/public/chinese/zodiac/texts"
tags: ["Public"]
---

# Chinese zodiac sign texts (public, no key)

`GET /public/chinese/zodiac/texts`

Short reading for each of the 12 animals (`character`, `strengths`, `caution`) and one paragraph per element on how it colours the sign, in 21 languages. Join `animals[animal]` and `elements[element.cycling]` from POST /chinese/zodiac/animal. Names are the same forms the Chinese endpoints return. `lang` is the language served; unknown codes resolve to `uk` like everywhere. Static data, `Cache-Control: public, max-age=604800`: fetch once per language.

## Query parameters

- `lang` string
- `fields` string
- `precision` integer

## Headers

- `Accept-Language` string

## Response `200`

OK

- object
  - `ok` boolean
  - `data` object
    - `lang` string, nullable
    - `textLocalized` boolean, nullable
    - `animals` object, nullable
      - `rat` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
      - `ox` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
      - `tiger` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
      - `rabbit` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
      - `dragon` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
      - `snake` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
      - `horse` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
      - `goat` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
      - `monkey` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
      - `rooster` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
      - `dog` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
      - `pig` object, nullable
        - `name` string, nullable
        - `character` string, nullable
        - `strengths` string, nullable
        - `caution` string, nullable
    - `elements` object, nullable
      - `wood` object, nullable
        - `name` string, nullable
        - `text` string, nullable
      - `fire` object, nullable
        - `name` string, nullable
        - `text` string, nullable
      - `earth` object, nullable
        - `name` string, nullable
        - `text` string, nullable
      - `metal` object, nullable
        - `name` string, nullable
        - `text` string, nullable
      - `water` object, nullable
        - `name` string, nullable
        - `text` 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-09-25** `a8633073fc86` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/public/chinese/zodiac/texts/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/aa473bce3f00?raw)