Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text


Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

Monthly Chinese Horoscope

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

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-monthly

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

CodeLanguage
enEnglish
hiHindi
zhChinese
jaJapanese
arArabic
ruRussian
ptPortuguese
esSpanish
frFrench
deGerman
itItalian
nlDutch
plPolish
trTurkish
ukUkrainian
huHungarian
grGreek
bnBengali
maMarathi
tmTamil
tlTelugu
mlMalayalam
knKannada
taFilipino/Tagalog
bahIndonesian
guGujarati
koKorean

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


Headers

NameTypeDescription
Authorization*StringYour API Access Token. Example: Bearer {token}

Request Body

NameTypeDescription
api_key*StringYour DivineAPI key available on your dashboard.
sign*StringThe Chinese zodiac animal sign (e.g., Tiger, Dragon, Rat).
month*StringSelect between current, prev, or next.
tzone*FloatTimezone offset, e.g., 5.5. See the Timezone Guide.
lanStringLanguage code as per the table above. Default: en.

200: OK Successful

{
    "success": 1,
    "data": {
        "sign": "Rat",
        "month": "November 2026",
        "prediction": {
            "growth": "Picture water creeping up the stone walls of a lock while a boat waits. Your sign clashes with this Horse year, a head-on pull, and the month's Earth presses on your Water, bringing more demands than ease. Patience lifts the boat. Two days sit kindly with your sign, so mark 11 and 23 November for the conversations you've been putting off.",
            "health": "From 7 November, the month's Water side starts to match your own, so energy that felt pinned down in the first week can lift a little. The pressure doesn't vanish, so pace still matters. Fix two stretching sessions a week on the same days and keep them all month, ideally in the morning if you stand at work, as a fishmonger does.",
            "wealth": "December tends to arrive with costs you already know about: gifts, travel, heating, a birthday or two. This year has changed your plans more than once, so a buffer is kinder than a promise to yourself. Before 15 November, set aside a separate pot of money for December's known costs, even a small one, and leave it untouched.",
            "career": "Three days this month bring a head-on pull against your sign, and two of them, 16 and 28 November, are worth keeping for tidying and follow-up rather than launching anything new. Sui Po, a star saying plans may need changing, sits in your year, so build slack into deadlines. A postgraduate researcher might spend those days on references and notes.",
            "love": "After a year that has pushed hard against your sign, closeness may come less from big gestures and more from time that isn't rushed. You might notice how rarely you've had that lately. On 23 November, a day that sits kindly with you, an unhurried outing with your partner or someone special could give some of it back.",
            "family": "Colder weeks are close, and older relatives may be slower to prepare for them than they admit. Zai Sha in your year, a star of mishaps, asks you to steer clear of quarrels, so offer help rather than advice. Spend an afternoon helping a relative sort out winter clothes or bedding, carrying the heavy boxes and letting them decide what stays.",
            "fortune": [
                "Lucky Numbers of the month : 6, 19, 11",
                "Lucky Alphabets you will be in sync with : N, P",
                "Cosmic Tip : With Earth weighing on your Water all month, slow and steady progress will serve you better than one big push.",
                "Tips for Singles : Once the month's Water starts matching your own, a friendship that grows slowly may turn into something more.",
                "Tips for Couples : In a year that pulls against your sign, one unhurried evening together each week can steady you both more than any grand plan."
            ]
        }
    }
}

Example Code Implementations

Below are example implementations in various programming environments.


cURL

curl --location 'https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-monthly' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'tzone="5.5"' \
--form 'sign="rat"' \
--form 'month="current"'
curl -X POST "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-monthly" \
  -H "Authorization: Bearer {Your Auth Token}" \
  --form 'api_key="{Your API Key}"' \
  --form 'tzone="5.5"' \
  --form 'sign="rat"' \
  --form 'month="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('month', 'current');
form.append('lan', 'en');

const response = await axios.post('https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-monthly', 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-monthly"
headers = {
    "Authorization": "Bearer {Your Auth Token}",
}
payload = {
    "api_key": "{Your API Key}",
    "tzone": "5.5",
    "sign": "rat",
    "month": "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('month', 'current');
formData.append('lan', 'en');

const response = await fetch('https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-monthly', {
  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-monthly', [
    'headers' => [
        'Authorization' => 'Bearer {Your Auth Token}',
    ],
    'multipart' => [
        ['name' => 'api_key', 'contents' => '{Your API Key}'],
        ['name' => 'tzone', 'contents' => '5.5'],
        ['name' => 'sign', 'contents' => 'rat'],
        ['name' => 'month', '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("month", "current")
    writer.WriteField("lan", "en")
    writer.Close()

    req, _ := http.NewRequest("POST", "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-monthly", 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("month", "current")
            .addFormDataPart("lan", "en")
            .build();

        Request request = new Request.Builder()
            .url("https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-monthly")
            .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-monthly")!
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=\"month\"\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("month", "current")
        .addFormDataPart("lan", "en")
        .build()

    val request = Request.Builder()
        .url("https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-monthly")
        .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"), "month");
        content.Add(new StringContent("en"), "lan");

        var response = await client.PostAsync("https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-monthly", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}
Response 200
{
    "success": 1,
    "data": {
        "sign": "Rat",
        "month": "November 2026",
        "prediction": {
            "growth": "Picture water creeping up the stone walls of a lock while a boat waits. Your sign clashes with this Horse year, a head-on pull, and the month's Earth presses on your Water, bringing more demands than ease. Patience lifts the boat. Two days sit kindly with your sign, so mark 11 and 23 November for the conversations you've been putting off.",
            "health": "From 7 November, the month's Water side starts to match your own, so energy that felt pinned down in the first week can lift a little. The pressure doesn't vanish, so pace still matters. Fix two stretching sessions a week on the same days and keep them all month, ideally in the morning if you stand at work, as a fishmonger does.",
            "wealth": "December tends to arrive with costs you already know about: gifts, travel, heating, a birthday or two. This year has changed your plans more than once, so a buffer is kinder than a promise to yourself. Before 15 November, set aside a separate pot of money for December's known costs, even a small one, and leave it untouched.",
            "career": "Three days this month bring a head-on pull against your sign, and two of them, 16 and 28 November, are worth keeping for tidying and follow-up rather than launching anything new. Sui Po, a star saying plans may need changing, sits in your year, so build slack into deadlines. A postgraduate researcher might spend those days on references and notes.",
            "love": "After a year that has pushed hard against your sign, closeness may come less from big gestures and more from time that isn't rushed. You might notice how rarely you've had that lately. On 23 November, a day that sits kindly with you, an unhurried outing with your partner or someone special could give some of it back.",
            "family": "Colder weeks are close, and older relatives may be slower to prepare for them than they admit. Zai Sha in your year, a star of mishaps, asks you to steer clear of quarrels, so offer help rather than advice. Spend an afternoon helping a relative sort out winter clothes or bedding, carrying the heavy boxes and letting them decide what stays.",
            "fortune": [
                "Lucky Numbers of the month : 6, 19, 11",
                "Lucky Alphabets you will be in sync with : N, P",
                "Cosmic Tip : With Earth weighing on your Water all month, slow and steady progress will serve you better than one big push.",
                "Tips for Singles : Once the month's Water starts matching your own, a friendship that grows slowly may turn into something more.",
                "Tips for Couples : In a year that pulls against your sign, one unhurried evening together each week can steady you both more than any grand plan."
            ]
        }
    }
}