Skip to content
Longport WhaleLongport Whale
Trading

Get Active IPO Subscription Order

Used by the IPO details page to query the current user's subscription order for the specified IPO. Returns the subscribed quantity, order status, allotted shares, subscription method, and so on. Used to display the "Subscribed" order status in the timeline module, navigate to the order details, and show the entry for sharing the allotment result after shares are allotted. If there is no order, Broker App displays the subscribe button based on the subscribable status of the timeline instead.

GEThttps://api.lbkrs.com/v1/ipo/active_order

Parameters

counter_idstringqueryRequired

IPO security id, such as ST/HK/1256

account_channelstringquery

Broker channel

flagstringquery

Subscription method, taken from the route parameter when entering the IPO details page:

  • 0: Public offering
  • 2: International placing

02

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get active IPO subscription order” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
ordersarray<object>

Subscription order list. An empty array if there is no order; Broker App displays the first item

Child attributes
idstring

Subscription order id, used to navigate to the subscription order details (int64 returned as a string)

namestring

IPO name

codestring

IPO stock code

counter_idstring

IPO security id

sub_qtystring

Subscribed quantity (shares)

statusinteger

Subscription order status:

  • 1: Pending debit, funds frozen
  • 2: Debit failed
  • 3: Debited, pending allotment announcement
  • 4: Announced, allotted (Broker App displays the allotted shares and the entry for sharing the allotment result)
  • 5: Announced, not allotted
  • 6: Cancelled by the user
  • 7: Listing withdrawn (subscription cancelled)
  • 8: Rejected
Values
1
2
3
4
5
6
7
8
created_atinteger

Subscription submission time, Unix timestamp (in seconds)

lot_win_qtystring

Number of shares allotted

currencystring

Subscription currency

methodinteger

Subscription method:

  • 1: Financed subscription
  • 2: Cash subscription
  • 3: Hong Kong channel financed subscription
  • 4: International placing subscription
  • 5: Zero-principal subscription
Values
1
2
3
4
5
multiplestring

Financing multiple

markinteger

Order flag:

  • 0: Regular subscription
  • 1: Reserved subscription
  • 2: International placing
Values
0
1
2
account_channelstring

Broker channel

ipo_pricestring

Issue price

HTTP 400The service rejected the request because a business rule or input validation failed. Review the business codes and correct the request before retrying.
codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

Whale Docs