HKEX News API – Announcements, Director Dealings & CCASS avatar

HKEX News API – Announcements, Director Dealings & CCASS

Pricing

from $2.10 / 1,000 announcement or dealing rows

Go to Apify Store
HKEX News API – Announcements, Director Dealings & CCASS

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

Daemon Data

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

19 hours ago

Last modified

Features

Limited permissions

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 buildingInputRows (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 daysstockCodes, both reports55 + 5$0.18
Every announcement of a trading dayone day, maxItems: 0687 on Friday 13 Nov$2.06
A profit-warning scanner, last 90 daysheadlineCategories: ["Profit Warning"]418$1.25
A director dealings tracker, whole marketreports: ["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 stocksreports: ["ccassHoldings"]102$0.10
Every CCASS participant of one large stock, with the change over a weektopParticipants: 0, compareDays: 7417$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 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:

{"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).

  • 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).

{"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.

ReportWhat it isWindowPrice 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
directorDealingsDisclosure-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
ccassHoldingsCCASS 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

FieldTypeDefaultWhat it does
reportsarray["announcements"]announcements, directorDealings, ccassHoldings.
stockCodesarrayallHKEX stock codes, with or without leading zeros; 0700.HK, HKEX:700 and HKEXnews short names work too. Required for ccassHoldings.
headlineCategoriesarrayallAnnouncements: HKEX headline categories or subcategories. Exact names are filtered at the source; other text is matched as words in the category.
keywordsarraynoneWords to find in the title, stock name and category (announcements), company, holder and reason (dealings) or participant (CCASS).
daysBackinteger7Days before today (Hong Kong time), today included.
fromDate, toDatedate–A date range instead of daysBack (YYYY-MM-DD).
languagestringenAnnouncements: en, zh or both. The Chinese version of a document is a separate entry with its own id.
includeDetailsbooleanfalseDealings: open each notice for the stock code, share class, holding before the event, capacity and highest price. One more request per notice.
holdingDatedatelatestCCASS: the day to read.
topParticipantsinteger50CCASS: largest N participants per stock; 0 = all.
minPercentnumber (as text)0CCASS: keep participants at or above this percent of the issued shares.
compareDaysinteger0CCASS: also read N days earlier and add the change. One more request per stock.
maxItemsinteger50Rows per report for announcements and dealings, newest first; 0 = no limit. CCASS is limited by topParticipants.
onlyNewbooleanfalseDeliver only rows that an earlier run with the same stateName did not deliver.
stateNamestringdefaultName of the only-new memory; one per feed.
proxyConfigurationobjectnoneOptional; 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

FieldMeaningFilled (687 rows, 13 Nov 2026)
idHKEXnews' id of the entry100%
stockCode, stockNameFirst stock of the entry96% (issuer notices on structured products carry no stock)
stockCodes, stockNamesEvery stock the entry is filed under (HKD and RMB counters, several funds)96%
titleDocument title100%
headlineCategoryTier-one headline category100%
subcategoriesHeadline subcategories74% (some categories have none)
categoryThe category text as printed100%
statusHeadlines Revised, Cancelled and Reissued ...under 1%
languageen or zh100%
boardMain Board or GEM100%
fileType, fileSize, fileSizeKbPDF, XLSX, HTM; size100%
documentUrlLink to the document100%
date, publishedAtRelease day and time, Hong Kong (+08:00)100%

Dealing fields

FieldMeaningFilled (48 rows, event day 13 Nov 2026)
formSerial, formSerial number and form (1, 2, 3A, 3B ...)100%
noticeType, roleDirector, individual or corporate substantial shareholder100%
company, holderNameListed corporation and the person or entity100%
stockCodeStock codewith stockCodes or includeDetails
eventDate, filingDateDay of the event and day of filing100%
positionlong, short or lendingPool90% (forms 3B to 3D carry no figures)
reasonCode, reasonText, transactionTypeHKEX's code, its wording and the kind of change90%
sharesInvolvedShares bought, sold or involved77%
averagePrice, currencyAverage price per share60% (not every event has a price)
sharesAfter, percentAfterLong position after the event90%
shortSharesAfter, lendingPoolSharesAfter and their percentsOther positions after the eventwhen held (4%)
eventsAll event lines when a notice has more than onewhen present
subjectlistedCorporation, associatedCorporation or debentures100%
detailUrlLink to the notice100%
classOfShares, issuedSharesInClass, sharesBefore, percentBefore, sharesChange, percentChange, capacity, highestPrice, averageConsideration, tradeVenue, awareDateFrom the notice pagewith includeDetails: 100% for holdings on forms 1, 2 and 3A

CCASS fields

FieldMeaning
stockCode, stockName, holdingDateThe stock and the day the holdings are for
rowTypeparticipant or summary
rank, participantId, participantNameThe participant and its rank by shares held
shares, percentOfIssuedHolding and percent of the issued shares
previousHoldingDate, previousShares, sharesChange, percentOfIssuedChangeWith compareDays
issuedShares, sharesInCcass, percentInCcass, participantCountSummary row: totals
intermediaryShares, intermediaryCount, consentingInvestorShares, nonConsentingInvestorShares and their counts and percentsSummary 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.