# CN Data – China A-Share Shareholder Count

> CN Data – China A-Share Shareholder Count is a paid API for AI agents from cn-data-x402.cn-data-x402-worker.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-16).

Returns the latest reported shareholder count (holder number) data for Chinese A-share stocks, including changes in holder numbers and average holdings, sourced from East Money (东方财富).

## Facts

- Endpoint: GET https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/holder-count?utm_source=zero.xyz
- Price: $0.02/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-china-a-share-shareholder-count-f742cf4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1Rmq3kfVuJp5p_1kkZ8Xd

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-china-a-share-shareholder-count-f742cf4a
```

Example prompt: Show me the top 20 A-share stocks with the biggest decrease in shareholder count as of the most recent reporting period, sorted by holder count change, so I can spot where chips are concentrating.

## When to prefer this

Use this endpoint when you need machine-readable, structured shareholder count (holder number) data for Chinese A-share stocks — data that is otherwise only available as Chinese-language web pages on East Money. Prefer this over general web scraping or manual lookup when you need clean JSON, bulk screening across thousands of stocks, or change-based ranking. It requires no API key, just a small USDC micropayment per call via the x402 protocol.

## Known failure modes

- HTTP 402 returned before payment is made — must pay $0.02 USDC on Base and retry
- Invalid date format (not YYYY-MM-DD) returns an error or empty result
- Symbol not found for non-existent or delisted stock codes
- limit out of range (must be 1–300)
- direction parameter typo returns default behavior silently
- No data available for a future or very recent reporting period that hasn't been published yet

## 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 with an array of items, each containing: stock code, name, exchange symbol, end date of the reporting period, holder count, change in holder count, percent change, average shares held per holder, average market cap per holder, total market cap, close price, and notice date. Also includes metadata: sort order applied, total matching records, count of stocks with increasing vs decreasing holder numbers, and the original Chinese data source name.

## 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": {
      "date": {
       "type": "string",
       "description": "报告期 YYYY-MM-DD，如 2026-09-30"
      },
      "sort": {
       "type": "string",
       "description": "排序：date（披露日倒序，默认）/ change（户数变动幅度）/ num（户数多少）"
      },
      "limit": {
       "type": "integer",
       "description": "返回条数 1-300，默认 50"
      },
      "symbol": {
       "type": "string",
       "description": "6 位股票代码，查单只股票"
      },
      "direction": {
       "type": "string",
       "description": "默认降序，传 down 只看户数减少（筹码集中）"
      }
     }
    }
   },
   "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": {
   "sort": "date",
   "items": [
    {
     "code": "003023",
     "name": "彩虹集团",
     "symbol": "003023.SZ",
     "endDate": "2026-10-09",
     "holderNum": 10212,
     "closePrice": 26.99,
     "noticeDate": "2026-10-10",
     "holderChange": 443,
     "avgHoldShares": 10315.4719937329,
     "avgMarketCapYuan": 278414.58911085,
     "previousHolderNum": 9769,
     "totalMarketCapYuan": 2843169784,
     "holderChangePercent": 4.534752789436
    }
   ],
   "source": "东方财富 数据中心（股东户数，RPT_HOLDERNUMLATEST）",
   "symbol": null,
   "endDate": null,
   "returned": 1,
   "totalMatching": 5569,
   "decreasingCount": 2,
   "increasingCount": 3
  },
  "endpoint": "/cn/holder-count"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cn-data-china-a-share-shareholder-count-f742cf4a/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)