Agent Tools
List
Back to directory

China Calendar API

https://cn-holiday-x402.linholiday.workers.dev/is-workday?date=2026-10-10
● healthy data

China Calendar API — four pay-per-call endpoints: is a date a working day in mainland China (incl. 调休 make-up workdays, official State Council notices 2025–2026), full holiday list per year, Gregorian to Chinese lunar date (农历, leap months, ganzhi, zodiac, festivals) and the 24 solar terms (节气) with exact UTC+8 times for 1902–2098. 0.01 USDC/call on Base via x402. Invalid input is rejected before payment. Other endpoints: /holidays?year=YYYY, /lunar?date=YYYY-MM-DD, /solar-terms?year=YYYY. Docs: https://cn-holiday-x402.linholiday.workers.dev/llms.txt

Category
data
Chains
base
Price
$0.0100 USDC / call

Quality grade

How grading works
B 69.9 / 100
Availability 40.0 / 40
Endpoint responded (HTTP 200)
Payability 20.0 / 20
  • ✓ Answers a real HTTP 402 challenge
  • ✓ Publishes a /.well-known/x402 descriptor
  • ✓ Payment address on record
  • ✓ Settlement network declared
  • ✓ Price declared
Demand 9.9 / 40
4 distinct payers, 12 USDC transfers in the last 30 days
Owner verified 0.0 / 3
Nobody has claimed this listing yet
Endpoint last checked 5 h ago. On-chain activity last read 2 d ago. Availability and on-chain demand are both re-probed daily; the grade updates automatically on the next pass. This grade sets search order and leaderboards; the readiness score below is shown for reference only.

x402 readiness

B · 84/100

Readiness is how fully this listing follows its protocol and how it behaved in our probes over 30 days. It is shown for reference and does not move it in search. Search order and leaderboards use the separate quality grade (here B, 69.9/100), which weighs availability, payability and on-chain demand. How the two differ

Valid payment requirements 10/10 Payment requirements carry a payee, a mainnet network and a price.
Live 402 challenge 20/25 Endpoint reachable; its 402 challenge was seen earlier (196 ms).
x402 version n/a x402 version not observed yet.
Signed descriptor n/a No x402 standard defines a signed descriptor.
Uptime (30 days) 15/15 23/23 probes succeeded over 30 days (100%).
Resource declaration 10/10 Declares 6 paid resource(s).
Verified identity 5/10 Publisher descriptor (/.well-known/x402 or OpenAPI) on record; claim this listing to verify domain control.
Freshness + modern flags 3/5 seen within 30 days; declares x402.
Security declaration n/a Payment is the access control for an x402 resource.
Applicable criteria total 75 points, scaled to 100.
Responsiveness: Responsive (196 ms; bands ≤2.5 s, ≤5 s, ≤8 s, slower; penalty only).
Payment evidence: x402_challenge — We sent a request and got a live HTTP 402 challenge. Also: x402_manifest, catalog_listing. Qualifies the payment claim; adds no points.
Measured 2026-11-11.
Nine criteria, the same as the A2A readiness score, read from our daily probe of the paid endpoint, its payment requirements and 30-day probe history. Signed descriptor and security declaration are n/a for x402 (payment is the access control), as is an x402 version we have not observed; the remaining points are scaled to 100. Grades: A>=90, B>=75, C>=60, D>=40, F<40. Display only: search order uses the quality grade.

Compared with peers

Against 10,060 reachable x402 APIs in our daily snapshot (2026-11-12 01:39 UTC). Display only; it does not change search order.

Readiness
Higher than 67% of peers
This listing 84 · peer median 78
Latency
Faster than 52% of peers
This listing 196 ms · peer median 205 ms

Where it loses the most points, and how to win them back

  • Live 402 challenge −5 — Answer the paid path with a valid 402 challenge.
    Now: Endpoint reachable; its 402 challenge was seen earlier (196 ms).
  • Verified identity −5 — Claim the listing and prove control of its domain.
    Now: Publisher descriptor (/.well-known/x402 or OpenAPI) on record; claim this listing to verify domain control.
  • Freshness + modern flags −2 — Keep the listing current in the registry or source it comes from.
    Now: seen within 30 days; declares x402.

How many agent tools actually work · All statistics

Paid endpoints

6 resource(s) advertised by this origin. Each price below is that resource's own x402 price; the headline price is the range across them.

GET https://cn-holiday-x402.linholiday.workers.dev/is-workday $0.0100 / call

Is a given date a working day in mainland China? Accounts for statutory holidays and 调休 make-up workdays (official State Council notices).

GET https://cn-holiday-x402.linholiday.workers.dev/holidays $0.0100 / call

All statutory holiday periods and 调休 make-up workdays for a year in mainland China, with the official notice reference.

GET https://cn-holiday-x402.linholiday.workers.dev/lunar $0.0100 / call

Convert a Gregorian date to the Chinese lunar calendar (农历): lunar month/day incl. leap months, ganzhi (干支), zodiac, solar term and traditional festivals. Years 1902-2098.

GET https://cn-holiday-x402.linholiday.workers.dev/solar-terms $0.0100 / call

The 24 Chinese solar terms (二十四节气) for a Gregorian year with exact times in UTC+8 (e.g. 清明, 冬至). Years 1902-2098.

GET https://cn-holiday-x402.linholiday.workers.dev/validate/uscc $0.0100 / call

Validate a mainland China Unified Social Credit Code (统一社会信用代码, GB 32100-2015): format, MOD-31 check character, registration authority, organization type, region. Offline, nothing stored.

GET https://cn-holiday-x402.linholiday.workers.dev/validate/cn-resident-id $0.0100 / call

Validate a mainland China resident ID number (居民身份证号, GB 11643-1999): format, MOD 11-2 check digit, province, birthdate, age, gender. Offline, nothing stored.

How to call

cURL · x402-fetch / x402-axios will auto-handle 402
curl -sS -i -X GET 'https://cn-holiday-x402.linholiday.workers.dev/is-workday?date=2026-10-10'  # expect HTTP 402 Payment Required (about 0.01 USDC/call)
/.well-known/x402.json
https://cn-holiday-x402.linholiday.workers.dev/.well-known/x402

Listed in

Directories this entry was found in.

submission since 2026-10-21 x402scan since 2026-10-21