{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"zodiac"},"result":{"entity_type":"calculator","id":"zodiac","calculator_id":"zodiac","canonical_url":"https://tttkmbb.com/everyday/zodiac","name":"Zodiac Sign Calculator","title":"Zodiac Sign Calculator – Western Sun Sign and Chinese Zodiac Animal, Element and Yin/Yang from Birth Date","category":"everyday","category_name":"Everyday Life","tool_name":"classify_zodiac_signs","featured_mcp_tool":false,"description":"Looks up the tropical Western sun sign (with its conventional date range and a cusp flag) and the Chinese zodiac animal, heavenly-stem element and yin/yang polarity for a birth date, using the actual Chinese New Year dates from 1924 to 2044 so January and February births are assigned to the correct lunar year.","use_when":"You need someone's star sign, whether they were born on a cusp, or their Chinese zodiac animal and element (e.g. Metal Horse) from a date of birth.","do_not_use_when":"You need a full natal chart (moon or rising sign, which depend on time and place of birth) or the exact minute the Sun changed sign in a given year; for ages and birthdays use age.","inputs":[{"name":"birth_date","label":"Date of birth","type":"date","required":true,"description":"Date of birth (ISO 8601, YYYY-MM-DD). Chinese zodiac is available for dates from 1924-02-05 to 2044-01-29.","example":"1990-05-17"}],"outputs":[{"name":"sun_sign","label":"Western sun sign","type":"string","decimals":4,"description":"Tropical zodiac sign by calendar date."},{"name":"sun_sign_dates","label":"Sign date range","type":"string","decimals":4,"description":"Conventional date range of the sign (boundaries can shift by a day between years)."},{"name":"sun_sign_element","label":"Sign element","type":"string","decimals":4,"description":"Classical element of the sign: fire, earth, air or water."},{"name":"on_cusp","label":"On a cusp","type":"boolean","decimals":4,"description":"true when the birthday is within one day of a sign boundary, so the real sign depends on the year and time of birth."},{"name":"chinese_animal","label":"Chinese zodiac animal","type":"string","decimals":4,"description":"One of the 12 earthly-branch animals (Rat … Pig) for the lunar year of birth."},{"name":"chinese_element","label":"Chinese element","type":"string","decimals":4,"description":"Heavenly-stem element of the lunar year: Wood, Fire, Earth, Metal or Water (each covers two consecutive years)."},{"name":"yin_yang","label":"Polarity","type":"string","decimals":4,"description":"Yang for even lunar years, Yin for odd lunar years."},{"name":"chinese_zodiac","label":"Chinese zodiac","type":"string","decimals":4,"description":"Combined label, e.g. 'Yang Metal Horse'."},{"name":"lunar_year","label":"Lunar year","type":"integer","decimals":4,"description":"Chinese lunar year the birth falls in (Gregorian year of its New Year)."},{"name":"chinese_year_start","label":"Lunar year starts","type":"date","decimals":4,"description":"Chinese New Year that began the birth year."},{"name":"chinese_year_end","label":"Lunar year ends","type":"date","decimals":4,"description":"Day before the next Chinese New Year."}],"input_schema":{"type":"object","properties":{"birth_date":{"description":"Date of birth (ISO 8601, YYYY-MM-DD). Chinese zodiac is available for dates from 1924-02-05 to 2044-01-29.","type":"string","format":"date","examples":["1990-05-17"]}},"additionalProperties":false,"required":["birth_date"]},"output_schema":{"type":"object","properties":{"sun_sign":{"description":"Tropical zodiac sign by calendar date.","type":"string"},"sun_sign_dates":{"description":"Conventional date range of the sign (boundaries can shift by a day between years).","type":"string"},"sun_sign_element":{"description":"Classical element of the sign: fire, earth, air or water.","type":"string"},"on_cusp":{"description":"true when the birthday is within one day of a sign boundary, so the real sign depends on the year and time of birth.","type":"boolean"},"chinese_animal":{"description":"One of the 12 earthly-branch animals (Rat … Pig) for the lunar year of birth.","type":"string"},"chinese_element":{"description":"Heavenly-stem element of the lunar year: Wood, Fire, Earth, Metal or Water (each covers two consecutive years).","type":"string"},"yin_yang":{"description":"Yang for even lunar years, Yin for odd lunar years.","type":"string"},"chinese_zodiac":{"description":"Combined label, e.g. 'Yang Metal Horse'.","type":"string"},"lunar_year":{"description":"Chinese lunar year the birth falls in (Gregorian year of its New Year).","type":"integer"},"chinese_year_start":{"description":"Chinese New Year that began the birth year.","type":"string","format":"date"},"chinese_year_end":{"description":"Day before the next Chinese New Year.","type":"string","format":"date"}}},"formula":"sun_sign: tropical sign whose conventional date range contains (month, day): Aries 21 Mar–19 Apr, Taurus 20 Apr–20 May, Gemini 21 May–20 Jun, Cancer 21 Jun–22 Jul, Leo 23 Jul–22 Aug, Virgo 23 Aug–22 Sep, Libra 23 Sep–22 Oct, Scorpio 23 Oct–21 Nov, Sagittarius 22 Nov–21 Dec, Capricorn 22 Dec–19 Jan, Aquarius 20 Jan–18 Feb, Pisces 19 Feb–20 Mar. Chinese: lunar_year = year if birth_date ≥ Chinese New Year of that year, else year − 1; animal = (Rat, Ox, Tiger, Rabbit, Dragon, Snake, Horse, Goat, Monkey, Rooster, Dog, Pig)[(lunar_year − 1924) mod 12]; element = (Wood, Fire, Earth, Metal, Water)[floor(((lunar_year − 1924) mod 10) / 2)]; polarity = Yang if lunar_year is even else Yin","method":"Western sign boundaries use the common calendar convention; the Sun's actual ingress varies by about a day from year to year, so dates within one day of a boundary are flagged as cusp. Chinese New Year dates 1924–2044 are taken from the Hong Kong Observatory lunar-calendar tables; 1924 (Jia-Zi, Wood Rat) starts the current sexagenary cycle.","sources":[{"name":"Hong Kong Observatory – Gregorian-Lunar Calendar Conversion Table","url":"https://www.hko.gov.hk/en/gts/time/conversion.htm","type":"government","retrieved_at":"2026-09-24"},{"name":"Chinese zodiac – table of years with Gregorian start and end dates, 1924–2043 (Wikipedia)","url":"https://en.wikipedia.org/wiki/Chinese_zodiac","type":"reference","retrieved_at":"2026-09-24"},{"name":"Astrological sign – tropical sun-sign dates (Wikipedia)","url":"https://en.wikipedia.org/wiki/Astrological_sign","type":"reference","retrieved_at":"2026-09-24"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"Born 1990-05-17","inputs":{"birth_date":"1990-05-17"},"expected":{"sun_sign":"Taurus","sun_sign_dates":"April 20 – May 20","sun_sign_element":"earth","on_cusp":false,"chinese_animal":"Horse","chinese_element":"Metal","yin_yang":"Yang","chinese_zodiac":"Yang Metal Horse","lunar_year":1990,"chinese_year_start":"1990-01-27","chinese_year_end":"1991-02-14"},"url":"https://tttkmbb.com/api/v1/calculate/zodiac?birth_date=1990-05-17"},{"name":"Born 2000-01-15 (before Chinese New Year 2000-02-05)","inputs":{"birth_date":"2000-01-15"},"expected":{"sun_sign":"Capricorn","on_cusp":false,"chinese_animal":"Rabbit","chinese_element":"Earth","yin_yang":"Yin","chinese_zodiac":"Yin Earth Rabbit","lunar_year":1999,"chinese_year_start":"1999-02-16","chinese_year_end":"2000-02-04"},"url":"https://tttkmbb.com/api/v1/calculate/zodiac?birth_date=2000-01-15"}],"faq":[{"q":"Why does a January or February birthday get the previous year's animal?","a":"The Chinese zodiac follows the lunisolar year, which starts on Chinese New Year (between 21 January and 20 February). Someone born on 15 January 2000 was born in the lunar year 1999, the Earth Rabbit, not the Metal Dragon."},{"q":"What does 'on a cusp' mean?","a":"The Sun enters each sign at a specific moment that shifts by about a day from year to year, so a birth within a day of the conventional boundary could belong to either sign; an ephemeris for the birth year and time settles it."},{"q":"Is the Chinese element the same as the animal's fixed element?","a":"No. This calculator reports the heavenly-stem element of the year (changes every two years); each animal also has a fixed branch element (e.g. Horse is fire) used in some traditions."}],"tags":["zodiac sign","star sign","chinese zodiac","what is my sign","chinese new year animal","horoscope sign by date"],"related":[{"calculator_id":"age","reason":"Exact age and next birthday from the same date of birth."},{"calculator_id":"day-of-week","reason":"Weekday of the birth date."}],"links":{"html":"https://tttkmbb.com/everyday/zodiac","markdown":"https://tttkmbb.com/everyday/zodiac.md","json":"https://tttkmbb.com/everyday/zodiac.json","api":"https://tttkmbb.com/api/v1/calculate/zodiac","schema":"https://tttkmbb.com/api/v1/calculators/zodiac","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-24"},"timestamp":"2026-09-24T01:58:20Z"}