{"uid":"cap_1Rmq3kfVuJp5p_1kkZ8Xd","slug":"cn-data-china-a-share-shareholder-count-f742cf4a","name":"CN Data – China A-Share Shareholder Count","description":"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.","url":"https://cn-data-x402.cn-data-x402-worker.workers.dev/cn/holder-count?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","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"}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xR03xx79LJ6XLhwFdnAWT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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 (东方财富).","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Chip concentration screening","prompt":"Give me the 50 A-share stocks where holder count dropped the most in the last reporting period — I want to find where smart money is quietly accumulating."},{"title":"Single stock holder count lookup","prompt":"What was the shareholder count for stock 003023 as of the latest disclosure, and how much did it change from the prior period?"},{"title":"Increasing retail participation alert","prompt":"Show me Chinese A-shares where shareholder count increased the most recently, sorted by the size of that increase — I want to know which stocks retail investors are piling into."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:42:06.142Z","isFirstParty":false,"canonicalSlug":"cn-data-china-a-share-shareholder-count-f742cf4a"}