Skip to content
IPO Lists

Get Market Home IPO Module

Called when the HK, US, or Discover page of the market home renders the IPO module. Returns the numbers of IPOs open for subscription, in grey market trading, and listed, together with IPO items (name, icon, introduction, stage, labels, subscription deadline or grey market session, price change, and the allotment result of the current client). Tapping an item opens the security details page by counter_id. Also used by the IPO module on the HK and US market home pages.

GEThttps://api.lbkrs.com/v1/newmarket/show_ipo

Parameters

marketstringqueryRequired

Market:

  • HK - HK stocks
  • US - US stocks
  • ALL - All markets (used by the Discover page)

HKUSALL

account_channelstringquery

Broker channel

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get Market Home IPO Module” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
sub_numstring

Number of IPOs open for subscription

mart_numstring

Number of IPOs in grey market trading

ipo_numstring

Number of listed IPOs

itemsarray<object>

IPO items

Child attributes
counter_idstring

Security ID, for example ST/HK/2636. Tapping an item opens the security details page with this ID

namestring

Security name

logostring

Security logo URL

iconstring

Small security icon URL

descstring

One-line company introduction

stateinteger

IPO stage:

  • 1 - Open for subscription
  • 2 - Funds frozen (awaiting allotment results)
  • 3 - Grey market
  • 4 - Listing
Values
1
2
3
4
labelsarray<string>

Label texts

result_datestring

Allotment result announcement date in YYYY.MM.DD format. Shown when state is 2

sub_stateinteger

Subscription result of the current client:

  • 0 - Not subscribed
  • 1 - Not allotted
  • 2 - Allotted
Values
0
1
2
subscription_deadlinestring

Subscription deadline in MM.DD HH:mm format. Shown when state is 1

subscription_remaining_timestring

Seconds remaining until the subscription deadline

mart_stateinteger

Grey market status, used when state is 3:

  • 0 - Not started
  • 1 - Trading
  • 2 - Closed
Values
0
1
2
mart_start_atstring

Grey market start time in HH:mm format

mart_end_atstring

Grey market end time in HH:mm format

chgstring

Price change today as a decimal (for example, 0.05 means +5%). Shown on the listing day (state is 4) or after grey market trading starts (mart_state greater than 0)

Whale Docs