HKEX News API – Announcements, Director Dealings & CCASS
Pricing
from $2.10 / 1,000 announcement or dealing rows
HKEX News API – Announcements, Director Dealings & CCASS
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.
Pricing
from $2.10 / 1,000 announcement or dealing rows
Rating
0.0
(0)
Developer
Daemon Data
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
19 hours ago
Last modified
Categories
Features
Share
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 with stock codes, headline category, release time and the document link. Dealings are the disclosure-of-interests notices: 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.
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 |
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.
{}
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):
{"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:
{"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):
{"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
stockCodesthe whole market is read by event date, one day per request, newest day first. - With
stockCodeseach company's notices are read for the whole date range, and every row carries the stock code. includeDetails: trueopens 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:
{"reports": ["directorDealings"], "daysBack": 7, "onlyNew": true, "stateName": "hk-dealings", "maxItems": 0}
A dealing row (with includeDetails):
{"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).
topParticipantskeeps the largest N holders of each stock (default 50);0returns all of them (416 for Tencent).minPercentkeeps holders at or above a percent of the issued shares.compareDaysadds the holding N days earlier and the change in shares, so the rows show who added and who reduced.holdingDatepicks 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).
{"reports": ["ccassHoldings"], "stockCodes": ["00700", "00005"], "topParticipants": 50, "compareDays": 7}
A participant row and the summary row:
{"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"}
{"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
onlyNewthe Actor remembers what it delivered. Schedule it withdaysBack: 7: a notice filed days after its event is still picked up, and nothing is delivered or charged twice. - Filter before you pay.
stockCodes,headlineCategoriesandkeywordsare 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 plaintransactionType(increase, decrease, short increase ...). - CCASS changes in one call.
compareDaysputs today's and the earlier holding on the same row.
How to use it
- Click Try for free. The default input returns the 50 newest HKEXnews entries (about $0.15).
- Pick the Reports. Add Stock codes to follow specific companies (
00700,700and0700.HKall work); CCASS needs them. - Narrow announcements with Headline categories (
Announcements and Notices,Final Results,Profit Warning,Inside Information) or Keywords in the title. - Choose the dates with Days back or From date / To date. Set Maximum rows per report to
0for everything. - 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:
{"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: 7withonlyNew, because notices arrive for some days after the event. - Stock code on every dealing row: use
stockCodes, orincludeDetailsfor whole-market runs. - CCASS for a watchlist every day:
onlyNew: truedelivers each day's holdings once;compareDays: 1adds the day-on-day change. - One feed per use: give each schedule its own
stateName. - Long histories: with
stockCodesor 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
daysBackis 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,
onlyNewfeeds.
Related Actors by Daemon Data
- NSE Corporate Announcements API – NSE India filings, corporate actions, deals, insider trading and quarterly results
- BSE Corporate Announcements API – BSE India filings, corporate actions, board meetings, bulk and block deals
- India IPO Tracker API – live GMP, subscription status, IPO calendar and listing performance
- Saudi Etimad Tenders API – Saudi government tenders and awards
- All Actors by Daemon Data