Lunar Calendar Information API

1. Basic Call

TIP

The server will not record any of your requests or steal any of your privacy!

Base API URL

https://zeapi.ink/v1/api/lunar

Send a GET request directly to the following URL to retrieve lunar calendar information:

https://zeapi.ink/v1/api/lunar

Shell request code:

curl -X GET https://zeapi.ink/v1/api/lunar

2. Request Parameters

This API does not require additional request parameters; simply call it using a GET request.

3. JSON Response Format

Example of a successful response:

{
    "md": "Eighth Month, First Day",
    "ymd": "Eighth Month, First Day, 2025",
    "nayin": "Great Sea Water",
    "chongsha": "Clash Horse (Bing Wu), Sha South",
    "pengzu": "Bing avoids repairing stoves, Wu avoids covering roofs",
    "xishen": "Northwest",
    "fushen": "Due East",
    "caishen": "Due South",
    "yi": "Worship, Pray for Blessings, Consecration, Seek Heirs, Travel",
    "ji": "Marriage, Groundbreaking, Burial",
    "jshen": "Si",
    "xshen": "Wu"
}

Example of an error response (data retrieval failed):

{
    "md": "",
    "ymd": "",
    "nayin": "",
    "chongsha": "",
    "pengzu": "",
    "xishen": "",
    "fushen": "",
    "caishen": "",
    "yi": "",
    "ji": "",
    "jshen": "",
    "xshen": ""
}

4. Response Field Descriptions

Field	Type	Description
md	string	Lunar date (month and day, e.g., "Eighth Month, First Day")
ymd	string	Full lunar date (year, month, day, e.g., "Eighth Month, First Day, 2025")
nayin	string	Nayin (Five Elements, e.g., "Great Sea Water")
chongsha	string	Clash and Sha information (e.g., "Clash Horse (Bing Wu), Sha South")
pengzu	string	Pengzu's Hundred Taboos (e.g., "Bing avoids repairing stoves, Wu avoids covering roofs")
xishen	string	Direction of the Joy God (e.g., "Northwest")
fushen	string	Direction of the Fortune God (e.g., "Due East")
caishen	string	Direction of the Wealth God (e.g., "Due South")
yi	string	Favorable activities (e.g., "Worship, Pray for Blessings")
ji	string	Unfavorable activities (e.g., "Marriage, Groundbreaking")
jshen	string	Auspicious God (e.g., "Si")
xshen	string	Inauspicious God (e.g., "Wu")