Get IPO Subscription Timeline

Queries, for the IPO detail page, the subscription timeline of the specified IPO (milestones such as subscription opens, subscription closes, allotment/placing results announced, grey market trading and listing), the offer price, the subscription deadline and the IPO subscription tags, as well as whether subscription is currently available and whether the subscription start time has been reached. Used to display the timeline module and decide whether to show the subscribe button.

GEThttps://api.lbkrs.com/v1/stock-info/ipo-timeline

Parameters

counter_idstringqueryRequired

IPO security id, for example ST/HK/1256. If omitted, no error is returned, but the timeline is empty

marketstringquery

Market of the security, for example HK or US. Broker App parses it from counter_id and passes it in. If omitted, the result queried by counter_id is unchanged

account_channelstringquery

Broker channel

flagintegerquery

Subscription method, taken from the route parameter used to open the IPO detail page. If omitted, it is treated as public offering:

0: Public offering
2: International placing

02

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get IPO subscription timeline” operation.

Standard response envelopecodemessagedata

dataobjectdata structure

timelinearray<object>

List of subscription timeline milestones in chronological order. If empty, Broker App does not display the timeline module

Child attributes

namestring

Milestone name, for example "Subscription opens", "Subscription closes", "Allotment/placing results announced", "Grey market trading" or "Listing"

lightboolean

Whether the milestone is highlighted (the milestone has been reached)

timestring

Display time of the milestone. The date and time of day are separated by a newline \n, for example "09.28\n09:00"

descstring

Exception note for the milestone; an empty string when normal. If present, Broker App displays this text instead of time

can_subscribeboolean

Whether subscription is currently available (whether subscription is enabled in the back office). The subscribe button is shown when this is true and the user has no subscription order

pay_end_datestring

Subscription deadline in the format yyyy.MM.dd HH:mm, for example "2026.10.06 09:00". An empty string when no data is available

beginboolean

Whether the subscription start time has been reached

tagsarray<string>

IPO subscription tags, displayed in the subscribe button area when subscription is available

issue_pricestring

Offer price (display string)

Request

let request = WhaleCoreHTTPRequest(
    method: .get,
    path: "/v1/stock-info/ipo-timeline"
)
request.query = [
    "counter_id": "ST/HK/2636"
]

let response = try await WhaleCoreService.requestService.send(request)
print(response.bodyString)

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "timeline": [
      {
        "name": "Subscription opens",
        "light": true,
        "time": "09.28\n09:00",
        "desc": ""
      },
      {
        "name": "Subscription closes",
        "light": true,
        "time": "10.06\n09:00",
        "desc": ""
      },
      {
        "name": "Allotment/placing results announced",
        "light": true,
        "time": "10.08",
        "desc": ""
      },
      {
        "name": "Grey market trading",
        "light": true,
        "time": "10.08\n16:15-18:30",
        "desc": ""
      },
      {
        "name": "Listing",
        "light": true,
        "time": "10.09",
        "desc": ""
      }
    ],
    "can_subscribe": false,
    "pay_end_date": "2026.10.06 09:00",
    "begin": true,
    "tags": [],
    "issue_price": "1.550"
  }
}