# HKEX News API – Announcements, Director Dealings & CCASS (`data_daemon/hkex-news-filings`) Actor

Hong Kong Exchange (HKEX) data as JSON: HKEXnews announcements with category, title and document link; director and substantial-shareholder dealings (disclosure of interests); CCASS shareholding by participant. Stock-code watchlists, only-new feed. $3 per 1,000 filings, $1 per 1,000 CCASS rows.

- **URL**: https://apify.com/data_daemon/hkex-news-filings.md
- **Developed by:** [Daemon Data](https://apify.com/data_daemon) (community)
- **Categories:** Developer tools, Agents
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 1,000 announcement or dealing rows

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## HKEX News API – Announcements, Director Dealings & CCASS Shareholding

**Three Hong Kong Exchange data sets as JSON rows: HKEXnews company announcements, director and substantial-shareholder dealings, and CCASS shareholding by participant.** Announcements come from the [HKEXnews title search](https://www1.hkexnews.hk/search/titlesearch.xhtml?lang=en) with stock codes, headline category, release time and the document link. Dealings are the [disclosure-of-interests notices](https://www2.hkexnews.hk/Shareholding-Disclosures/Disclosure-of-Interests?sc_lang=en): who, how many shares bought or sold, the average price, the holding and percent afterwards. CCASS rows say which broker or custodian holds how many shares of a stock on a given day, from the [CCASS shareholding search](https://www3.hkexnews.hk/sdw/search/searchsdw.aspx).

It is for people who follow Hong Kong listed companies and want rows instead of web pages: research desks, quant and event-driven funds, fintech dashboards, alert and newsletter builders, and AI agents. Announcement and dealing rows cost $0.003 each, CCASS rows $0.001 each. No start fee, no monthly fee, and with `onlyNew` a row is delivered and charged once.

| You are building | Input | Rows (measured 16 Nov 2026) | Cost |
|---|---|---|---|
| A sample of the **newest HKEXnews announcements** | `{}` | 50 | $0.15 |
| A **watchlist** feed: announcements and dealings of 3 stocks, 30 days | `stockCodes`, both reports | 55 + 5 | $0.18 |
| **Every announcement of a trading day** | one day, `maxItems: 0` | 687 on Friday 13 Nov | $2.06 |
| A **profit-warning** scanner, last 90 days | `headlineCategories: ["Profit Warning"]` | 418 | $1.25 |
| A **director dealings** tracker, whole market | `reports: ["directorDealings"]` | 48 notices for event day 13 Nov, 626 for 9-13 Nov | $0.14 a day, $1.88 a week |
| **CCASS top 50 holders** of 2 stocks | `reports: ["ccassHoldings"]` | 102 | $0.10 |
| **Every CCASS participant** of one large stock, with the change over a week | `topParticipants: 0`, `compareDays: 7` | 417 | $0.42 |

```bash
curl -X POST "https://api.apify.com/v2/acts/data_daemon~hkex-news-filings/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" \
  -d '{"reports": ["announcements", "directorDealings"], "stockCodes": ["00700", "00005", "09988"], "daysBack": 7, "onlyNew": true, "stateName": "hk-watchlist", "maxItems": 0}'
```

**What it is and what it is not.** It is a polled reading of public HKEX pages, made live on every run: an announcement reaches you on the first run after HKEXnews lists it, with the release time on the row. It is not a push stream, not a market-data feed (no prices or turnover) and not an exchange-licensed product. Documents are linked, not downloaded.

Measured on 16 November 2026: HKEXnews listed **3,283 entries for the trading week 9-13 November** (687 on Friday the 13th, of which 302 in the category Announcements and Notices; the rest are next-day disclosure returns, fund trading information, structured-product notices, circulars and monthly returns). The disclosure-of-interests search held **626 notices for the event days 9-13 November**. CCASS listed **416 participants for Tencent (00700)** on 13 November and 413 for HSBC (00005) on 14 November.

### HKEX announcements API: what common jobs cost

Prices at the listed $0.003 per announcement or dealing row and $0.001 per CCASS row (Apify Free and Starter plans; higher plans pay 15-30% less). Every row count comes from a run or a direct count made on 16 November 2026.

**Sample** (the default input; also what **Try for free** runs): the 50 newest entries on HKEXnews, one request, about 5 seconds, $0.15.

```json
{}
```

**Daily announcements feed** for a watchlist (save as a task and schedule it; `onlyNew` skips what an earlier run delivered, so the 7-day window never double-charges):

```json
{"stockCodes": ["00700", "00005", "09988"], "daysBack": 7, "onlyNew": true, "stateName": "hk-watchlist", "maxItems": 0}
```

**Company announcements only**, whole market, one week (1,256 rows for 9-13 November, $3.77). The category is filtered by HKEXnews itself, so fund and structured-product entries are never read or charged:

```json
{"headlineCategories": ["Announcements and Notices"], "fromDate": "2026-11-09", "toDate": "2026-11-13", "maxItems": 0}
```

**One kind of announcement over months** (418 profit warnings from 18 August to 16 November 2026, $1.25, one request):

```json
{"headlineCategories": ["Profit Warning"], "daysBack": 90, "maxItems": 0}
```

### Hong Kong director dealings API: disclosure of interests as JSON

`reports: ["directorDealings"]` returns **one row per notice** that directors, chief executives and substantial shareholders (5% or more) file under Part XV of the Securities and Futures Ordinance: the listed corporation, the person or entity, the reason code with HKEX's wording, the number of shares bought, sold or involved, the average price and currency, and the long position, short position and lending pool afterwards with their percent of the issued shares. This is the Hong Kong counterpart of an insider-trading feed.

- Without `stockCodes` the whole market is read by event date, one day per request, newest day first.
- With `stockCodes` each company's notices are read for the whole date range, and every row carries the stock code.
- `includeDetails: true` opens each notice and adds the stock code, the share class, the issued shares, the holding **before** the event, the change, the capacity and the highest price. It is off by default because it is one more request per notice (30 notices took 94 seconds in our run).

A notice can be filed some days after its event (13 November had 48 notices by the 16th; 12 November had 75), so a daily feed should look back a week with `onlyNew` on:

```json
{"reports": ["directorDealings"], "daysBack": 7, "onlyNew": true, "stateName": "hk-dealings", "maxItems": 0}
```

A dealing row (with `includeDetails`):

```json
{
    "reportType": "directorDealings",
    "id": "DA20261116E00190",
    "formSerial": "DA20261116E00190",
    "form": "3A",
    "noticeType": "director",
    "role": "director or chief executive",
    "stockCode": "00148",
    "company": "Kingboard Holdings Ltd.",
    "holderName": "Cheung Kwok Wing",
    "eventDate": "2026-11-13",
    "filingDate": "2026-11-16",
    "position": "long",
    "reasonCode": "1101",
    "reasonText": "you purchased the shares",
    "transactionType": "increase",
    "sharesInvolved": 20000,
    "averagePrice": 38.75,
    "currency": "HKD",
    "sharesAfter": 4086305,
    "percentAfter": 0.36,
    "subject": "listedCorporation",
    "detailUrl": "https://di.hkex.com.hk/di/NSForm3A.aspx?fn=DA20261116E00190&lang=EN",
    "exchange": "HKEX",
    "scrapedAt": "2026-11-16T12:12:03.557Z",
    "classOfShares": "Ordinary Shares",
    "issuedSharesInClass": 1121781736,
    "awareDate": "2026-11-13",
    "sharesBefore": 4066305,
    "percentBefore": 0.36,
    "sharesChange": 20000,
    "percentChange": 0,
    "capacityCode": "2101",
    "capacity": "Beneficial owner",
    "transactionCurrency": "HKD",
    "highestPrice": 38.76,
    "tradeVenue": "onExchange"
}
```

### CCASS shareholding API: who holds a Hong Kong stock, by participant

`reports: ["ccassHoldings"]` returns the holdings in CCASS, Hong Kong's central clearing and settlement system, for each stock in `stockCodes` on one day: **one row per participant** (a broker, a custodian bank or a clearing house such as the Stock Connect account) with its participant ID, name, shares held, percent of the issued shares and rank, plus **one summary row** per stock with the totals (shares in CCASS, number of participants, market intermediaries, investor participants, issued shares).

- `topParticipants` keeps the largest N holders of each stock (default 50); `0` returns all of them (416 for Tencent).
- `minPercent` keeps holders at or above a percent of the issued shares.
- `compareDays` adds the holding N days earlier and the change in shares, so the rows show who added and who reduced.
- `holdingDate` picks the day; empty means the latest day CCASS serves (the day before today). CCASS serves the past 12 months.

CCASS is searched one stock at a time and answers in 8-10 seconds: one stock took 24 seconds and two stocks 48 seconds in our runs, so allow about six minutes for a watchlist of 20 stocks (an estimate from those two runs).

```json
{"reports": ["ccassHoldings"], "stockCodes": ["00700", "00005"], "topParticipants": 50, "compareDays": 7}
```

A participant row and the summary row:

```json
{
    "reportType": "ccassHoldings",
    "stockCode": "00700",
    "stockName": "TENCENT HOLDINGS LIMITED -HKD TRADED SHARES",
    "holdingDate": "2026-11-13",
    "rowType": "participant",
    "id": "00700-2026-11-13-C00019",
    "rank": 1,
    "participantId": "C00019",
    "participantName": "THE HONGKONG AND SHANGHAI BANKING",
    "shares": 2940565952,
    "percentOfIssued": 32.34,
    "previousHoldingDate": "2026-11-06",
    "previousShares": 2925115153,
    "sharesChange": 15450799,
    "percentOfIssuedChange": 0.17,
    "exchange": "HKEX"
}
```

```json
{
    "reportType": "ccassHoldings",
    "stockCode": "00700",
    "stockName": "TENCENT HOLDINGS LIMITED -HKD TRADED SHARES",
    "holdingDate": "2026-11-13",
    "rowType": "summary",
    "id": "00700-2026-11-13-summary",
    "issuedShares": 9092644829,
    "sharesInCcass": 7058651174,
    "percentInCcass": 77.62,
    "participantCount": 830,
    "intermediaryShares": 7054274210,
    "intermediaryPercent": 77.58,
    "intermediaryCount": 416,
    "consentingInvestorShares": 22400,
    "consentingInvestorPercent": 0,
    "consentingInvestorCount": 6,
    "nonConsentingInvestorShares": 4354564,
    "nonConsentingInvestorPercent": 0.04,
    "nonConsentingInvestorCount": 408,
    "participantsListed": 416,
    "previousHoldingDate": "2026-11-06",
    "previousSharesInCcass": 7058530444,
    "sharesInCcassChange": 120730,
    "exchange": "HKEX"
}
```

### What does the HKEX news API return?

Three reports, chosen with `reports`. Each row carries its `reportType`.

| Report | What it is | Window | Price per row |
|---|---|---|---|
| `announcements` (default) | Every entry of the HKEXnews title search: announcements and notices, circulars, financial statements, next-day disclosure returns, monthly returns, listing documents, fund and structured-product notices. Stock codes, short names, title, headline category and subcategories, release time, file type and size, document link. | last `daysBack` days, newest first | $0.003 |
| `directorDealings` | Disclosure-of-interests notices: forms 1 and 2 (substantial shareholders), 3A (directors and chief executives), and the directors' notices on associated corporations and debentures (3B to 3D, names and dates only). | last `daysBack` days by event date, newest first | $0.003 |
| `ccassHoldings` | CCASS holdings per participant and a summary row, for each stock code, on one day. | `holdingDate` | $0.001 |

`fromDate` and `toDate` replace `daysBack` for announcements and dealings.

### Why use this instead of the HKEX websites

- **Rows, not pages.** The three sources are a search form, a set of paged tables and a form that posts back. This Actor returns them as JSON with ISO dates in Hong Kong time, numbers as numbers, stock codes with leading zeros and stable field names.
- **A feed that delivers each row once.** With `onlyNew` the Actor remembers what it delivered. Schedule it with `daysBack: 7`: a notice filed days after its event is still picked up, and nothing is delivered or charged twice.
- **Filter before you pay.** `stockCodes`, `headlineCategories` and `keywords` are applied before rows are saved. Exact category names are filtered at the source, so a year of one category is a small run.
- **A whole day, complete.** A busy day is read in one request and the row count is checked against the total HKEXnews reports (687 of 687 on 13 November 2026).
- **Dealings you can sort.** `(L)`, `(S)` and `(P)` become long, short and lending-pool fields; reason codes come with HKEX's wording and a plain `transactionType` (increase, decrease, short increase ...).
- **CCASS changes in one call.** `compareDays` puts today's and the earlier holding on the same row.

### How to use it

1. Click **Try for free**. The default input returns the 50 newest HKEXnews entries (about $0.15).
2. Pick the **Reports**. Add **Stock codes** to follow specific companies (`00700`, `700` and `0700.HK` all work); CCASS needs them.
3. Narrow announcements with **Headline categories** (`Announcements and Notices`, `Final Results`, `Profit Warning`, `Inside Information`) or **Keywords** in the title.
4. Choose the dates with **Days back** or **From date** / **To date**. Set **Maximum rows per report** to `0` for everything.
5. For a daily feed, schedule the run with **Only new rows** on. The first run delivers the window, later runs only what is new.

### Input

| Field | Type | Default | What it does |
|---|---|---|---|
| `reports` | array | `["announcements"]` | `announcements`, `directorDealings`, `ccassHoldings`. |
| `stockCodes` | array | all | HKEX stock codes, with or without leading zeros; `0700.HK`, `HKEX:700` and HKEXnews short names work too. Required for `ccassHoldings`. |
| `headlineCategories` | array | all | Announcements: HKEX headline categories or subcategories. Exact names are filtered at the source; other text is matched as words in the category. |
| `keywords` | array | none | Words to find in the title, stock name and category (announcements), company, holder and reason (dealings) or participant (CCASS). |
| `daysBack` | integer | 7 | Days before today (Hong Kong time), today included. |
| `fromDate`, `toDate` | date | – | A date range instead of `daysBack` (YYYY-MM-DD). |
| `language` | string | `en` | Announcements: `en`, `zh` or `both`. The Chinese version of a document is a separate entry with its own id. |
| `includeDetails` | boolean | false | Dealings: open each notice for the stock code, share class, holding before the event, capacity and highest price. One more request per notice. |
| `holdingDate` | date | latest | CCASS: the day to read. |
| `topParticipants` | integer | 50 | CCASS: largest N participants per stock; `0` = all. |
| `minPercent` | number (as text) | 0 | CCASS: keep participants at or above this percent of the issued shares. |
| `compareDays` | integer | 0 | CCASS: also read N days earlier and add the change. One more request per stock. |
| `maxItems` | integer | 50 | Rows per report for announcements and dealings, newest first; `0` = no limit. CCASS is limited by `topParticipants`. |
| `onlyNew` | boolean | false | Deliver only rows that an earlier run with the same `stateName` did not deliver. |
| `stateName` | string | `default` | Name of the only-new memory; one per feed. |
| `proxyConfiguration` | object | none | Optional; the sources answer Apify datacenter addresses without a proxy. |

Input mistakes do not fail a run: an unknown stock code, a date that cannot be read or a report without its required stock codes is skipped and named in the run's status message.

### Output

An announcement:

```json
{
    "reportType": "announcements",
    "id": "12412800",
    "stockCode": "01897",
    "stockName": "MILLIONHOPE IND",
    "stockCodes": [
        "01897"
    ],
    "stockNames": [
        "MILLIONHOPE IND"
    ],
    "title": "Announcement of Interim Results for the Six Months Ended 30 September 2026",
    "headlineCategory": "Announcements and Notices",
    "subcategories": [
        "Interim Results",
        "Dividend or Distribution",
        "Closure of Books or Change of Book Closure Period"
    ],
    "category": "Announcements and Notices - [Interim Results / Dividend or Distribution / Closure of Books or Change of Book Closure Period]",
    "language": "en",
    "board": "Main Board",
    "fileType": "PDF",
    "fileSize": "207KB",
    "fileSizeKb": 207,
    "documentUrl": "https://www1.hkexnews.hk/listedco/listconews/sehk/2026/1113/2026111301278.pdf",
    "date": "2026-11-13",
    "publishedAt": "2026-11-13T20:41:00+08:00",
    "exchange": "HKEX",
    "source": "Hong Kong Exchanges and Clearing (hkexnews.hk, di.hkex.com.hk)",
    "scrapedAt": "2026-11-16T12:16:30.878Z"
}
```

You can download the dataset as JSON, CSV, Excel, XML or HTML, or read it through the Apify API.

#### Announcement fields

| Field | Meaning | Filled (687 rows, 13 Nov 2026) |
|---|---|---|
| `id` | HKEXnews' id of the entry | 100% |
| `stockCode`, `stockName` | First stock of the entry | 96% (issuer notices on structured products carry no stock) |
| `stockCodes`, `stockNames` | Every stock the entry is filed under (HKD and RMB counters, several funds) | 96% |
| `title` | Document title | 100% |
| `headlineCategory` | Tier-one headline category | 100% |
| `subcategories` | Headline subcategories | 74% (some categories have none) |
| `category` | The category text as printed | 100% |
| `status` | Headlines Revised, Cancelled and Reissued ... | under 1% |
| `language` | `en` or `zh` | 100% |
| `board` | Main Board or GEM | 100% |
| `fileType`, `fileSize`, `fileSizeKb` | PDF, XLSX, HTM; size | 100% |
| `documentUrl` | Link to the document | 100% |
| `date`, `publishedAt` | Release day and time, Hong Kong (+08:00) | 100% |

#### Dealing fields

| Field | Meaning | Filled (48 rows, event day 13 Nov 2026) |
|---|---|---|
| `formSerial`, `form` | Serial number and form (1, 2, 3A, 3B ...) | 100% |
| `noticeType`, `role` | Director, individual or corporate substantial shareholder | 100% |
| `company`, `holderName` | Listed corporation and the person or entity | 100% |
| `stockCode` | Stock code | with `stockCodes` or `includeDetails` |
| `eventDate`, `filingDate` | Day of the event and day of filing | 100% |
| `position` | long, short or lendingPool | 90% (forms 3B to 3D carry no figures) |
| `reasonCode`, `reasonText`, `transactionType` | HKEX's code, its wording and the kind of change | 90% |
| `sharesInvolved` | Shares bought, sold or involved | 77% |
| `averagePrice`, `currency` | Average price per share | 60% (not every event has a price) |
| `sharesAfter`, `percentAfter` | Long position after the event | 90% |
| `shortSharesAfter`, `lendingPoolSharesAfter` and their percents | Other positions after the event | when held (4%) |
| `events` | All event lines when a notice has more than one | when present |
| `subject` | listedCorporation, associatedCorporation or debentures | 100% |
| `detailUrl` | Link to the notice | 100% |
| `classOfShares`, `issuedSharesInClass`, `sharesBefore`, `percentBefore`, `sharesChange`, `percentChange`, `capacity`, `highestPrice`, `averageConsideration`, `tradeVenue`, `awareDate` | From the notice page | with `includeDetails`: 100% for holdings on forms 1, 2 and 3A |

#### CCASS fields

| Field | Meaning |
|---|---|
| `stockCode`, `stockName`, `holdingDate` | The stock and the day the holdings are for |
| `rowType` | `participant` or `summary` |
| `rank`, `participantId`, `participantName` | The participant and its rank by shares held |
| `shares`, `percentOfIssued` | Holding and percent of the issued shares |
| `previousHoldingDate`, `previousShares`, `sharesChange`, `percentOfIssuedChange` | With `compareDays` |
| `issuedShares`, `sharesInCcass`, `percentInCcass`, `participantCount` | Summary row: totals |
| `intermediaryShares`, `intermediaryCount`, `consentingInvestorShares`, `nonConsentingInvestorShares` and their counts and percents | Summary row: by participant group |

All CCASS fields were filled on every row of the 417-row Tencent run of 16 November 2026.

### How much does it cost to get HKEX announcements, dealings and CCASS data?

$0.003 per announcement or dealing row and $0.001 per CCASS row. There is no start fee and no monthly fee, and a run that finds nothing new costs nothing.

- The default run (50 newest announcements): $0.15.
- A watchlist of 3 stocks, announcements and dealings for 30 days (55 + 5 rows on 16 November 2026): $0.18.
- Every HKEXnews entry of a trading day (687 on 13 November 2026): $2.06. Company announcements only (302 that day): $0.91.
- Every disclosure-of-interests notice of a week (626 for 9-13 November 2026): $1.88.
- CCASS top 50 holders of 20 stocks, one day (1,020 rows): $1.02.
- Every CCASS participant of one large stock (417 rows for Tencent): $0.42.

Set a maximum cost per run in the run options and the Actor stops cleanly at that amount.

### Tips

- **Daily announcements feed:** `daysBack: 2`, `onlyNew: true`, `maxItems: 0`, scheduled once or several times a day.
- **Company news without fund and warrant notices:** `headlineCategories: ["Announcements and Notices"]`. Over a week that is 1,256 rows instead of 3,283.
- **Dealings feed:** `daysBack: 7` with `onlyNew`, because notices arrive for some days after the event.
- **Stock code on every dealing row:** use `stockCodes`, or `includeDetails` for whole-market runs.
- **CCASS for a watchlist every day:** `onlyNew: true` delivers each day's holdings once; `compareDays: 1` adds the day-on-day change.
- **One feed per use:** give each schedule its own `stateName`.
- **Long histories:** with `stockCodes` or an exact category name the search is filtered at the source and a year is a few requests. A whole-market history without a category is about 3,300 rows a week.
- **Time zone:** every date and `daysBack` is Hong Kong time.

### FAQ

##### Is there an HKEX API for announcements?

HKEX publishes announcements on the HKEXnews website, and we know of no free public developer API for the announcement list. This Actor reads the public HKEXnews title search on every run and returns the entries as JSON through the Apify API, so you can call it like an API: one HTTP request, rows back.

##### What is CCASS shareholding data?

CCASS is the Central Clearing and Settlement System of Hong Kong. Most shares of listed companies are held in it through participants: brokers, custodian banks and clearing houses, including the accounts that hold mainland investors' shares under Stock Connect. HKEX publishes, for each stock and day, how many shares every participant holds. Movements between participants are widely used to follow where a stock is being accumulated or moved before placements, takeovers and index changes.

##### How do I get insider trading data for Hong Kong stocks?

Hong Kong calls it disclosure of interests. Directors and chief executives report every change in their holding, and holders of 5% or more report when they cross a percentage level. Use `reports: ["directorDealings"]`; `transactionType` says whether the holding went up or down, and `reasonText` says why.

##### Is the feed real time?

It is as fast as your schedule. Each run reads HKEX at that moment, and announcement rows carry HKEXnews' release time in `publishedAt`. CCASS holdings are end-of-day figures and the latest day served is the day before today.

##### How far back does it go?

Announcements: we read two years of one stock in a single request (349 entries for Tencent from November 2024); HKEXnews' category search starts in June 2007. Dealings: the search covers notices filed since 3 July 2017. CCASS: the past 12 months.

##### Why does a dealing row have no stock code?

The market-wide list of notices names the company but not its code. Rows read with `stockCodes` carry the code, and `includeDetails` adds it from the notice itself.

##### Why does the CCASS summary count more participants than there are rows?

The rows are participants with a participant ID: brokers, custodians and clearing houses. Investor participants are counted in the summary row; the individuals among them who agreed to disclosure are not listed as rows.

##### Does it download the PDF documents?

No. Each announcement row has `documentUrl`; fetch the documents you need.

##### Can I get the Chinese titles?

Yes: `language: "zh"` returns the Chinese entries, `both` returns both. The two versions of a document have different ids on HKEXnews, so they are separate rows.

##### What happens when HKEX is slow or a page fails?

Requests are made one at a time, about two a second at most, and retried with a pause. If a source keeps failing, the rows already read are saved and the status message says what is missing. Near the run's timeout the Actor stops cleanly and keeps what it has.

##### What is not included?

Prices and turnover, the text inside the documents, short-selling and Stock Connect turnover statistics, and CCASS history older than 12 months. The free text of a notice (supplementary information) and addresses are not delivered.

Questions or a field you need: open an issue on the **Issues** tab.

### Changelog

- **16 November 2026 (0.1).** First release: announcements, director and shareholder dealings, CCASS holdings, `onlyNew` feeds.

### Related Actors by Daemon Data

- [NSE Corporate Announcements API](https://apify.com/data_daemon/nse-corporate-announcements) – NSE India filings, corporate actions, deals, insider trading and quarterly results
- [BSE Corporate Announcements API](https://apify.com/data_daemon/bse-corporate-announcements) – BSE India filings, corporate actions, board meetings, bulk and block deals
- [India IPO Tracker API](https://apify.com/data_daemon/india-ipo-tracker) – live GMP, subscription status, IPO calendar and listing performance
- [Saudi Etimad Tenders API](https://apify.com/data_daemon/saudi-etimad-tenders) – Saudi government tenders and awards
- All Actors by [Daemon Data](https://apify.com/data_daemon)

# Actor input Schema

## `reports` (type: `array`):

Which HKEX feeds to read. Each row carries its `reportType`. `announcements` (default): listed-company announcements, circulars, results, next-day disclosure returns and other documents from the HKEXnews title search, with stock codes, headline category and document link (687 entries on Friday 13 November 2026). `directorDealings`: disclosure-of-interests notices filed by directors, chief executives and substantial shareholders (who, shares bought or sold, average price, holding and percent afterwards; 626 notices for the event days 9-13 November 2026). `ccassHoldings`: CCASS participant shareholding of each stock in `stockCodes` on one day (which broker or custodian holds how many shares and what percent of the issued shares; 416 participants for Tencent on 13 November 2026).

## `stockCodes` (type: `array`):

HKEX stock codes to keep, with or without leading zeros: `00700`, `700`, `5`, `09988`. The spellings other tools use (`0700.HK`, `HKEX:700`) and HKEXnews short names (`TENCENT`) work too. Empty = the whole market for announcements and dealings. **Required for `ccassHoldings`**, which is searched one stock at a time. With stock codes, announcements and dealings are read per company, so a year of history for a watchlist is a small run.

## `headlineCategories` (type: `array`):

Keep announcements of these HKEX headline categories. Exact names are filtered by HKEXnews itself, which makes long histories cheap: tier one such as `Announcements and Notices`, `Circulars`, `Financial Statements/ESG Information`, `Next Day Disclosure Returns`, `Monthly Returns`, `Listing Documents`, or a subcategory such as `Final Results`, `Interim Results`, `Profit Warning`, `Inside Information`, `Dividend or Distribution`, `Share Buyback`, `Trading Halt`. Any other text is matched as words in the category of each row. Empty = everything HKEXnews lists, including fund trading information and structured-product notices.

## `keywords` (type: `array`):

Keep rows that contain one of these words (case-insensitive). Announcements: title, stock name and category (`placing`, `privatisation`, `profit warning`). Dealings: company, holder name and reason (`BlackRock`, `purchased`). CCASS: participant name or ID (`HSBC`, `C00019`). Empty = all.

## `daysBack` (type: `integer`):

For announcements and dealings: how many days before today (Hong Kong time) to read, today included. `0` = today only, `7` (default) = today and the seven days before. Ignored when From date is set. Dealings are searched by the date of the event, and a notice can be filed some days after it: read at least 5 days back in a daily feed.

## `fromDate` (type: `string`):

First day (YYYY-MM-DD, Hong Kong time) for announcements and dealings. Use with To date for a backfill; the week of 9-13 November 2026 had 3,283 entries.

## `toDate` (type: `string`):

Last day (YYYY-MM-DD, Hong Kong time). Empty = today.

## `language` (type: `string`):

HKEXnews files the English and the Chinese version of a document as separate entries with their own ids. `en` (default) reads the English entries, `zh` the Chinese ones (titles and categories in Chinese), `both` reads both and marks each row with its `language`.

## `includeDetails` (type: `boolean`):

For `directorDealings`: open the notice page of every delivered row and add the stock code, the share class, the number of issued shares, the holding and percent before the event, the change, the capacity and the highest price. One more request per notice (about three seconds each), so it is off by default. Not needed for the stock code when `stockCodes` is set: those rows carry it already.

## `holdingDate` (type: `string`):

For `ccassHoldings`: the day whose holdings to read (YYYY-MM-DD). Empty = the latest day CCASS serves (the day before today). CCASS serves the past 12 months; for a Sunday or public holiday it answers with the day before, and the rows say which day they are.

## `topParticipants` (type: `integer`):

For `ccassHoldings`: keep the largest N participants of each stock, by shares held. Default 50. `0` = every participant (416 rows for Tencent on 13 November 2026). Each stock also returns one summary row with the totals.

## `minPercent` (type: `string`):

For `ccassHoldings`: keep participants that hold at least this percent of the issued shares, for example `1` or `0.5`. Empty or `0` = no minimum.

## `compareDays` (type: `integer`):

For `ccassHoldings`: also read the holdings N days before the holding date and add `previousShares`, `sharesChange` and `percentOfIssuedChange` to every row (who added, who reduced). One more request per stock. `0` (default) = no comparison.

## `maxItems` (type: `integer`):

Stop announcements and dealings after this many rows each, newest first. `0` = no limit. Each of these rows costs $0.003, so the default 50 rows cost $0.15. CCASS rows are limited by Participants per stock instead.

## `onlyNew` (type: `boolean`):

Remember what was delivered and return only rows that are new since the last run with the same state name. Rows already delivered are skipped and not charged again, so a scheduled run with Days back 7 never misses a late notice and never bills one twice. For CCASS a day's holdings of a stock are delivered once.

## `stateName` (type: `string`):

Name of the only-new memory. Use a different name for each independent feed (for example one per watchlist). Letters, digits, dash and underscore.

## `proxyConfiguration` (type: `object`):

Optional. The HKEX pages answer Apify datacenter addresses without a proxy (checked 16 Nov 2026), so none is used by default.

## Actor input object example

```json
{
  "reports": [
    "announcements"
  ],
  "stockCodes": [],
  "headlineCategories": [],
  "keywords": [],
  "daysBack": 7,
  "language": "en",
  "includeDetails": false,
  "topParticipants": 50,
  "compareDays": 0,
  "maxItems": 50,
  "onlyNew": false,
  "stateName": "default",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

Announcements, disclosure-of-interests notices and CCASS participant holdings as JSON items in the default dataset (also downloadable as CSV, Excel, XML). Each item carries its reportType.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "reports": [
        "announcements"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("data_daemon/hkex-news-filings").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "reports": ["announcements"],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("data_daemon/hkex-news-filings").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 '{
  "reports": [
    "announcements"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call data_daemon/hkex-news-filings --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,data_daemon/hkex-news-filings"
        }
    }
}
```

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 <APIFY_API_TOKEN>` 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/qtn4fSQcCZUvhUjW3/builds/BPVzRZDAKZphd94oM/openapi.json
