# RoxyAPI Chinese Astrology API

**Canonical:** https://apis.io/apis/roxyapi/roxyapi-chinese-astrology-api/  
**Provider:** RoxyAPI — https://apis.io/providers/roxyapi/  
**Base URL:** https://roxyapi.com/api/v2  
**Documentation:** https://roxyapi.com/api-reference

RoxyAPI Chinese Astrology API is one of 16 APIs that [RoxyAPI](https://apis.io/providers/roxyapi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Chinese Astrology. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Calculate BaZi Four Pillars charts, Chinese zodiac signs, and the Chinese lunisolar calendar from any birth moment: year, month, day and hour pillars with hidden stems, Na Yin and Ten God relations, luck pillars, day master strength, and animal compatibility. The school splits that make two calculators disagree are typed parameters rather than hidden defaults, and every chart echoes the conventions it was computed under. Solar terms come back as astronomical instants, lunar dates convert in both directions with leap months placed correctly, and the Tong Shu almanac covers day officers, lunar mansions and date selection. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| POST | `/chinese-astrology/bazi/chart` | Generate BaZi chart - Four Pillars of Destiny calculator API |
| POST | `/chinese-astrology/bazi/luck-pillars` | Calculate luck pillars - BaZi Da Yun ten-year cycle API |
| POST | `/chinese-astrology/bazi/day-master` | Calculate Day Master strength - BaZi favorable element API |
| POST | `/chinese-astrology/bazi/compatibility` | Calculate BaZi compatibility - Four Pillars matchmaking API |
| POST | `/chinese-astrology/bazi/annual-forecast` | Calculate BaZi annual forecast - Liu Nian yearly pillar API |
| GET | `/chinese-astrology/zodiac/animals` | List the 12 Chinese zodiac animals - Sheng Xiao sign catalogue |
| GET | `/chinese-astrology/zodiac/animals/{id}` | Get one Chinese zodiac animal - Full sign profile with compatibility partners |
| POST | `/chinese-astrology/zodiac/sign` | Find the Chinese zodiac animal for a birth date - Sheng Xiao calculator |
| GET | `/chinese-astrology/zodiac/compatibility/{sign1}/{sign2}` | Chinese zodiac compatibility - Trine, six harmony, clash and harm analysis |
| GET | `/chinese-astrology/zodiac/{id}/daily` | Daily Chinese zodiac reading - Day pillar forecast by animal sign |
| GET | `/chinese-astrology/calendar/solar-terms/{year}` | List the 24 solar terms - Jie Qi calendar API with exact instants |
| POST | `/chinese-astrology/calendar/lunar-date` | Convert lunar and Gregorian dates - Chinese lunisolar calendar API |
| GET | `/chinese-astrology/calendar/day/{date}` | Get the almanac for a day - Tong Shu API with day officers and mansions |
| GET | `/chinese-astrology/calendar/monthly` | Get a month of almanac days - Chinese calendar month view API |
| POST | `/chinese-astrology/calendar/auspicious-days` | Find auspicious days - Chinese date selection API for weddings and openings |
| GET | `/chinese-astrology/elements` | List the five elements - Wu Xing API with generating and controlling cycles |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/roxyapi/refs/heads/main/openapi/roxyapi-chinese-astrology-api-openapi.yml
- **Documentation** — https://roxyapi.com/docs/introduction
- **PostmanCollection** — https://www.postman.com/roxylabs-7113570/roxyapi
- **LLMsTxt** — https://roxyapi.com/llms.txt
- **AgentSkills** — https://roxyapi.com/AGENTS.md
- **Documentation** — https://roxyapi.com/mcp/docs
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/roxyapi/refs/heads/main/mcp/roxyapi-tool-crosswalk.yml

## Other RoxyAPI APIs (12)

- [RoxyAPI Angel Numbers API](https://apis.io/apis/roxyapi/roxyapi-angel-numbers-api/)
- [RoxyAPI Biorhythm API](https://apis.io/apis/roxyapi/roxyapi-biorhythm-api/)
- [RoxyAPI Crystals and Healing Stones API](https://apis.io/apis/roxyapi/roxyapi-crystals-and-healing-stones-api/)
- [RoxyAPI Dreams API](https://apis.io/apis/roxyapi/roxyapi-dreams-api/)
- [RoxyAPI Feng Shui API](https://apis.io/apis/roxyapi/roxyapi-feng-shui-api/)
- [RoxyAPI Forecast API](https://apis.io/apis/roxyapi/roxyapi-forecast-api/)
- [RoxyAPI Human Design API](https://apis.io/apis/roxyapi/roxyapi-human-design-api/)
- [RoxyAPI I Ching API](https://apis.io/apis/roxyapi/roxyapi-i-ching-api/)
- [RoxyAPI Languages API](https://apis.io/apis/roxyapi/roxyapi-languages-api/)
- [RoxyAPI Location and Timezone API](https://apis.io/apis/roxyapi/roxyapi-location-and-timezone-api/)
- [RoxyAPI Numerology API](https://apis.io/apis/roxyapi/roxyapi-numerology-api/)
- [RoxyAPI Tarot API](https://apis.io/apis/roxyapi/roxyapi-tarot-api/)

## Tags

Chinese Astrology

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/roxyapi/roxyapi-chinese-astrology-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/roxyapi/.