{"openapi":"3.1.0","info":{"title":"Zodiac API","version":"1.0.0","description":"Turn a birth date into zodiac signs as an API. Get the Western (tropical) sun sign for any date — its symbol, element (Fire, Earth, Air, Water), quality, ruling planet, polarity, key traits and the signs it is most compatible with (e.g. 15 July → Cancer, Water, ruled by the Moon). Look up a sign by name, get the Chinese zodiac animal, element and yin/yang for any year (e.g. 2020 → Metal Rat), or fetch both Western and Chinese signs from a full birth date at once. Everything is computed locally, so it is fast and always available. Ideal for horoscope and astrology apps, dating and matchmaking, onboarding personalisation, content sites and fun widgets.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/zodiac-api","description":"oanor gateway"}],"tags":[{"name":"Zodiac"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/both":{"get":{"operationId":"get_v1_both","tags":["Zodiac"],"summary":"Western + Chinese for a full date","description":"","parameters":[{"name":"date","in":"query","required":true,"description":"Full birth date YYYY-MM-DD, e.g. 1990-07-15","schema":{"type":"string"},"example":"1990-07-15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"1990-07-15","chinese":{"sign":"Horse","year":1990,"traits":["energetic","independent","warm"],"element":"Metal","yin_yang":"Yang"},"western":{"sign":"Cancer","symbol":"♋","traits":["nurturing","loyal","emotional","protective"],"element":"Water","quality":"Cardinal","polarity":"Negative","date_range":"21 Jun – 22 Jul","ruling_planet":"Moon","compatible_with":["Capricorn","Pisces","Taurus","Virgo","Scorpio"]}},"meta":{"timestamp":"2026-06-01T00:04:25.343Z","request_id":"811fa765-e43b-45ee-a3ea-5d3c05b13594"},"status":"ok","message":"Both signs retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/chinese":{"get":{"operationId":"get_v1_chinese","tags":["Zodiac"],"summary":"Chinese zodiac from a year or date","description":"","parameters":[{"name":"year","in":"query","required":false,"description":"Birth year, e.g. 1990","schema":{"type":"string"},"example":"1990"},{"name":"date","in":"query","required":false,"description":"Or a full date YYYY-MM-DD","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Uses the Gregorian year; births in January/early February may fall under the previous year's animal due to the lunar new year.","sign":"Horse","year":1990,"traits":["energetic","independent","warm"],"element":"Metal","yin_yang":"Yang"},"meta":{"timestamp":"2026-06-01T00:04:25.421Z","request_id":"8ddaec96-5cc7-4273-bf24-a8ebd9191a00"},"status":"ok","message":"Chinese sign retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/sign":{"get":{"operationId":"get_v1_sign","tags":["Zodiac"],"summary":"Western sign details by name","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Sign name, e.g. leo","schema":{"type":"string"},"example":"leo"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sign":"Leo","symbol":"♌","traits":["confident","generous","charismatic","dramatic"],"element":"Fire","quality":"Fixed","polarity":"Positive","date_range":"23 Jul – 22 Aug","ruling_planet":"Sun","compatible_with":["Aquarius","Aries","Gemini","Libra","Sagittarius"]},"meta":{"timestamp":"2026-06-01T00:04:25.492Z","request_id":"0beca6d8-0489-4059-9ff5-668a9978b234"},"status":"ok","message":"Sign details retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/western":{"get":{"operationId":"get_v1_western","tags":["Zodiac"],"summary":"Western sun sign from a date","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"Birth date YYYY-MM-DD, e.g. 1990-07-15","schema":{"type":"string"},"example":"1990-07-15"},{"name":"month","in":"query","required":false,"description":"Month 1-12 (with day=, if no date)","schema":{"type":"string"}},{"name":"day","in":"query","required":false,"description":"Day of month (with month=)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sign":"Cancer","input":{"day":15,"month":7},"symbol":"♋","traits":["nurturing","loyal","emotional","protective"],"element":"Water","quality":"Cardinal","polarity":"Negative","date_range":"21 Jun – 22 Jul","ruling_planet":"Moon","compatible_with":["Capricorn","Pisces","Taurus","Virgo","Scorpio"]},"meta":{"timestamp":"2026-06-01T00:04:25.561Z","request_id":"f93bdfb8-9384-4a82-bcc1-869b867d32a7"},"status":"ok","message":"Western sign retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Signs & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Zodiac signs. /v1/western = the Western (tropical) sun sign from a date (date=YYYY-MM-DD or month= & day=) with element, quality, ruling planet and compatible signs; /v1/sign = details for a sign by name (e.g. name=leo); /v1/chinese = the Chinese zodiac animal, element and yin/yang from a year or date; /v1/both = Western + Chinese for a full birth date. Runs fully locally.","source":"local zodiac engine","endpoints":["/v1/western","/v1/sign","/v1/chinese","/v1/both","/v1/meta"],"chinese_signs":["Rat","Ox","Tiger","Rabbit","Dragon","Snake","Horse","Goat","Monkey","Rooster","Dog","Pig"],"western_signs":["Capricorn","Aquarius","Pisces","Aries","Taurus","Gemini","Cancer","Leo","Virgo","Libra","Scorpio","Sagittarius"]},"meta":{"timestamp":"2026-06-01T00:04:25.631Z","request_id":"8f659833-fb4e-4485-8a66-b989ba3565a6"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":14000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":260,"monthly_call_quota":210000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":890,"monthly_call_quota":860000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2830,"monthly_call_quota":3550000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/zodiac-api"}