Skip to content
Longport WhaleLongport Whale
Trading

List IPO Subscription Records

Queries the IPO subscription records of the current account with pagination. Records can be filtered by market, subscription status, and subscription month. Returns the stock information, subscribed quantity, order status, allotted quantity, subscription method, financing multiple, whether it is a reserved order, and so on for each subscription. Used to display the subscription record list page (grouped by subscription month).

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

Parameters

pageintegerquery

Page number, starting from 1

limitintegerquery

Number of items per page. Broker App always passes 20

statusintegerquery

Subscription status filter. If omitted or 0, all statuses are returned:

  • 0: All
  • 1: Pending announcement (includes order status 1 pending debit and 3 debited, pending allotment announcement)
  • 2: Debit failed
  • 3: Not allotted
  • 4: Allotted
  • 5: Cancelled
  • 6: Listing withdrawn (subscription cancelled)
  • 7: Valid subscription (includes pending debit, debited, not allotted, and allotted)
  • 8: Rejected

012345678

datestringquery

Subscription month filter, in YYYYMM format (such as 202610). If omitted or 0, all months are returned

marketstringquery

Market filter, such as HK or US. If omitted, all markets are returned

account_channelstringquery

Broker channel

Responses

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

Subscription record list

Child attributes
idstring

Subscription order id, used to query subscription record details and cancel the subscription

namestring

Stock name

codestring

Stock code

counter_idstring

Stock id, such as ST/HK/9988

sub_qtystring

Number of shares subscribed

statusinteger

Order status:

  • 1: Pending deduction (funds frozen)
  • 2: Deduction failed
  • 3: Deducted (allotment results pending)
  • 4: Announced (allotted)
  • 5: Announced (not allotted)
  • 6: Cancelled by user
  • 7: Listing withdrawn (subscription cancelled)
  • 8: Rejected
Values
1
2
3
4
5
6
7
8
created_atstring

Subscription time, timestamp (in seconds)

lot_win_qtystring

Number of shares allotted

currencystring

Subscription currency

ipo_pricestring

Issue price

methodinteger

Subscription method:

  • 1: Financed subscription
  • 2: Cash subscription
  • 3: HK channel financed subscription (bank financing)
  • 4: International placing
  • 5: Zero-principal subscription
  • 6: Dynamic financing
Values
1
2
3
4
5
6
multiplestring

Financing multiple (such as 10 or 20). If greater than 1, the list displays a financing multiple label

markinteger

Order type:

  • 0: Regular order
  • 1: Reservation order
  • 2: International placing order
Values
0
1
2
account_channelstring

Broker channel

has_moreboolean

Whether there is a next page

Whale Docs