Skip to content
Longport WhaleLongport Whale
Markets

Get HK IPOs Open for Subscription

Used by the "Subscribing" tab of the IPO center. Returns the list of HK IPOs currently open for subscription (in the offer period), including the offer price, minimum subscription amount for one board lot, estimated subscription multiple, subscription deadline, financing tags, subscription method, and the current user's subscription order and watchlist status. The list length is also displayed as the subscribing count on the tab.

GEThttps://api.lbkrs.com/v1/newmarket/hk/ipo/subscribing

Parameters

member_idintegerquery

User id of the currently logged-in user, used to return personalized information for that user such as the subscription order number and watchlist status; if omitted, no error is returned

account_channelstringquery

Broker channel

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get HK IPOs open for subscription” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
listarray<object>

List of IPOs open for subscription

Child attributes
counter_idstring

Stock id, such as ST/HK/2636

codestring

Stock code

namestring

Stock name

iconstring

Stock icon URL

descriptionstring

Company profile

stock_descstring

IPO highlight text; displayed on the card when present

security_typestring

Security type, such as ST (stock) or ETF; only the issue price is displayed for ETFs

currencystring

Currency, such as HKD

issue_pricestring

Offer price (issue price for ETFs)

entrance_feestring

Minimum subscription amount for one board lot

financing_entrance_feestring

Minimum subscription amount for one board lot with financed subscription

min_sub_numinteger

Minimum subscription quantity; displayed for international placing

rate_forcaststring

Estimated subscription multiple; displayed as "Undersubscribed" when less than 1

share_plannedstring

Planned number of shares to issue

proceeds_plannedstring

Planned fundraising amount

sub_applystring

Subscription application volume

sub_multiplestring

Subscription multiple

margin_substring

Financed subscription amount

margin_multiplestring

Financed subscription multiple

tagsarray<string>

List of financing tag texts, such as "Bank financing rate 0%" and "Up to 10x leverage"

sub_end_datestring

Subscription deadline date (display string)

sub_deadlinestring

Subscription deadline timestamp (int64 returned as a string); the card displays it as YYYY.MM.DD HH:mm:ss

remaining_dayinteger

Number of days remaining until the subscription deadline

remaining_secondstring

Number of seconds remaining until the subscription deadline (int64 returned as a string); used for the countdown display when less than 1 day remains

cut_off_noticestring

Subscription deadline notice text; when empty, the Broker App uses the default text

can_subscribeinteger

Whether subscription is available:

  • 0: Not available for subscription
  • 1: Available for subscription
Values
0
1
beginboolean

Whether subscription has started; when subscription is available but has not started, a disabled "Pending subscription" button is displayed

stateinteger

IPO status:

  • 0: Normal
  • 1: Listing postponed
  • 2: Listing canceled
Values
0
1
2
state_stageinteger

Stage at which an exception such as postponement or cancellation occurred

final_stateinteger

Final status

sortstring

Sort weight (int64 returned as a string); a value greater than 0 means the item is pinned to the top and shows the "Hot" tag

sub_methodstring

Subscription method for the security:

  • Normal: Public offering
  • International: International placing
Values
Normal
International
order_methodstring

Subscription method of the current user's existing subscription order, with the same values as sub_method; when it matches sub_method, the "Subscribed" badge is displayed

order_idstring

Subscription order number of the current user (int64 returned as a string); "0" means not subscribed

additional_subscribeboolean

Whether this is an additional subscription

watchedboolean

Whether the current user is watching this stock

declarationstring

Subscription declaration text; when present, the user must confirm it before subscribing

Whale Docs