api.cn402.com · lunar

Chinese lunar calendar conversion, solar to lunar date, Gregorian to Chinese lunar, 公历转农历, 农历日期转换, lunar date, Chinese date, sexagenary cycle date, 干支日期. Convert any Gregorian date to Chinese lunar date with full traditional context: lunar year-month-day, year/month/day gan-zhi pillars, zodiac animal year, leap month flag.

Call it in 30 seconds

// npm i x402-fetch viem
import { wrapFetchWithPayment } from "x402-fetch";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount(process.env.PRIVATE_KEY); // funds USDC on Base
const wallet = createWalletClient({ account, chain: base, transport: http() });
const fetchWithPay = wrapFetchWithPayment(fetch, wallet);

// Pays the $0.016 USDC automatically on the 402, then returns the real response:
const res = await fetchWithPay("https://api.cn402.com/lunar", { method: "GET" });
console.log(await res.json());

# pip install x402 eth-account httpx
import os, asyncio
from eth_account import Account
from x402.clients.httpx import x402HttpxClient

account = Account.from_key(os.environ["PRIVATE_KEY"])  # funds USDC on Base

async def main():
    async with x402HttpxClient(account=account) as client:
        # x402 handles the 402 -> pay ($0.016 USDC) -> retry automatically
        r = await client.get("https://api.cn402.com/lunar")
        print((await r.aread()).decode())

asyncio.run(main())

# 1) An unpaid request returns HTTP 402 with the exact payment terms:
curl -i "https://api.cn402.com/lunar?date=Date YYYY-MM-DD (required)"

# 2) Paying + retrying requires an x402 client that can sign the USDC
#    authorization (curl alone cannot). See the JS / Python tabs below.

New to x402? Read the 5-minute quickstart →