{"openapi":"3.1.0","info":{"title":"Chinese Calendar and Culture","version":"1.0.0","description":"Solar terms, lunar dates, BaZi pillars, I Ching hexagrams, hanzi pinyin and simplified/traditional conversion. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Chinese Calendar and Culture: Solar terms, lunar dates, BaZi pillars, I Ching hexagrams, hanzi pinyin and simplified/traditional conversion. /solar-term (24 solar terms and times), /lunar-date (Gregorian and Chinese lunar date both ways with leap months), /bazi (Four Pillars chart), /i-ching (hexagram lookup and seeded casting), /hanzi-info (pinyin, meaning, strokes, variants), /pinyin (text to pinyin), /simp-trad (simplified and traditional conversion). Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://chinese-culture.x402tookit.com"}],"paths":{"/bazi":{"get":{"operationId":"bazi","summary":"Four Pillars (BaZi) chart for a date and optional time: stems, branches, animals, five-element counts, day master.","description":"Four Pillars (BaZi) chart for a date and optional time: stems, branches, animals, five-element counts, day master.","tags":["bazi","four-pillars","chinese-calendar","sexagenary"],"parameters":[{"name":"date","in":"query","required":true,"description":"Civil date YYYY-MM-DD, 1930 to 2100","schema":{"type":"string"}},{"name":"time","in":"query","required":false,"description":"Local clock time HH:MM; omit to skip the hour pillar","schema":{"type":"string"}},{"name":"utcOffset","in":"query","required":false,"description":"Clock offset from UTC in hours, -12 to 14, default 8 (China)","schema":{"type":"number"}},{"name":"dayStarts","in":"query","required":false,"description":"midnight (default) or 23:00 for schools whose day begins at 23:00","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"pillars":{"type":["null","object"],"properties":{"year":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"stemElement":{"type":["null","string"]},"stemPolarity":{"type":["null","string"]},"branchAnimal":{"type":["null","string"]},"branchElement":{"type":["null","string"]}}},"month":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"stemElement":{"type":["null","string"]},"stemPolarity":{"type":["null","string"]},"branchAnimal":{"type":["null","string"]},"branchElement":{"type":["null","string"]}}},"day":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"stemElement":{"type":["null","string"]},"stemPolarity":{"type":["null","string"]},"branchAnimal":{"type":["null","string"]},"branchElement":{"type":["null","string"]}}},"hour":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"stemElement":{"type":["null","string"]},"stemPolarity":{"type":["null","string"]},"branchAnimal":{"type":["null","string"]},"branchElement":{"type":["null","string"]}}}}},"dayMaster":{"type":["null","object"],"properties":{"stem":{"type":["null","string"]},"element":{"type":["null","string"]},"polarity":{"type":["null","string"]}}},"elementCounts":{"type":["null","object"],"properties":{"Wood":{"type":["null","number"]},"Fire":{"type":["null","number"]},"Earth":{"type":["null","number"]},"Metal":{"type":["null","number"]},"Water":{"type":["null","number"]}}},"strongestElements":{"type":["array","null"],"items":{"type":"string"}},"missingElements":{"type":["array","null"],"items":{"type":"string"}},"baziYear":{"type":["null","number"]},"sunLongitudeDeg":{"type":["null","number"]},"utcOffset":{"type":["null","number"]},"dayStartsAt":{"type":["null","string"]},"hourPillarIncluded":{"type":["boolean","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CHART_COMPUTED","summary":"1990-05-17 14:30: 庚午 辛巳 壬午 丁未 (year, month, day, hour); day master 壬 Water.","reasons":["BaZi year 1990 (the year changes at Lichun, not on 1 January or lunar New Year).","The month pillar changes at the 12 jie solar terms; the day pillar counts days in a 60-day cycle."],"pillars":{"year":{"text":"庚午","pinyin":"Geng-Wu","stemElement":"Metal","stemPolarity":"yang","branchAnimal":"Horse","branchElement":"Fire"},"month":{"text":"辛巳","pinyin":"Xin-Si","stemElement":"Metal","stemPolarity":"yin","branchAnimal":"Snake","branchElement":"Fire"},"day":{"text":"壬午","pinyin":"Ren-Wu","stemElement":"Water","stemPolarity":"yang","branchAnimal":"Horse","branchElement":"Fire"},"hour":{"text":"丁未","pinyin":"Ding-Wei","stemElement":"Fire","stemPolarity":"yin","branchAnimal":"Goat","branchElement":"Earth"}},"dayMaster":{"stem":"壬","element":"Water","polarity":"yang"},"elementCounts":{"Wood":0,"Fire":4,"Earth":1,"Metal":2,"Water":1},"strongestElements":["Fire"],"missingElements":["Wood"],"baziYear":1990,"sunLongitudeDeg":56.108,"utcOffset":8,"dayStartsAt":"midnight","hourPillarIncluded":true,"degraded":false,"notChecked":["true solar time or longitude correction (the clock time you give is used as is)","historical daylight-saving clocks (give the offset actually in force)","…2 more"],"source":"Sexagenary cycle arithmetic with exact Lichun and jie-term instants (Meeus ch. 25), computed locally","asOf":"2026-10-21T00:32:43.318Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0300"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/bazi"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/bazi"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/bazi"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/bazi"}}]}}},"/hanzi-info":{"get":{"operationId":"hanzi_info","summary":"Look up Chinese characters: pinyin readings, English meaning, stroke count, simplified and traditional forms.","description":"Look up Chinese characters: pinyin readings, English meaning, stroke count, simplified and traditional forms.","tags":["hanzi","pinyin","chinese-characters","unicode"],"parameters":[{"name":"chars","in":"query","required":true,"description":"One to 10 Chinese characters, e.g. 行 or 国 or 漢","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"characters":{"type":["array","null"],"items":{"type":"object","properties":{"char":{"type":["null","string"]},"codepoint":{"type":["null","string"]},"pinyin":{"type":["array","null"],"items":{"type":"string"}},"definition":{"type":["null","string"]},"strokes":{"type":["null","number"]},"common":{"type":["boolean","null"]},"simplified":{},"traditional":{"type":["array","null"],"items":{"type":"string"}}}}},"notCovered":{"type":["array","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"行 xíng (go); 国 guó (nation, country, nation-state).","reasons":["行 has more than one reading; the first is the most common."],"characters":[{"char":"行","codepoint":"U+884C","pinyin":["xíng","háng"],"definition":"go; walk; move, travel; circulate; Kangxi radical 144","strokes":6,"common":true,"simplified":null,"traditional":null},{"char":"国","codepoint":"U+56FD","pinyin":["guó"],"definition":"nation, country, nation-state","strokes":8,"common":true,"simplified":null,"traditional":["國"]}],"notCovered":[],"degraded":false,"notChecked":["characters outside the 17,431 covered (rare, historical or variant forms)","word-level meaning and context-dependent readings","…1 more"],"source":"Unicode Unihan database 18.0 (Unicode License v3), computed locally","asOf":"2026-10-21T00:32:43.581Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/hanzi-info"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/hanzi-info"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/hanzi-info"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/hanzi-info"}}]}}},"/i-ching":{"get":{"operationId":"i_ching","summary":"Look up an I Ching hexagram by number or lines, or cast one from a question and date with changing lines.","description":"Look up an I Ching hexagram by number or lines, or cast one from a question and date with changing lines.","tags":["i-ching","hexagram","chinese-culture","divination"],"parameters":[{"name":"number","in":"query","required":false,"description":"Hexagram 1 to 64 (King Wen order)","schema":{"type":"integer"}},{"name":"lines","in":"query","required":false,"description":"Six lines bottom to top as 1 (solid) and 0 (broken), e.g. 111000","schema":{"type":"string"}},{"name":"cast","in":"query","required":false,"description":"A question or any text: the same text always casts the same hexagram","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"Optional date mixed into the cast seed, any text such as 2026-10-21","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"lineValuesBottomToTop":{"type":["array","null"],"items":{"type":"number"}},"changingLines":{"type":["array","null"],"items":{"type":"number"}},"primary":{"type":["null","object"],"properties":{"number":{"type":["null","number"]},"chinese":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"english":{"type":["null","string"]},"symbol":{"type":["null","string"]},"lowerTrigram":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"chinese":{"type":["null","string"]},"nature":{"type":["null","string"]}}},"upperTrigram":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"chinese":{"type":["null","string"]},"nature":{"type":["null","string"]}}},"linesBottomToTop":{"type":["null","string"]}}},"relating":{"type":["null","object"],"properties":{"number":{"type":["null","number"]},"chinese":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"english":{"type":["null","string"]},"symbol":{"type":["null","string"]},"lowerTrigram":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"chinese":{"type":["null","string"]},"nature":{"type":["null","string"]}}},"upperTrigram":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"chinese":{"type":["null","string"]},"nature":{"type":["null","string"]}}},"linesBottomToTop":{"type":["null","string"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"HEXAGRAM_CAST","summary":"Cast 22 賁 Bi \"Grace\", changing to 18 蠱 Gu.","reasons":["Each line is three coins: heads 3, tails 2 (6 old yin, 7 young yang, 8 young yin, 9 old yang), taken from a SHA-256 of your text so the cast is repeatable.","Changing lines (counted from the bottom): 1, 2."],"lineValuesBottomToTop":[9,6],"changingLines":[1,2],"primary":{"number":22,"chinese":"賁","pinyin":"Bi","english":"Grace","symbol":"䷕","lowerTrigram":{"name":"Li","chinese":"離","nature":"Fire"},"upperTrigram":{"name":"Gen","chinese":"艮","nature":"Mountain"},"linesBottomToTop":"101001"},"relating":{"number":18,"chinese":"蠱","pinyin":"Gu","english":"Repairing decay","symbol":"䷑","lowerTrigram":{"name":"Xun","chinese":"巽","nature":"Wind"},"upperTrigram":{"name":"Gen","chinese":"艮","nature":"Mountain"},"linesBottomToTop":"011001"},"degraded":false,"notChecked":["the traditional judgments, image texts and line statements (not reproduced: they are copyrighted translations)","any claim that a cast predicts anything: this is a seeded symbolic draw for cultural or entertainment use"],"source":"King Wen sequence and trigram table (standard arrangement); seeded SHA-256 coin method; computed locally","asOf":"2026-10-21T00:32:43.845Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/i-ching"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/i-ching"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/i-ching"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/i-ching"}}]}}},"/lunar-date":{"get":{"operationId":"lunar_date","summary":"Convert a Gregorian date to the Chinese lunar date (with leap month) or back, plus zodiac animal and year name.","description":"Convert a Gregorian date to the Chinese lunar date (with leap month) or back, plus zodiac animal and year name.","tags":["lunar-calendar","chinese-calendar","chinese-new-year","zodiac"],"parameters":[{"name":"date","in":"query","required":false,"description":"Gregorian YYYY-MM-DD (1930 to 2100) to convert to lunar","schema":{"type":"string"}},{"name":"lunar","in":"query","required":false,"description":"Lunar YYYY-MM-DD to convert to Gregorian; add an L after the month for a leap month: 2023-02L-01","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"gregorian":{"type":["null","string"]},"lunarYear":{"type":["null","number"]},"lunarMonth":{"type":["null","number"]},"leapMonth":{"type":["boolean","null"]},"lunarDay":{"type":["null","number"]},"monthLengthDays":{"type":["null","number"]},"monthName":{"type":["null","string"]},"yearPillar":{"type":["null","string"]},"yearPillarPinyin":{"type":["null","string"]},"zodiacAnimal":{"type":["null","string"]},"element":{"type":["null","string"]},"leapMonthOfThatYear":{},"isNewYearsDay":{"type":["boolean","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"2024-02-10 is lunar 2024-01-01: Wood Dragon year (甲辰), month 1, day 1.","reasons":["This is the first day of a lunar month (a new-moon day in China).","Lunar year 2024 has no leap month."],"gregorian":"2024-02-10","lunarYear":2024,"lunarMonth":1,"leapMonth":false,"lunarDay":1,"monthLengthDays":29,"monthName":"Zhengyue","yearPillar":"甲辰","yearPillarPinyin":"Jia-Chen","zodiacAnimal":"Dragon","element":"Wood","leapMonthOfThatYear":null,"isNewYearsDay":true,"degraded":false,"notChecked":["a month that begins within about 10 minutes of midnight China time can be a day off (rare: roughly 1 month in 700)","dates before 1930 (local mean time era) and after 2100","…1 more"],"source":"Meeus ch. 49 new moons and ch. 25 solar terms with the official lunar-calendar rule (GB/T 33661-2017), computed locally","asOf":"2026-10-21T00:32:44.111Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/lunar-date"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/lunar-date"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/lunar-date"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/lunar-date"}}]}}},"/pinyin":{"get":{"operationId":"pinyin","summary":"Convert Chinese text to pinyin with tone marks or tone numbers; flags characters with several readings.","description":"Convert Chinese text to pinyin with tone marks or tone numbers; flags characters with several readings.","tags":["pinyin","romanization","chinese-text","tones"],"parameters":[{"name":"text","in":"query","required":true,"description":"Chinese text, up to 200 characters","schema":{"type":"string"}},{"name":"style","in":"query","required":false,"description":"marks (default, zhōng), numbers (zhong1) or plain (zhong)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"pinyin":{"type":["null","string"]},"syllables":{"type":["null","number"]},"style":{"type":["null","string"]},"polyphonicCharacters":{"type":["array","null"],"items":{"type":"object","properties":{"char":{"type":["null","string"]},"readings":{"type":["array","null"],"items":{"type":"string"}}}}},"unconvertedHan":{"type":["array","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"nǐ hǎo，zhōng guó","reasons":["2 character(s) have more than one reading; the most common was used."],"pinyin":"nǐ hǎo，zhōng guó","syllables":4,"style":"marks","polyphonicCharacters":[{"char":"好","readings":["hǎo","hāo","…1 more"]},{"char":"中","readings":["zhōng","zhòng"]}],"unconvertedHan":[],"degraded":false,"notChecked":["context: polyphonic characters (行, 长, 的, 了) use their most common reading, which is wrong in some words","tone sandhi (e.g. 不 before a fourth tone, 一 changes)","…1 more"],"source":"Unicode Unihan 18.0 kMandarin/kHanyuPinlu readings, first (most common) reading per character, computed locally","asOf":"2026-10-21T00:32:44.370Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/pinyin"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/pinyin"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/pinyin"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/pinyin"}}]}}},"/simp-trad":{"get":{"operationId":"simp_trad","summary":"Convert Chinese text between simplified and traditional characters; reports ambiguous one-to-many characters.","description":"Convert Chinese text between simplified and traditional characters; reports ambiguous one-to-many characters.","tags":["simplified-chinese","traditional-chinese","conversion","hanzi"],"parameters":[{"name":"text","in":"query","required":true,"description":"Chinese text, up to 500 characters","schema":{"type":"string"}},{"name":"to","in":"query","required":true,"description":"simplified or traditional","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"text":{"type":["null","string"]},"target":{"type":["null","string"]},"charactersChanged":{"type":["null","number"]},"ambiguous":{"type":["array","null"]},"unknownHan":{"type":["array","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"汉语发展","reasons":["3 character(s) changed to simplified forms."],"text":"汉语发展","target":"simplified","charactersChanged":3,"ambiguous":[],"unknownHan":[],"degraded":false,"notChecked":["word-level conversion: 头发 needs 頭髮 but this gives 頭發 (see ambiguous)","regional vocabulary differences (Taiwan, Hong Kong, mainland)","…1 more"],"source":"Unicode Unihan 18.0 kSimplifiedVariant / kTraditionalVariant (Unicode License v3), computed locally","asOf":"2026-10-21T00:32:44.631Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/simp-trad"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/simp-trad"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/simp-trad"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/simp-trad"}}]}}},"/solar-term":{"get":{"operationId":"solar_term","summary":"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.","description":"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.","tags":["solar-terms","jieqi","chinese-calendar","astronomy"],"parameters":[{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD, 1930 to 2100: the term in force and the next one","schema":{"type":"string"}},{"name":"year","in":"query","required":false,"description":"Instead of a date: list all 24 terms of this Gregorian year","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"date":{"type":["null","string"]},"current":{"type":["null","object"],"properties":{"chinese":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"english":{"type":["null","string"]},"solarLongitude":{"type":["null","number"]},"majorTerm":{"type":["boolean","null"]},"timeChina":{"type":["null","string"]},"timeUtc":{"type":["null","string"]}}},"next":{"type":["null","object"],"properties":{"chinese":{"type":["null","string"]},"pinyin":{"type":["null","string"]},"english":{"type":["null","string"]},"solarLongitude":{"type":["null","number"]},"majorTerm":{"type":["boolean","null"]},"timeChina":{"type":["null","string"]},"timeUtc":{"type":["null","string"]}}},"daysUntilNext":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"TERM_IN_FORCE","summary":"2024-02-10: 立春 Lichun (Start of Spring) is in force; next is Yushui on 2024-02-19.","reasons":["Lichun began 2024-02-04T16:20+08:00.","A term belongs to the whole civil day (China Standard Time) it begins on."],"date":"2024-02-10","current":{"chinese":"立春","pinyin":"Lichun","english":"Start of Spring","solarLongitude":315,"majorTerm":false,"timeChina":"2024-02-04T16:20+08:00","timeUtc":"2024-02-04T08:20Z"},"next":{"chinese":"雨水","pinyin":"Yushui","english":"Rain Water","solarLongitude":330,"majorTerm":true,"timeChina":"2024-02-19T12:11+08:00","timeUtc":"2024-02-19T04:10Z"},"daysUntilNext":9,"degraded":false,"notChecked":["the exact second (the formula is good to a few minutes, up to about 10)","local solar time for places away from UTC+8","…1 more"],"source":"Meeus ch. 25 solar longitude, computed locally; times accurate to about 10 minutes","asOf":"2026-10-21T00:32:44.882Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/solar-term"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/solar-term"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/solar-term"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://chinese-culture.x402tookit.com/solar-term"}}]}}}}}