{ "openapi": "3.0.1", "info": { "title": "HKEX IPO Calendar — Hong Kong New Listings Tracker", "description": "Track upcoming and recent Hong Kong IPOs from HKEX. Get listing dates, offer prices, sponsors, sectors — straight from the source. Useful for investors, IPO traders, allocators, journalists.", "version": "0.0", "x-build-id": "XLc275W8WtmF31ge5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~hkex-ipo-calendar/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-hkex-ipo-calendar", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/nexgendata~hkex-ipo-calendar/runs": { "post": { "operationId": "runs-sync-nexgendata-hkex-ipo-calendar", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/nexgendata~hkex-ipo-calendar/run-sync": { "post": { "operationId": "run-sync-nexgendata-hkex-ipo-calendar", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Calendar mode", "enum": [ "upcoming", "recent", "both" ], "type": "string", "description": "Which slice of the Hong Kong Stock Exchange (HKEX) IPO universe to return. 'upcoming' = announced prospectuses filed with the HKEX listing committee but not yet listed (forward calendar — typically 10-30 active book-builds at any time, including A+H secondaries by mainland China issuers and Chapter 18C Specialist Technology Companies regime listings). 'recent' = past N days of completed IPOs (priced + first-day-of-trading deals) with first-day pop and current return. 'both' (default) = upcoming + recent in one pull, sorted with Upcoming first then most-recent listings.", "default": "both" }, "lookbackDays": { "title": "Lookback window (days)", "minimum": 1, "maximum": 1825, "type": "integer", "description": "How many days of completed HKEX IPOs to include when mode is 'recent' or 'both'. Default 30 days returns the most-recent month of pricing activity — typically 3-8 deals on Main Board plus 1-3 GEM listings in an active month. HKEX prices roughly 60-100 IPOs/year across Main Board + GEM; 90 days (~quarter) is the practical upper bound for institutional desk dashboards. Set higher (e.g. 365) for full-year vintage studies, post-IPO return cohort analysis or sponsor / underwriter league-table research.", "default": 30 }, "lookaheadDays": { "title": "Lookahead window (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "How many days of forward HKEX IPO calendar to include when mode is 'upcoming' or 'both'. Default 30 days returns the active book-build pipeline (deals with prospectuses live on the HKEX listing-committee hearing schedule). 60-90 days extends to the medium-term pipeline (deals with PHIP / Post-Hearing Information Pack filed but listing date not yet fixed). 180+ days surfaces the soft pipeline (rumored / sponsor-mandated but not yet PHIP-filed). HKEX has been the world's #1 IPO venue by proceeds in 5 of the last 15 years.", "default": 30 }, "listingBoard": { "title": "Listing board", "enum": [ "all", "Main Board", "GEM" ], "type": "string", "description": "Filter by HKEX board. 'Main Board' = senior board with quantitative entry tests (HK$50M profit test, HK$500M market-cap-revenue test, or HK$4bn market-cap-revenue-cashflow test); home to all the China large-cap A+H secondaries, BABA-class weighted-voting-rights listings (Chapter 8A), and Chapter 18A pre-revenue biotech listings. 'GEM' = growth-board (Growth Enterprise Market) — relaunched 2024 with revised rules; targets SMEs. 'all' returns both boards.", "default": "all" }, "sector": { "title": "GICS-style sector filter", "enum": [ "all", "Technology", "Healthcare", "Financials", "Consumer Discretionary", "Consumer Staples", "Industrials", "Energy", "Real Estate", "Materials", "Communication Services", "Utilities" ], "type": "string", "description": "Filter by sector classification. HKEX IPO sector mix has shifted dramatically since 2018: pre-2018 it was Financials (Chinese bank A+H, insurance), 2018-2021 was Technology (BABA, Meituan, JD.com secondaries, NetEase secondary, Bilibili), 2022-2024 was Healthcare (Chapter 18A pre-revenue biotech wave — InnoCare, Cansino, Innovent), 2024-2026 is Consumer Discretionary (HK consumer brand re-listings — Mixue Bingcheng, Chabaidao, Bawang Chaji, Laopu Gold) and a new Specialist Technology Companies (Chapter 18C) AI/semiconductor wave (Black Sesame, WeRide aspirations). 'all' = no filter.", "default": "all" }, "minProceedsHkdMillion": { "title": "Minimum gross proceeds (HKD millions)", "minimum": 0, "maximum": 100000, "type": "number", "description": "Lower bound on gross IPO proceeds in HKD millions. Use to filter out micro-cap GEM offerings. Typical thresholds: '50' = small Main Board, '500' = sizeable Main Board, '1000' = institutional-grade (HK$1bn+), '5000' = mega-deal (Midea Group HK$31bn, Mixue Bingcheng HK$3.4bn, S.F. Holding HK$5.7bn, Horizon Robotics HK$5.4bn class). Leave 0 for no lower bound. 1 HKD ≈ 0.128 USD.", "default": 0 }, "limit": { "title": "Max IPO records returned", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on total HKEX IPO records returned (1-200). Each IPO is one dataset row. Premium pricing applies per row — HKEX IPO data is institutional intel (Bloomberg HK IPO / Refinitiv / Renaissance Capital equivalents cost USD 2,000+/seat/month). HKEX prices ~30-100 IPOs/year so most useful runs are limit=20-100. Records are sorted Upcoming-first by listing date ascending, then completed-IPOs by ipo_date descending.", "default": 25 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }