HKEX Insider & Short Tracker — Live Director Dealings + SFC Shorts

Two of Hong Kong's highest-signal disclosure regimes in one schema, fetched live. HKEX Insider & Short Tracker tracks Hong Kong director and substantial-shareholder dealings (Securities and Futures Ordinance Part XV) and the SFC's weekly aggregated short positions — who bought, who sold, who is short which Main Board name and by how much. There is no curated, cached or pre-built database: every row is parsed from a real HTTP fetch performed during the run and carries the source URL it came from. A type field separates insider rows from short rows so you can screen insider flow and short books side by side.

What it fetches

1. HKEX Disclosure of Interests (DI) daily summaries — disclosureType = insider

Plain-HTML daily summary pages published by HKEX under the Securities and Futures Ordinance (SFO) Part XV:

• Directors' interests in shares of the listed corporation — https://di.hkex.com.hk/di/summary/DSM{YYYYMMDD}C2.htm
• Individual & corporate substantial shareholders (≥5% interests) — https://di.hkex.com.hk/di/summary/DSM{YYYYMMDD}C1.htm

The actor iterates the business days in your date window (most recent first, weekends skipped; days with no published summary simply return nothing) and parses each record into structured fields.

2. SFC weekly Aggregated Reportable Short Positions — disclosureType = short

The official weekly CSV published by the Securities and Futures Commission under the Securities and Futures (Short Position Reporting) Rules (Cap. 571AJ), discovered live from the SFC's listing page: https://www.sfc.hk/en/Regulatory-functions/Market/Short-position-reporting/Aggregated-reportable-short-positions-of-specified-shares

disclosureType = both (the default) fetches both regimes and returns them in one unified schema, distinguished by the type field.

Use cases

• APAC equity research / long-short — screen insider buying/selling and aggregated short positions on HSI heavyweights and A+H names, straight from the official DI and SFC sources.
• Cross-border investors — track substantial-shareholder (≥5%) interest changes to see who is accumulating or trimming HK Main Board names.
• Compliance / surveillance — pattern review across director dealings and short-position disclosures in one feed, with the source URL on every row.
• Offshore-China watcher — monitor insider and short activity in HK-listed Chinese champions via the official Part XV and Cap. 571AJ regimes.

Output schema

Insider rows (type: "insider") — from HKEX DI summaries:

field	meaning
disclosure_regime	director (C2) or substantial_shareholder (C1)
stock_code	4-digit HKEX code (e.g. 0001)
company_name	listed corporation name as printed on the summary
name	director / substantial shareholder name
capacity	Director or Substantial Shareholder
transaction_date	date of the relevant event (ISO-8601)
reason_code	HKEX reason-for-disclosure code
position_type	(L) long / (S) short / (P) lending pool
shares_changed	number of shares bought / sold / involved
average_price	average price per share, if disclosed
present_balance, present_pct	holding after the event
form_serial	HKEX disclosure serial number
source_url	the exact DSM page the row was parsed from

Short rows (type: "short") — from the SFC weekly CSV:

field	meaning
stock_code	4-digit HKEX code
company_name	specified-share name as printed in the CSV
reporting_date	weekly reporting date (ISO-8601)
short_shares	aggregated reportable short position (shares)
short_value_hkd	aggregated reportable short position (HK$)
source_url	the exact SFC CSV file the row was parsed from

Input

input	description
disclosureType	both (default), insider, or short
stockCode	optional comma-separated codes to filter (e.g. 0700,0005); blank = all
startDate / endDate	ISO-8601 date window (defaults: last 14 days)
maxDiDays	cap on business days of DI summaries to fetch (default 10)
minSharesChanged	minimum shares for insider rows (0 = no filter)
limit	max rows pushed to the dataset (1–200)
proxyConfiguration	proxy for outbound requests; RESIDENTIAL + HK egress recommended for the DI portal

FAQ

What two disclosure regimes does it cover? SFO Part XV director and substantial-shareholder dealings (HKEX DI), and the SFC weekly aggregated short-position reports (Cap. 571AJ).

Is the data fetched live or from a database? Live. Every row is parsed from an HTTP fetch performed during the run, from HKEX DI daily summaries and the SFC weekly CSV, and carries the real source_url. There is no hardcoded or curated dataset.

Can I see short positions on a stock? Yes — short rows carry the aggregated reportable short position in shares and HK$ for each specified share, from the official SFC CSV.

How is this like a US Form 4? Similar intent (insider transactions) but Hong Kong adds a 5% substantial-shareholder test and a weekly aggregated short-reporting regime.

Can I filter to one ticker? Yes — stockCode accepts comma-separated 4-digit codes (e.g. 0700,0005).

Why did a run return nothing? HKEX publishes DI summaries on business days only and the SFC file is weekly; a narrow window may map to no published summary. The DI portal can also block datacenter IPs — use the default RESIDENTIAL/HK proxy.

Billing

Pay-per-event. You are charged only per real row pushed to the dataset. If a source is unreachable or returns nothing for your filters, the actor writes a non-billable STATUS record to the key-value store (with source diagnostics) and pushes zero billable rows — it never bills you for fabricated or empty data.

Notes & limitations

• The HKEX DI portal can block datacenter IPs; if a direct run returns nothing for the insider regime, run with the default RESIDENTIAL/HK proxy.
• HKEX publishes DI summaries on business days only; recent days may not yet be available.
• The SFC short-position file is weekly (typically published each Friday with a short reporting lag), so a narrow date window may map to a single weekly file.
• Some DI records describe multiple position lines (long + short) for the same filing; the primary fields (stock_code, company_name, name, transaction_date, shares_changed) are always parsed from the record's leading columns.

Related actors — APAC Disclosure family

• hkex-news-announcements
• apac-disclosure-monitor
• hkex-ipo-calendar
• apac-ipo-calendar-sweep