{"uid":"cap_jpsMsesSzXK2wLc2SUpxe","slug":"china-calendar-api-solar-terms-545d6f8b","name":"China Calendar API – Solar Terms","description":"Each paid call costs 0.01 USDC on eip155:8453 via x402 (exact scheme). Free: /health, /, /openapi.json, /llms.txt, /.well-known/x402.","url":"https://cn-holiday-x402.linholiday.workers.dev/solar-terms?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["year"],"properties":{"year":{"type":"string","description":"YYYY"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2026,"terms":[{"en":"Minor Cold","zh":"小寒","date":"2026-01-05","time":"2026-01-05T16:23:10+08:00"},{"en":"Major Cold","zh":"大寒","date":"2026-01-20","time":"2026-01-20T09:44:56+08:00"}],"timezone":"Asia/Shanghai (UTC+8)"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_x-eJscFMcXCf0Y5q_bj6N","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all 24 Chinese solar terms (节气) with their exact dates and times for a given year","exampleAgentPrompt":"Can you get me all the Chinese solar terms (节气) for 2026, including their exact dates and times in Shanghai timezone?","exampleUseCases":[{"title":"Traditional farming event planning","prompt":"I'm writing a traditional Chinese farming almanac app — can you pull all 24 solar term dates and exact times for 2025 so I can show users when each seasonal period begins?"},{"title":"Cultural festival scheduling","prompt":"Our cultural center wants to host events aligned with Chinese solar terms this year. Can you list all the 节气 for 2026 with their dates so we can plan our calendar?"},{"title":"Automated solar term reminders","prompt":"I want to set up reminders for every Chinese solar term in 2027 — please fetch all of them with their exact timestamps so I can schedule notifications."}],"resultDescription":"Returns a JSON object containing the requested year, a list of all 24 solar terms each with English name, Chinese name (zh), date (YYYY-MM-DD), and exact ISO 8601 timestamp in Asia/Shanghai (UTC+8), plus a timezone label.","failureModes":["Missing 'year' query parameter returns a validation error","Invalid year format (non-YYYY string) may return a 400 error","Years far outside the supported historical/future range may return empty or error responses","Payment not provided or rejected results in HTTP 402 with x402 payment details","Network timeout on the Cloudflare Workers edge"],"whenToPreferThis":"Use this endpoint when you need precise, programmatic access to all 24 Chinese solar terms (节气) for a specific Gregorian year, including exact timestamps in Asia/Shanghai timezone. Prefer it over general astronomy APIs when you specifically need Chinese traditional calendar solar terms with bilingual (English/Chinese) labels at low cost ($0.01/call via crypto micropayment).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:11:22.138Z","isFirstParty":false,"canonicalSlug":"china-calendar-api-solar-terms-545d6f8b"}