Zodiac Sign API

Exact zodiac sign from a birth date, time and time zone (computed from the Sun's real position, so cusp birthdays are right) plus the Chinese zodiac from the real lunisolar calendar: animal, element, yin/yang and the year's start and end dates.

Authentication & base URL

Subscribe through one of our marketplace listings; your marketplace API key and base URL are shown there. All endpoints return JSON over HTTPS, served from a global edge network (typically 20–150 ms).

Subscribe on RapidAPI

Endpoints

GET `/v1/zodiac`

Signs for a birth date

Parameter	In	Description	Example
`birthdate` *	query	YYYY-MM-DD	`1999-02-12`
`time`	query	HH:MM 24h (default 12:00)	`14:30`
`tz`	query	IANA time zone of the birth place	`Europe/Madrid`

GET `/v1/zodiac/chinese`

Chinese zodiac year

Parameter	In	Description	Example
`year` *	query	Year 1901-2099	`2026`

GET `/v1/zodiac/signs`

All western signs

Example

GET /v1/zodiac?birthdate=1999-02-12&time=14%3A30&tz=Europe%2FMadrid

{
  "birth": {
    "date": "1999-02-12",
    "time": "14:30",
    "timezone": "Europe/Madrid",
    "utc": "1999-02-12T13:30:00.000Z"
  },
  "western": {
    "sign": "Aquarius",
    "symbol": "♒",
    "element": "Air",
    "modality": "Fixed",
    "rulingPlanet": "Uranus (traditional: Saturn)",
    "typicalDates": "Jan 20 - Feb 18",
    "sunLongitude": 323.388,
    "degreeInSign": 23.39
  },
  "chinese": {
    "year": 1998,
    "animal": "Tiger",
    "element": "Earth",
    "yinYang": "Yang",
    "name": "Earth Tiger",
    "stemBranch": "Wu-Yin",
    "startsOn": "1998-01-28",
    "endsOn": "1999-02-15"
  }
}

Use cases

Horoscope and astrology apps, dating and social apps, personalized content and newsletters, games, birthday and greeting tools.

Why this API

Exact: the sign comes from the Sun's ecliptic longitude at the birth moment, not from fixed date ranges that are wrong on cusp days.
Chinese years start on the real Chinese New Year (it moves every year), not on January 1.
Fair pricing: Free plan 500 requests/month, Pro 25,000 for $4.99, Ultra 150,000 for $14.99.

Support

Questions or a feature you need? Open a thread in the Discussions tab.

Pricing

Free plan with 500 calls per month, then Pro (25,000 calls for $4.99/month) and Ultra (150,000 calls for $14.99/month). See all plans.