# Chinese Calendar and Culture

Solar terms, lunar dates, BaZi pillars, I Ching hexagrams, hanzi pinyin and simplified/traditional conversion.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://chinese-culture.x402tookit.com/openapi.json
- x402 manifest: https://chinese-culture.x402tookit.com/.well-known/x402
- Catalog (free): https://chinese-culture.x402tookit.com/catalog
- Health (free): https://chinese-culture.x402tookit.com/health
- Uptime (free): https://chinese-culture.x402tookit.com/uptime

## Endpoints (7)

### GET /bazi — $0.03
Four Pillars (BaZi) chart for a date and optional time: stems, branches, animals, five-element counts, day master.
Params: date: string, time?: string, utcOffset?: number, dayStarts?: string
Example: https://chinese-culture.x402tookit.com/bazi?date=1990-05-17&time=14%3A30&utcOffset=8

### GET /hanzi-info — $0.02
Look up Chinese characters: pinyin readings, English meaning, stroke count, simplified and traditional forms.
Params: chars: string
Example: https://chinese-culture.x402tookit.com/hanzi-info?chars=%E8%A1%8C%E5%9B%BD

### GET /i-ching — $0.02
Look up an I Ching hexagram by number or lines, or cast one from a question and date with changing lines.
Params: number?: integer, lines?: string, cast?: string, date?: string
Example: https://chinese-culture.x402tookit.com/i-ching?cast=Should+I+start+the+project%3F&date=2026-10-21

### GET /lunar-date — $0.02
Convert a Gregorian date to the Chinese lunar date (with leap month) or back, plus zodiac animal and year name.
Params: date?: string, lunar?: string
Example: https://chinese-culture.x402tookit.com/lunar-date?date=2024-02-10

### GET /pinyin — $0.02
Convert Chinese text to pinyin with tone marks or tone numbers; flags characters with several readings.
Params: text: string, style?: string
Example: https://chinese-culture.x402tookit.com/pinyin?text=%E4%BD%A0%E5%A5%BD%EF%BC%8C%E4%B8%AD%E5%9B%BD&style=marks

### GET /simp-trad — $0.02
Convert Chinese text between simplified and traditional characters; reports ambiguous one-to-many characters.
Params: text: string, to: string
Example: https://chinese-culture.x402tookit.com/simp-trad?text=%E6%BC%A2%E8%AA%9E%E7%99%BC%E5%B1%95&to=simplified

### GET /solar-term — $0.02
Chinese solar term (jieqi) for a date with the next term's exact time, or all 24 terms of a year, in CST and UTC.
Params: date?: string, year?: integer
Example: https://chinese-culture.x402tookit.com/solar-term?date=2024-02-10

## Terms

Cultural and calendar reference computed locally from astronomical formulas and Unicode Unihan data. BaZi and I Ching output describe a traditional symbolic system, not a prediction or advice. Solar-term and lunar-date times follow China Standard Time (UTC+8) and are accurate to about a minute; hanzi conversion is character by character.