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

GET

/public/chinese/zodiac/daily-reading

Code sample: cURL

request.sh

curl 'https://api.astroway.info/v1/public/chinese/zodiac/daily-reading?animal=horse&date=2026-10-07&lang=en'

▸ Try it GET /public/chinese/zodiac/daily-reading

• Production

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.

Parameters

Query Parameters

animal required

string

Allowed values: rat ox tiger rabbit dragon snake horse goat monkey rooster dog pig

One of the twelve, English, any case.

date

string format: date

Calendar date YYYY-MM-DD (UTC). Defaults to today.

lang

string

Example

en

Language for this call, overriding Accept-Language. The canonical per-call form: a page that renders in one language passes it here rather than reconfiguring its client. Unknown or inactive codes fall back to uk.

fields

string

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

Example

planets.name,planets.longitude

precision

integer

<= 15

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Example

4

Header Parameters

Accept-Language

string

BCP-47 language (e.g. uk, en, de). Set it once on your HTTP client as its default; for a single call, ?lang= overrides it. Unknown or inactive codes fall back to uk.

Responses

200

OK

Media type application/json

object

ok

boolean

data

object

animal

string

nullable

animalName

string

nullable

date

string

nullable

dayPillar

object

stem

string

nullable

branch

string

nullable

animal

string

nullable

element

string

nullable

yin

boolean

nullable

year

object

relation

string

nullable

chinese

nullable

day

object

relation

string

nullable

chinese

string

nullable

benMingNian

boolean

nullable

energy

object

score

number

nullable

factors

Array<object>

nullable

object

source

string

nullable

relation

string

nullable

chinese

string

nullable

effect

number

nullable

reading

object

overview

string

nullable

love

string

nullable

career

string

nullable

advice

string

nullable

disclaimer

string

nullable

model

string

nullable

language

string

nullable

_footer

Free-tier watermark, present on every public response. Keys on a paid plan do not receive it.

string

Example

{
  "ok": true,
  "data": {
    "animal": "Horse",
    "animalName": "Horse",
    "date": "2026-10-07",
    "dayPillar": {
      "stem": "Jia",
      "branch": "Yin",
      "animal": "Tiger",
      "element": "Wood",
      "yin": false
    },
    "year": {
      "relation": "same",
      "chinese": null
    },
    "day": {
      "relation": "trine",
      "chinese": "三合"
    },
    "benMingNian": true,
    "energy": {
      "score": 6,
      "factors": [
        {
          "source": "day",
          "relation": "trine",
          "chinese": "三合",
          "effect": 2
        },
        {
          "source": "year",
          "relation": "same",
          "chinese": null,
          "effect": -1
        }
      ]
    },
    "reading": {
      "overview": "A yang Wood Tiger day sits in the Horse's own trine...",
      "love": "Warmth comes easily today...",
      "career": "Shared work moves faster than solo effort...",
      "advice": "Say yes to one invitation you would usually postpone."
    },
    "disclaimer": "This is generated by AI for entertainment and self-reflection purposes only.",
    "model": "gemini/gemini-2.5-flash",
    "language": "en"
  },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

400

Invalid sign or date

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_SIGN",
    "message": "sign must be one of the 12 zodiac signs"
  }
}