Skip to content
Subscription Reservations

Get Subscription Reservation Info

Before an IPO opens for subscription, the client can reserve a subscription by amount: a public offer reservation can use a bank financing multiple, and an international placing reservation subscribes at 1x. Once the offering opens, the system creates a subscription order from the reservation. After the subscription order is created, it cannot be cancelled; the reservation fails if the principal is insufficient at allocation or the client already has a subscription order.

Called when the reservation page opens. Returns the security, offer price range, financing multiple and financing ratio, available cash, reservation amount limits, available card types, reservation rules, and any existing reservation of the same kind the client has for this IPO. The principal required for a reservation amount is amount × (1 − financing_percentage), and must not exceed available_cash.

When calling through WhaleCore requestService(), set requiresTradeToken to true.

GEThttps://api.lbkrs.com/v1/subscription/reservation/info

Parameters

subscription_idstringqueryRequired

Reservation project ID

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get Subscription Reservation Info” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
counter_idstring

IPO security ID

namestring

IPO name

codestring

IPO code

lower_pricestring

Lower bound of the offer price

upper_pricestring

Upper bound of the offer price. When equal to the lower bound, show a single price

leveragestring

Financing multiple. A public offer reservation shows it as "Nx bank financing subscription"; pass it unchanged when submitting

financing_percentagenumber

Financing ratio from 0 to 1. Required principal = reservation amount × (1 − financing ratio)

available_cashstring

Available cash

currencystring

Reservation currency

upper_limitstring

Maximum reservation amount. Empty means no limit

lower_limitstring

Minimum reservation amount. For an international placing reservation, the client must deposit funds first if available cash is below it

available_card_countsstring

Number of available cards

card_typesarray<string>

Card types usable for this reservation: ipo quota reservation coupon, ipo_interest IPO financing interest card, ipo_commission IPO fee card

bz_typesarray<integer>

Business types to pass when querying usable cards: 1 financed IPO subscription, 2 cash IPO subscription

regulationsarray<string>

Reservation rule texts, shown one by one

same_kind_orderobject

Existing reservation of the client for this IPO. Public offer and international placing reservations are mutually exclusive

Child attributes
stateinteger

Existing reservation:

  • -1 - None
  • 0 - A public offer reservation exists
  • 1 - An international placing reservation exists
Values
-1
0
1
account_channelstring

Broker channel of the existing reservation. If it differs from the current channel, tell the client that another account has participated

order_idstring

Existing reservation ID

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