Chinese Zodiac returns the zodiac animal, element, and characteristics for any birth date. Accurately accounts for the Chinese lunar calendar - the zodiac year starts on Chinese New Year, not January 1st.

The Chinese Zodiac API provides a simple, reliable way to integrate chinese zodiac functionality into your applications. Built for developers who need production-ready chinese zodiac capabilities without the complexity of building from scratch.

View API Details →

Available on:

async function callChineseZodiacAPI() {
    try {
        const params = new URLSearchParams({
            date: '1990-01-15'
        });

        const response = await fetch(`https://api.apiverve.com/v1/chinesezodiac?${params}`, {
            method: 'GET',
            headers: {
                'x-api-key': 'YOUR_API_KEY_HERE'
            }
        });

        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callChineseZodiacAPI();

curl -X GET "https://api.apiverve.com/v1/chinesezodiac?date=1990-01-15" \
  -H "x-api-key: YOUR_API_KEY_HERE"

Get your API key: https://apiverve.com

📁 For more examples, see the examples folder

Choose your preferred programming language:

npm install @apiverve/chinesezodiac

View NPM Package → | Package Code →

dotnet add package APIVerve.API.ChineseZodiac

View NuGet Package → | Package Code →

pip install apiverve-chinesezodiac

View PyPI Package → | Package Code →

gem install apiverve_chinesezodiac

View RubyGems Package → | Package Code →

composer require apiverve/chinesezodiac

View Packagist Package → | Package Code →

dart pub add apiverve_chinesezodiac

View pub.dev Package → | Package Code →

implementation 'com.github.apiverve:chinesezodiac-api:1.0.0'

Package Code →

go get github.com/apiverve/chinesezodiac-api/go

Package Code →

• 🏠 API Home: Chinese Zodiac API
• 📚 API Reference: docs.apiverve.com/ref/chinesezodiac
• 📖 OpenAPI Spec: openapi.yaml
• 💡 Examples: examples/

The Chinese Zodiac API is commonly used for:

• Web Applications - Add chinese zodiac features to your frontend or backend
• Mobile Apps - Native SDKs for Android development
• Automation - Integrate with n8n, Zapier, or custom workflows
• SaaS Products - Enhance your product with chinese zodiac capabilities
• Data Pipelines - Process and analyze data at scale

All requests require an API key in the header:

x-api-key: YOUR_API_KEY_HERE

Get your API key: https://apiverve.com

Every APIVerve endpoint returns the same envelope — check status, then read data:

{
  "status": "ok",
  "error": null,
  "data": { ... }
}

A real response from the Chinese Zodiac API:

{
  "status": "ok",
  "error": null,
  "data": {
    "date": "1990-01-15",
    "zodiacYear": 1989,
    "animal": "Snake",
    "animalChinese": "蛇",
    "element": "Earth",
    "elementChinese": "土",
    "elementColor": "Yellow/Brown",
    "polarity": "Yin",
    "traits": [
      "Enigmatic",
      "Intelligent",
      "Wise",
      "Decisive"
    ],
    "sexagenaryCyclePosition": 6,
    "fullName": "Earth Snake",
    "chineseNewYear": "1990-01-27"
  }
}

• 🏠 API Home: Chinese Zodiac API
• 💬 Support: https://apiverve.com/contact
• 🐛 Issues: GitHub Issues
• 📖 Documentation: https://docs.apiverve.com
• 🌐 Website: https://apiverve.com

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

For security concerns, please review our Security Policy.

This project is licensed under the MIT License - see the LICENSE file for details.

Built with ❤️ by APIVerve

Copyright © 2026 APIVerve. All rights reserved.