Chinese Almanac API

Access authentic 通胜/黄历 data via REST API. Auspicious dates, zodiac signs, lunar calendar, and traditional Chinese fortune-telling — all in JSON.

Get Started Free View Pricing

What You Get

📅

Daily Almanac

Complete daily readings including auspicious activities (宜), inauspicious activities (忌), clash signs, and lucky directions.

🐲

Chinese Zodiac

Full zodiac data for any date — animal sign, element, personality traits, and compatibility information.

🌙

Lunar Calendar

Accurate lunar date conversion with festivals, solar terms (节气), and traditional timekeeping.

💍

Auspicious Date Finder

Search for the best dates for weddings, business openings, moving house, and more.

🔮

Ba Zi (八字)

Four Pillars of Destiny data — year, month, day, and hour pillars for fortune analysis.

⚡

Fast & Reliable

Sub-100ms response times, 99.9% uptime, and comprehensive documentation.

Simple Integration

// Get today's almanac
const response = await fetch('https://fengshui-api-5rgh.onrender.com/v1/almanac');
const almanac = await response.json();

console.log(almanac);
// {
//   "date": "2026-02-07",
//   "lunar": "正月初十",
//   "zodiac": "马",
//   "auspicious": ["嫁娶", "开业", "入宅"],
//   "inauspicious": ["安葬", "破土"],
//   "clash": "冲鼠煞北",
//   "luckyDirection": "东南",
//   ...
// }
      

API Endpoints

GET /v1/almanac

Get today's complete almanac data including all traditional elements.

GET /v1/almanac/{date}

Get almanac for a specific date (YYYY-MM-DD format).

GET /v1/find?activity=嫁娶&days=30

Find auspicious dates for a specific activity within a date range.

GET /v1/zodiac/{year}

Get zodiac animal and element for a specific year.

GET /v1/lunar/{date}

Convert solar date to lunar calendar with festival information.

Simple Pricing

Start free, scale as you grow

Free

$0/month

100 requests/day
Basic almanac data
Community support
Perfect for prototypes

Get API Key

Pro

$9/month

10,000 requests/day
Full data access
Priority support
Ba Zi calculations
Batch endpoints

Start Free Trial

Enterprise

Custom

Unlimited requests
Custom integrations
Dedicated support
SLA guarantee
On-premise option