Chinese Zodiac Animal

POST

/chinese/zodiac/animal

request.sh

curl -X POST https://api.astroway.info/v1/chinese/zodiac/animal \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }'

▸ Спробувати POST /chinese/zodiac/animal

• Production

Animal sign of the birth year, bounded by the exact Lichun instant, plus the full pillar (stem + branch + element). Pass time + timezoneOffset for births on the boundary day.

Authorizations

• ApiKeyAuth

Request Body ^required

Media type application/json

object

Example

{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

solarYear

number

nullable

animal

string

nullable

glyph

string

nullable

branch

string

nullable

stem

string

nullable

element

object

fixed

string

nullable

cycling

string

nullable

yin

boolean

nullable

pillar

string

nullable

Example

{
  "ok": true,
  "data": {
    "solarYear": 1990,
    "animal": "Horse",
    "glyph": "🐎",
    "branch": "Wu",
    "stem": "Geng",
    "element": {
      "fixed": "Fire",
      "cycling": "Metal",
      "yin": false
    },
    "pillar": "Geng-Wu"
  }
}

400

Validation error

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Date must be YYYY-MM-DD",
    "details": [
      {
        "path": "date",
        "message": "Date must be YYYY-MM-DD"
      }
    ]
  }
}

401

Missing or invalid API key

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}