Yearly Chinese Horoscope

Introducing the yearly Chinese Horoscope Prediction API, your gateway to delivering personalized insights from the Chinese zodiac. With this API, you can access yearly 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.

Step by Step Chinese Horoscope API Postman Testing Integration

https://support.divineapi.com/horoscope-apis/testing-the-chinese-horoscope-api-using-post

API Endpoint for English

POST https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly

Guide: If you only need English, use this endpoint.

API Endpoint for other languages

POST https://astroapi-5-translator.divineapi.com/api/v3/chinese-horoscope-yearly

Guide: If you want the prediction in any other language use this translator endpoint.

Supported Language Codes

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
zh	Chinese
ja	Japanese
ar	Arabic
ru	Russian
pt	Portuguese
es	Spanish
fr	French
de	German
it	Italian
nl	Dutch
pl	Polish
tr	Turkish
uk	Ukrainian
hu	Hungarian
gr	Greek
bn	Bengali
ma	Marathi
tm	Tamil
tl	Telugu
ml	Malayalam
kn	Kannada
ta	Filipino/Tagalog
bah	Indonesian
gu	Gujarati
ko	Korean

Guide:
To use translations, ensure your translator is updated at DivineAPI Translator.

Headers

Name	Type	Description
Authorization*	String	Your API Access Token. Example: `Bearer {token}`

Request Body

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).
year*	String	One of `current`, `prev`, `next`.
tzone*	Float	Timezone offset, e.g., `5.5`. See the Timezone Guide.
lan	String	Language code as per the table above. Default: `en`.

200: OK Successful

{
    "success": 1,
    "data": {
        "sign": "Rat",
        "year": "2026",
        "prediction": {
            "growth": "What if the year's resistance is the route? Your Horse year starts with Lichun on 4 February, the first solar day of spring; the lunar new year comes later, on 17 February. Say it plainly: the Horse that presides over 2026 is your clash, a head-on pull, and you sit opposite Tai Sui, so this is the hardest kind of year a sign gets. Sui Po, the star that comes with it, means plans may need changing, more than once. It is a Fire-over-Fire year, and your Water can master Fire with effort, which is the hopeful part: you are not carried off by it, but you cannot push straight through it either. Think of a ferry crossing a strong current at an angle; it reaches the far bank by steering. A one-line log at the start of each solar month, noting what changed, becomes that steering over time. The month from 5 March carries a punishment, strain from duties, and from 7 September a settled agreement may come undone. Neither is the end of anything; both are places to steer.",
            "health": "Through the hot June and July months, keep afternoons lighter and less crowded. Once the Horse month arrives on 5 June, the year's clash comes twice over, the one stretch where the pull against your sign is strongest, and from 7 July a harm follows, small frustrations from others that land harder on a tired body. Zai Sha is with you this year too, a star of mishaps that asks for extra care on the road and a wide berth around quarrels; a bus driver on a long afternoon shift will understand why this reading says ask for the morning routes if you can. Nobody can predict an ache, and this does not. It says that keeping the year's Fire in hand takes steady work from your Water, and steady work tires you, so eat earlier, drink more than feels necessary and leave the hardest conversation for a cooler hour. If you are studying, put the heavy reading before lunch. Do not fill the summer diary; the year will fill some of it for you. Keep one afternoon a week with nothing in it, and defend it.",
            "wealth": "A small cushion, built a piece at a time and topped up in April and August, may serve you well this year. In a clash year with Sui Po, plans change, and the plan most likely to change is the one about money: the job that was certain, the rent that was fixed, the course fee that goes up. A cushion built in small steady pieces is how a Rat steers through that, and the two months to add to it are the ones that help you most: from 5 April the Dragon month, a natural ally, joins you in three harmony, and from 7 August the Monkey month is another. Those months tend to bring a little more in, a refund, extra hours, a grant decision, so the extra saving costs least then. Zai Sha asks you to keep clear of quarrels, and money quarrels are the commonest kind, so put shared costs in writing before anyone is annoyed. None of this is about loans, investments or purchases; it favours steady habits over big moves. This week, picture what a modest, regular cushion would look like for you.",
            "career": "Time big pitches and applications for April, August or January. In a year when plans keep shifting under you, the trick is not to fight every shift but to choose the moments when the ground is steadiest, and for you those open from 5 April and again from 5 January 2027. Send the grant application, ask for the raise, submit the thesis chapter, pitch the new route or the new client in those windows, and spend the months between them preparing the material so it is ready to go. A postgraduate student can draft all summer and submit when the window opens; a driver can get the licence category sorted now and apply for the better shift pattern later. Expect at least one plan to be rewritten this year through no fault of yours. When it happens, rewrite it the same day rather than mourning it. Keep a folder of everything you have finished, because a year that moves the goalposts also makes it easy to forget how far you have come.",
            "love": "When June's clash month brings friction, agree on one calm weekly check-in. From 5 June the Horse month sits on top of the Horse year, which means the head-on pull against your sign is doubled for a month, and couples who are fine the rest of the time can find themselves arguing about nothing at all. A fixed half hour each week, tea, no phones, each of you saying one thing that went well and one that did not, takes the pressure out of the other six days. If you are single, Sui Po's changing plans can be a gift: the move, the new course, the shift in routine puts you among people you would not otherwise meet, so follow the change rather than resisting it. Whatever you do, do not start the year's biggest conversation during a drive; Zai Sha asks for care on the road, and that includes not discussing the future at sixty miles an hour. Wait until you are both sitting down with nowhere to be. Pick the weekday for the check-in tonight.",
            "family": "Plan a shared home project for the supportive August month. From 7 August the Monkey month is a natural ally to your sign, one of the easiest stretches in a hard year, and a job the household does together then, painting a room, clearing the garage, building the raised beds, gives everyone something to point at when the rest of 2026 feels like it keeps changing. Family is the one place where Sui Po's shifting plans are easiest to absorb, because the people there already know you. Let them help. The Rat instinct in a clash year is to pull back and handle everything alone, and that is exactly what makes a family feel shut out. Tell them, in plain words, when the year is being hard, and let someone else cook for a week. If you have children, give them a part of the August project that is genuinely theirs. If you care for a parent, make it something they can watch from a chair. Choose the project and the weekend now, and write it on the kitchen calendar.",
            "fortune": [
                "Lucky Numbers of the year : 6, 9, 21",
                "Lucky Alphabets you will be in sync with : K, N",
                "Cosmic Tip : In a year that clashes with your sign, steer rather than push; change the plan early and you keep the direction.",
                "Tips for Singles : Sui Po moves your plans, and the new timetable, class or address is where someone new is most likely to be standing.",
                "Tips for Couples : Keep the doubled clash month of June for small kindnesses and give the big decisions to the natural ally months."
            ]
        }
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'tzone="5.5"' \
--form 'sign="rat"' \
--form 'year="current"'

curl -X POST "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly" \ -H "Authorization: Bearer {Your Auth Token}" \ --form 'api_key="{Your API Key}"' \ --form 'tzone="5.5"' \ --form 'sign="rat"' \ --form 'year="current"' \ --form 'lan="en"'

const FormData = require('form-data'); const axios = require('axios'); const form = new FormData(); form.append('api_key', '{Your API Key}'); form.append('tzone', '5.5'); form.append('sign', 'rat'); form.append('year', 'current'); form.append('lan', 'en'); const response = await axios.post('https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly', form, { headers: { ...form.getHeaders(), 'Authorization': 'Bearer {Your Auth Token}', } }); console.log(response.data);

import requests url = "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly" headers = { "Authorization": "Bearer {Your Auth Token}", } payload = { "api_key": "{Your API Key}", "tzone": "5.5", "sign": "rat", "year": "current", "lan": "en", } response = requests.post(url, headers=headers, data=payload) print(response.json())

const formData = new FormData(); formData.append('api_key', '{Your API Key}'); formData.append('tzone', '5.5'); formData.append('sign', 'rat'); formData.append('year', 'current'); formData.append('lan', 'en'); const response = await fetch('https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly', { method: 'POST', headers: { 'Authorization': "Bearer {Your Auth Token}", }, body: formData, }); const data = await response.json(); console.log(data);

<?php use GuzzleHttp\Client; $client = new Client(); $response = $client->request('POST', 'https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly', [ 'headers' => [ 'Authorization' => 'Bearer {Your Auth Token}', ], 'multipart' => [ ['name' => 'api_key', 'contents' => '{Your API Key}'], ['name' => 'tzone', 'contents' => '5.5'], ['name' => 'sign', 'contents' => 'rat'], ['name' => 'year', 'contents' => 'current'], ['name' => 'lan', 'contents' => 'en'], ], ]); echo $response->getBody();

package main import ( "bytes" "fmt" "mime/multipart" "net/http" "io" ) func main() { body := &bytes.Buffer{} writer := multipart.NewWriter(body) writer.WriteField("api_key", "{Your API Key}") writer.WriteField("tzone", "5.5") writer.WriteField("sign", "rat") writer.WriteField("year", "current") writer.WriteField("lan", "en") writer.Close() req, _ := http.NewRequest("POST", "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly", body) req.Header.Set("Content-Type", writer.FormDataContentType()) req.Header.Set("Authorization", "Bearer {Your Auth Token}") client := &http.Client{} resp, _ := client.Do(req) defer resp.Body.Close() body2, _ := io.ReadAll(resp.Body) fmt.Println(string(body2)) }

import okhttp3.*; import java.io.IOException; public class Main { public static void main(String[] args) throws IOException { OkHttpClient client = new OkHttpClient(); RequestBody body = new MultipartBody.Builder() .setType(MultipartBody.FORM) .addFormDataPart("api_key", "{Your API Key}") .addFormDataPart("tzone", "5.5") .addFormDataPart("sign", "rat") .addFormDataPart("year", "current") .addFormDataPart("lan", "en") .build(); Request request = new Request.Builder() .url("https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly") .post(body) .addHeader("Authorization", "Bearer {Your Auth Token}") .build(); Response response = client.newCall(request).execute(); System.out.println(response.body().string()); } }

import Foundation let url = URL(string: "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly")! var request = URLRequest(url: url) request.httpMethod = "POST" request.setValue("Bearer {Your Auth Token}", forHTTPHeaderField: "Authorization") let boundary = "Boundary-\(UUID().uuidString)" request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type") var bodyData = Data() bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"api_key\"\r\n\r\n".data(using: .utf8)!) bodyData.append("{Your API Key}\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"tzone\"\r\n\r\n".data(using: .utf8)!) bodyData.append("5.5\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"sign\"\r\n\r\n".data(using: .utf8)!) bodyData.append("rat\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"year\"\r\n\r\n".data(using: .utf8)!) bodyData.append("current\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"lan\"\r\n\r\n".data(using: .utf8)!) bodyData.append("en\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)--\r\n".data(using: .utf8)!) request.httpBody = bodyData let task = URLSession.shared.dataTask(with: request) { data, response, error in if let data = data { print(String(data: data, encoding: .utf8) ?? "") } } task.resume()

import okhttp3.* fun main() { val client = OkHttpClient() val body = MultipartBody.Builder() .setType(MultipartBody.FORM) .addFormDataPart("api_key", "{Your API Key}") .addFormDataPart("tzone", "5.5") .addFormDataPart("sign", "rat") .addFormDataPart("year", "current") .addFormDataPart("lan", "en") .build() val request = Request.Builder() .url("https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly") .post(body!!) .addHeader("Authorization", "Bearer {Your Auth Token}") .build() client.newCall(request).execute().use { response -> println(response.body?.string()) } }

using System; using System.Net.Http; using System.Threading.Tasks; class Program { static async Task Main() { using var client = new HttpClient(); client.DefaultRequestHeaders.Add("Authorization", "Bearer {Your Auth Token}"); var content = new MultipartFormDataContent(); content.Add(new StringContent("{Your API Key}"), "api_key"); content.Add(new StringContent("5.5"), "tzone"); content.Add(new StringContent("rat"), "sign"); content.Add(new StringContent("current"), "year"); content.Add(new StringContent("en"), "lan"); var response = await client.PostAsync("https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-yearly", content); var result = await response.Content.ReadAsStringAsync(); Console.WriteLine(result); } }

{ "success": 1, "data": { "sign": "Rat", "year": "2026", "prediction": { "growth": "What if the year's resistance is the route? Your Horse year starts with Lichun on 4 February, the first solar day of spring; the lunar new year comes later, on 17 February. Say it plainly: the Horse that presides over 2026 is your clash, a head-on pull, and you sit opposite Tai Sui, so this is the hardest kind of year a sign gets. Sui Po, the star that comes with it, means plans may need changing, more than once. It is a Fire-over-Fire year, and your Water can master Fire with effort, which is the hopeful part: you are not carried off by it, but you cannot push straight through it either. Think of a ferry crossing a strong current at an angle; it reaches the far bank by steering. A one-line log at the start of each solar month, noting what changed, becomes that steering over time. The month from 5 March carries a punishment, strain from duties, and from 7 September a settled agreement may come undone. Neither is the end of anything; both are places to steer.", "health": "Through the hot June and July months, keep afternoons lighter and less crowded. Once the Horse month arrives on 5 June, the year's clash comes twice over, the one stretch where the pull against your sign is strongest, and from 7 July a harm follows, small frustrations from others that land harder on a tired body. Zai Sha is with you this year too, a star of mishaps that asks for extra care on the road and a wide berth around quarrels; a bus driver on a long afternoon shift will understand why this reading says ask for the morning routes if you can. Nobody can predict an ache, and this does not. It says that keeping the year's Fire in hand takes steady work from your Water, and steady work tires you, so eat earlier, drink more than feels necessary and leave the hardest conversation for a cooler hour. If you are studying, put the heavy reading before lunch. Do not fill the summer diary; the year will fill some of it for you. Keep one afternoon a week with nothing in it, and defend it.", "wealth": "A small cushion, built a piece at a time and topped up in April and August, may serve you well this year. In a clash year with Sui Po, plans change, and the plan most likely to change is the one about money: the job that was certain, the rent that was fixed, the course fee that goes up. A cushion built in small steady pieces is how a Rat steers through that, and the two months to add to it are the ones that help you most: from 5 April the Dragon month, a natural ally, joins you in three harmony, and from 7 August the Monkey month is another. Those months tend to bring a little more in, a refund, extra hours, a grant decision, so the extra saving costs least then. Zai Sha asks you to keep clear of quarrels, and money quarrels are the commonest kind, so put shared costs in writing before anyone is annoyed. None of this is about loans, investments or purchases; it favours steady habits over big moves. This week, picture what a modest, regular cushion would look like for you.", "career": "Time big pitches and applications for April, August or January. In a year when plans keep shifting under you, the trick is not to fight every shift but to choose the moments when the ground is steadiest, and for you those open from 5 April and again from 5 January 2027. Send the grant application, ask for the raise, submit the thesis chapter, pitch the new route or the new client in those windows, and spend the months between them preparing the material so it is ready to go. A postgraduate student can draft all summer and submit when the window opens; a driver can get the licence category sorted now and apply for the better shift pattern later. Expect at least one plan to be rewritten this year through no fault of yours. When it happens, rewrite it the same day rather than mourning it. Keep a folder of everything you have finished, because a year that moves the goalposts also makes it easy to forget how far you have come.", "love": "When June's clash month brings friction, agree on one calm weekly check-in. From 5 June the Horse month sits on top of the Horse year, which means the head-on pull against your sign is doubled for a month, and couples who are fine the rest of the time can find themselves arguing about nothing at all. A fixed half hour each week, tea, no phones, each of you saying one thing that went well and one that did not, takes the pressure out of the other six days. If you are single, Sui Po's changing plans can be a gift: the move, the new course, the shift in routine puts you among people you would not otherwise meet, so follow the change rather than resisting it. Whatever you do, do not start the year's biggest conversation during a drive; Zai Sha asks for care on the road, and that includes not discussing the future at sixty miles an hour. Wait until you are both sitting down with nowhere to be. Pick the weekday for the check-in tonight.", "family": "Plan a shared home project for the supportive August month. From 7 August the Monkey month is a natural ally to your sign, one of the easiest stretches in a hard year, and a job the household does together then, painting a room, clearing the garage, building the raised beds, gives everyone something to point at when the rest of 2026 feels like it keeps changing. Family is the one place where Sui Po's shifting plans are easiest to absorb, because the people there already know you. Let them help. The Rat instinct in a clash year is to pull back and handle everything alone, and that is exactly what makes a family feel shut out. Tell them, in plain words, when the year is being hard, and let someone else cook for a week. If you have children, give them a part of the August project that is genuinely theirs. If you care for a parent, make it something they can watch from a chair. Choose the project and the weekend now, and write it on the kitchen calendar.", "fortune": [ "Lucky Numbers of the year : 6, 9, 21", "Lucky Alphabets you will be in sync with : K, N", "Cosmic Tip : In a year that clashes with your sign, steer rather than push; change the plan early and you keep the direction.", "Tips for Singles : Sui Po moves your plans, and the new timetable, class or address is where someone new is most likely to be standing.", "Tips for Couples : Keep the doubled clash month of June for small kindnesses and give the big decisions to the natural ally months." ] } } }