Copy page
Copy page as Markdown for LLMs
Introducing the Chinese Horoscope Prediction API, your gateway to delivering personalized insights from the Chinese zodiac. With this API, you can access daily horoscope predictions for all twelve Chinese zodiac animal signs. Integrate it into your astrology applications, websites, or content systems to provide users with meaningful, culturally enriched astrological guidance.
https://support.divineapi.com/horoscope-apis/testing-the-chinese-horoscope-api-using-post
POST https://astroapi-5.divineapi.com/api/v3/chinese-horoscopeGuide: If you only need English, use this endpoint.
POST https://astroapi-5-translator.divineapi.com/api/v3/chinese-horoscopeGuide: If you want the prediction in any other language use this translator endpoint.
Use the lan parameter in the body to fetch responses in a specific language.
Supported Reference Article:
https://support.divineapi.com/general-api-support/translating-apis-into-a-different-language
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| pt | Portuguese |
| fr | French |
| es | Spanish |
| ru | Russian |
| de | German |
| nl | Dutch |
| it | Italian |
| pl | Polish |
| ar | Arabic |
| ja | Japanese |
| zh | Chinese |
| tm | Tamil |
| tl | Telugu |
| tr | Turkish |
| ta | Filipino/Tagalog |
| bn | Bengali |
| ma | Marathi |
| ml | Malayalam |
| kn | Kannada |
Guide:
To use translations, ensure your translator is updated at DivineAPI Translator.
| Name | Type | Description |
|---|---|---|
| Authorization* | String | Your API Access Token. Example: Bearer {token} |
| Name | Type | Description |
|---|---|---|
| api_key* | String | Your DivineAPI key available on your dashboard. |
| sign* | String | The Chinese zodiac animal sign (e.g., Tiger, Dragon, Rat). |
| h_day* | String | Choose from yesterday, today, or tomorrow. |
| tzone* | Float | Timezone offset, e.g., 5.5. See the Timezone Guide. |
| lan | String | Language code as per the table above. Default: en. |
{
"success": 1,
"data": {
"sign": "Tiger",
"date": "20 Mar 2026",
"prediction": {
"growth": "Today, as the Tiger navigates the energies of Yi and Wood, introspection becomes your ally. Embrace this Yin day to delve into self-discovery and learning. Read up on topics that fascinate you or pick up a meditation practice. This alignment encourages growth through quiet reflection, enhancing your innate boldness with wisdom. Let your philosophical nature guide you in discovering paths that align with your deepest aspirations.",
"health": "With the influence of Wood and Yi, balance is crucial for your health today, Tiger. Lean towards dietary choices rich in green leafy vegetables and fruits to nurture your inner vitality. Consider incorporating gentle yoga or tai chi into your day to harmonize body and mind. Listening to your body’s subtle signals under this Yin influence will keep you vibrant and resilient.",
"wealth": "Under the Wood and Yi combination, today's financial energies suggest taking a cautionary approach. This is a day to review your long-term investments and savings plans rather than initiating new ventures. Allow the steady, nurturing nature of Wood to guide your steps. Contemplate strategies focusing on sustainable growth; your insights today will sow the seeds for future prosperity.",
"career": "Today, the power of Wood and the gentle touch of Yi make it a prime time to nurture your career goals quietly. Embrace teamwork and collaboration, reflecting on how your leadership can inspire others. Maintain balance in your interactions, and allow your calm yet determined Tiger nature to shine. It's a day for careful planning, laying a groundwork that will support future achievements.",
"love": "Under the Wood element's influence, let your heart connect with warmth today. Whether with a partner or seeking new connections, let your nurturing side guide your interactions. Sharing your dreams and listening with empathy will deepen your bonds. The gentle Yin energy balances your fiery Tiger spirit, fostering closeness and mutual understanding in love and family ties.",
"family": "Today, the energies promoting harmony within family life are strong. Foster connections by engaging in shared activities like cooking or storytelling. Yi and Wood urge you to refocus on creating supportive environments at home. This is an opportune time to address any existing tensions with compassion, turning your household into a haven of peace and understanding.",
"fortune": [
"Lucky Numbers of the day : 3,7,9",
"Lucky Alphabets you will be in sync with : Y,W",
"Cosmic Tip : Trust in the gentle power of nurturing connections today.",
"Tips for Singles : Let your soul's warmth guide new connections, radiate genuine kindness.",
"Tips for Couples : Embrace gentle interactions; listen deeply to strengthen mutual understanding."
]
}
}
}Below are example implementations in various programming environments.
curl --location 'https://astroapi-5.divineapi.com/api/v3/chinese-horoscope' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'sign="TIGER"' \
--form 'h_day="today"' \
--form 'tzone="5.5"' \
--form 'lan="en"'var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-5.divineapi.com/api/v3/chinese-horoscope',
'headers': {
'Authorization': 'Bearer {Your Auth Token}'
},
formData: {
'api_key': '{Your API Key}',
'sign': 'TIGER',
'h_day': 'today',
'tzone': '5.5',
'lan': 'en'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("sign", "TIGER");
form.append("h_day", "today");
form.append("tzone", "5.5");
form.append("lan", "en");
var settings = {
"url": "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope",
"method": "POST",
"timeout": 0,
"headers": {
"Authorization": "Bearer {Your Auth Token}"
},
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});import requests
url = "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope"
payload = {'api_key': '{Your API Key}',
'sign': 'TIGER',
'h_day': 'today',
'tzone': '5.5',
'lan': 'en'}
headers = {
'Authorization': 'Bearer {Your Auth Token}'
}
response = requests.request("POST", url, headers=headers, data=payload,)
print(response.text)