{"uid":"cap_nPgGqpeVM9K4MLbyh-Djx","slug":"china-calendar-api-holidays-adjusted-workdays-lunar-dates-solar-terms-47ae737f","name":"China Calendar API: Holidays, Adjusted Workdays, Lunar Dates, 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/holidays?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,"holidays":[{"end":"2026-01-03","days":3,"name":"元旦","start":"2026-01-01","nameEn":"New Year's Day"}],"adjustedWorkdays":["2026-01-04"]}},"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_HS8otdRdVCnfqe_3AQSMM","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 official Chinese public holidays and 调休 (adjusted makeup workdays) for a given year, including holiday names in Chinese and English, date ranges, and compensatory workdays.","exampleAgentPrompt":"Can you pull up all the official Chinese public holidays and 调休 makeup workdays for 2025, including each holiday's English name, start date, end date, and how many days long it is?","exampleUseCases":[{"title":"HR payroll planning for China office","prompt":"I need to know all the Chinese public holidays and makeup workdays for 2026 so I can set up our payroll and leave calendar for our Shanghai team — can you get me the full list with dates and durations?"},{"title":"Checking if Chinese offices are closed","prompt":"We're scheduling a product launch call with our Beijing partners in early October 2025 — can you check whether there are any Chinese national holidays during that week that might affect their availability?"},{"title":"Cross-border e-commerce shipping calendar","prompt":"Can you get me all Chinese official holidays and adjusted workdays for 2025? I need to know when warehouses in China will be closed or working overtime so I can plan shipping lead times for our store."}],"resultDescription":"Returns a JSON object with the requested year, an array of holiday objects (each with Chinese name, English name, start date, end date, and number of days), and a list of adjusted workday dates (调休 dates when employees must work to compensate for extended holiday weekends).","failureModes":["Missing or invalid 'year' query parameter returns a validation error","Requesting a year far outside supported range may return empty or partial data","Payment failure via x402 protocol results in 402 Payment Required response","Network timeout if Cloudflare Worker is cold-starting"],"whenToPreferThis":"Choose this endpoint when you need authoritative, structured data on China's official holiday schedule — including both public holidays and 调休 compensatory workdays — for a specific year. It is especially useful for HR systems, payroll tools, cross-border logistics, and scheduling agents that must respect the Chinese government's official calendar, including adjusted Saturday work obligations that standard calendar libraries miss.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:08:17.354Z","isFirstParty":false,"canonicalSlug":"china-calendar-api-holidays-adjusted-workdays-lunar-dates-solar-terms-47ae737f"}