# China A-Share Institutional Holdings — 机构持股 API (`nexgendata/china-a-share-institutional-holdings`) Actor Track China A-share institutional holdings and major shareholders. Clean JSON for analysts, quants and AI agents. - **URL**: https://apify.com/nexgendata/china-a-share-institutional-holdings.md - **Developed by:** [NexGenData](https://apify.com/nexgendata) (community) - **Categories:** Business, AI, Developer tools - **Stats:** 5 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $100.00 / 1,000 holder rows This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## China A-Share Institutional Holdings Track China A-share institutional holdings and major shareholders. Built for analysts, quants, fintech builders and AI agents. Factual public data — not financial or investment advice. ### 📊 Sample Output ![6 real rows delivered by China A-Share Institutional Holdings — 机构持股 API — run ay7OaHUFdlZ17sydQ on build 0.0.19](https://api.apify.com/v2/key-value-stores/8gLgXMBveEI1tTz1z/records/china-a-share-institutional-holdings-sample) | `stockCode` | `secuCode` | `market` | `reportDate` | `reportName` | `holderName` | |---|---|---|---|---|---| | 301029 | 301029.SZ | SZSE (ChiNext) | 2026-09-18 | 2026-09-18 | 伟盈新能源科技(无锡)有限公司 | | 300808 | 300808.SZ | SZSE (ChiNext) | 2026-09-18 | 2026-09-18 | 十堰中达汇享企业管理合伙企业(有限合伙) | | 301029 | 301029.SZ | SZSE (ChiNext) | 2026-09-18 | 2026-09-18 | 广东恒阔投资有限公司 | | 301029 | 301029.SZ | SZSE (ChiNext) | 2026-09-18 | 2026-09-18 | 苏州钟鼎五号股权投资基金合伙企业(有限合伙) | | 301029 | 301029.SZ | SZSE (ChiNext) | 2026-09-18 | 2026-09-18 | 全国社保基金一一四组合 | | 301029 | 301029.SZ | SZSE (ChiNext) | 2026-09-18 | 2026-09-18 | 香港中央结算有限公司 | Real rows from run `ay7OaHUFdlZ17sydQ` on build 0.0.19 (2026-09-25), unedited apart from masked emails/phones and shortened long text; fields the source does not publish are empty. ### 🔧 Input reference | Field | Type | Default | What it does | |---|---|---|---| | `holderType` | string (institutions, fund, qfii, insurance, social_security, broker, all) | `"institutions"` | Filter holders by type. | | `changeFilter` | string (all, new, increased, reduced) | `"all"` | Only return holders whose position changed this way vs last quarter. | | `securityCodes` | array | | Restrict to specific 6-digit A-share codes (e.g. 600519, 300750). Empty = whole market. | | `holderNameContains` | string | | Find all positions held by a specific institution — match on holder name (e.g. 香港中央结算, 中央汇金, a fund name). | | `reportPeriod` | string | | Quarter-end date, YYYY-MM-DD (e.g. 2026-03-31). Leave blank for each stock's latest disclosed holders. | | `includeNEEQ` | boolean | `false` | Off by default — A-shares only. | | `maxResults` | integer | `500` | Maximum holder rows to return. | ### 🧾 JSON sample record One real record from run `ay7OaHUFdlZ17sydQ` (emails/phones masked, long text shortened): ```json { "stockCode": "301029", "stockName": "怡合达", "secuCode": "301029.SZ", "market": "SZSE (ChiNext)", "reportDate": "2026-09-18", "reportName": "2026-09-18", "holderRank": 1, "holderName": "伟盈新能源科技(无锡)有限公司", "holderType": "Other", "holderCategory": "Other", "isInstitution": true, "sharesHeld": 59152776, "holdingValueCny": 1456341345.12, "pctOfFreeFloat": 9.3032, "changeType": "Unchanged", "ratioChangePct": -0.0239, "sharesType": "A股", "dataSource": "Eastmoney 十大流通股东 (live)" } ``` ### 💰 Pricing | Event | Price (USD) | When it is charged | |---|---|---| | Actor Start (`apify-actor-start`) | $5e-05 | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). | | Holder row (`apify-default-dataset-item`) | $0.1 | One top-shareholder record: holder, type, shares, value, % float, position change. | Pay-per-event: you pay only for what the run delivers. A run that delivers nothing bills no result events (only the actor-start event, when the actor defines one). Example: a run that delivers 100 results costs 100 × $0.1 = $10.00 plus the start fee. ### 🔗 Related Actors More from the NexGenData **China markets** family: - [Bilibili Video Search by Keyword · B站视频搜索 (No Login)](https://apify.com/nexgendata/bilibili-video-search?fpr=2ayu9b) - [Beijing BSE Stock Screener — 北交所 A股 API](https://apify.com/nexgendata/bse-beijing-stock-screener?fpr=2ayu9b) - [China A-Share Financials — 财务数据 API](https://apify.com/nexgendata/china-a-share-financials?fpr=2ayu9b) - [China A-Share Main-Force Fund Flow — 主力资金 API](https://apify.com/nexgendata/china-a-share-smart-money-tracker?fpr=2ayu9b) - [China A-Share Unlock Calendar — 限售解禁 API](https://apify.com/nexgendata/china-a-share-unlock-calendar?fpr=2ayu9b) - [China Block Trades — 大宗交易 API](https://apify.com/nexgendata/china-block-trades-tracker?fpr=2ayu9b) 18 more in this family on the [NexGenData Store page](https://apify.com/nexgendata?fpr=2ayu9b). ### 📊 What you get Clean JSON, one record per holding (full output has 18 fields): - `changeType` — Change Type - `holderCategory` — Holder Category - `holderName` — Holder Name - `holderRank` — Holder Rank - `holderType` — Holder Type - `holdingValueCny` — Holding Value Cny - `isInstitution` — Is Institution - `market` — Market - `pctOfFreeFloat` — Pct Of Free Float - `ratioChangePct` — Ratio Change Pct **Pricing:** $0.10 per holding (Pay-Per-Event) — about **10 holdings per $1**. ### 🤖 Use with AI agents Structured JSON built for LLM and agent pipelines — point Claude, the OpenAI Agents SDK, an n8n flow or any MCP-aware client at it and pull China A-share institutional holdings and shareholders on demand. **Sample agent prompt:** ``` List the top institutional holders of a China A-share stock and their stakes. ``` **Agentic payments (x402):** Supports agentic payment via x402 — agents can call this actor with USDC, no API key required. ### ⏰ Run on a schedule This is a monitoring play — schedule a recurring pull: ```json { "limit": 50 } ``` ### 中文说明 本 Actor 提供中国 A 股的机构持股与主要股东数据（持有人、类别、持股市值、占流通股比例），输出为整洁的 JSON，适用于分析师、量化研究人员、金融科技开发者和 AI 智能体。按「持股记录」计费（约每美元 10 条）。支持定时运行——可每日或每周自动抓取A 股机构持股变动，是一个持续监控型数据源。公开数据，非投资建议。 ### 🔗 Related China actors **China data suite:** [Listed Company Announcements](https://apify.com/nexgendata/china-listed-company-announcements), [Dragon-Tiger List](https://apify.com/nexgendata/china-dragon-tiger-list), [Stock Connect Flow](https://apify.com/nexgendata/china-stock-connect-flow), [A-Share Financials](https://apify.com/nexgendata/china-a-share-financials) **Cross-market hubs:** [APAC Disclosure Monitor](https://apify.com/nexgendata/apac-disclosure-monitor), [APAC IPO Calendar Sweep](https://apify.com/nexgendata/apac-ipo-calendar-sweep) *** \*Data from public Chinese market and government sources. Factual public data — not financial or investment advice. 公开数据，非投资建议。\* # Actor input Schema ## `holderType` (type: `string`): Filter holders by type. ## `changeFilter` (type: `string`): Only return holders whose position changed this way vs last quarter. ## `securityCodes` (type: `array`): Restrict to specific 6-digit A-share codes (e.g. 600519, 300750). Empty = whole market. ## `holderNameContains` (type: `string`): Find all positions held by a specific institution — match on holder name (e.g. 香港中央结算, 中央汇金, a fund name). ## `reportPeriod` (type: `string`): Quarter-end date, YYYY-MM-DD (e.g. 2026-03-31). Leave blank for each stock's latest disclosed holders. ## `includeNEEQ` (type: `boolean`): Off by default — A-shares only. ## `maxResults` (type: `integer`): Maximum holder rows to return. ## Actor input object example ```json { "holderType": "institutions", "changeFilter": "all", "securityCodes": [ "600519", "300750" ], "reportPeriod": "2026-03-31", "includeNEEQ": false, "maxResults": 25 } ``` # Actor output Schema ## `results` (type: `string`): Default dataset of China A-Share Institutional Holdings — 机构持股 API records (18 fields per row: stockCode, stockName, secuCode, market, reportDate, reportName, holderRank, holderName, holderType, holderCategory, isInstitution, sharesHeld…). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "holderType": "institutions", "changeFilter": "all", "includeNEEQ": false, "maxResults": 25 }; // Run the Actor and wait for it to finish const run = await client.actor("nexgendata/china-a-share-institutional-holdings").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "holderType": "institutions", "changeFilter": "all", "includeNEEQ": False, "maxResults": 25, } # Run the Actor and wait for it to finish run = client.actor("nexgendata/china-a-share-institutional-holdings").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "holderType": "institutions", "changeFilter": "all", "includeNEEQ": false, "maxResults": 25 }' | apify call nexgendata/china-a-share-institutional-holdings --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,nexgendata/china-a-share-institutional-holdings" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/2hUh0alKAxA0PfUep/builds/hU5zrzUw5g4YJVsaU/openapi.json