# CN Data – Chinese Stock Exchange Trading Days Calendar

> CN Data – Chinese Stock Exchange Trading Days Calendar is a paid API for AI agents from cn-data-x402.cn-data-x402-worker.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-16).

Returns a structured calendar of Chinese stock market trading days and holidays for a specified date range, including the next trading day.

## Facts

- Endpoint: GET https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/trading-days?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cn-data-chinese-stock-exchange-trading-days-calendar-6f6463c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_41UVE8185GswT5mudOXVk

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability cn-data-chinese-stock-exchange-trading-days-calendar-6f6463c4
```

Example prompt: Can you pull the Chinese stock exchange trading calendar starting from November 1st for the next 14 days, so I can see which days the A-share markets are open and what the next trading day is?

## When to prefer this

Choose this endpoint when you need authoritative, machine-readable Chinese A-share market open/close status — especially when other sources only publish this as a Chinese-language web page. It is ideal for agents scheduling financial workflows, settlement jobs, or trade execution around official Chinese market calendars. At $0.01 USDC per call with no signup, it is the lowest-friction option for one-off or automated calendar lookups on China's stock markets.

## Known failure modes

- Invalid date format for `from` parameter — endpoint expects YYYY-MM-DD
- `days` parameter out of range (must be 1–30) — may return error or clamp
- Payment not completed — returns HTTP 402 with USDC payment terms before data is served
- Future dates beyond known holiday schedule may have calendarKnown=false entries
- Network timeout on Cloudflare Worker edge node

## How this service works

Chinese market and China-focused public data over the x402 protocol. No API key and no signup: call any endpoint, receive HTTP 402 with payment terms, pay the listed amount in USDC on Base and retry. Every response is JSON. Some Chinese-language sources are published only as web pages — these endpoints return them as clean, machine-readable JSON.

## Output

A JSON object containing: the requested date range, a day-by-day calendar array (each entry has date, weekday, isTradingDay, isHoliday, holidayName, isMakeupWorkday, calendarKnown), aggregate counts of trading days and closed days in the window, and the date of the next upcoming trading day.

## Request schema (JSON Schema)

```json
{
 "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",
     "properties": {
      "days": {
       "type": "integer",
       "description": "往后看几天 1-30，默认 7"
      },
      "from": {
       "type": "string",
       "description": "起始日期 YYYY-MM-DD，默认今天"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "days": 30,
   "from": "2026-10-03",
   "calendar": [
    {
     "date": "2026-10-03",
     "note": "周末休市",
     "weekday": "周六",
     "isHoliday": false,
     "holidayName": null,
     "isTradingDay": false,
     "calendarKnown": true,
     "isMakeupWorkday": false
    }
   ],
   "closedDays": 13,
   "tradingDays": 17,
   "nextTradingDay": "2026-10-09"
  },
  "endpoint": "/cn/trading-days"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cn-data-chinese-stock-exchange-trading-days-calendar-6f6463c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cn-data-x402.cn-data-x402-worker.workers.dev](https://www.zero.xyz/host/cn-data-x402.cn-data-x402-worker.workers.dev/llms.txt)