Skip to content
Longport WhaleLongport Whale
HK IPO

Submit New IPO Order

Submits an IPO subscription for the given securities account.

Business notes

  • Only Hong Kong IPOs are supported; US and other markets return 400 暂不支持该市场 (mkt not support).
  • Orders can only be submitted within the IPO's subscription period; before it opens the call returns 400 申购暂未开始.
POSThttps://b-api.lbkrs.com/v1/whaleapi/ipo/submit

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Permission

ipo.batch_ipo_order

The Broker ACCESS_TOKEN must be granted the permission above, or the call will be rejected.

Request body application/json

symbolstringrequired

Stock symbol in ticker.region format. Hong Kong only (for example 02511.HK).

sub_qtystringrequired

Subscribe quantity

methodintegerrequired

Subscription method

batch_idstringrequired

Financing batch Id

account_nostringrequired

Account Number

account_no is the securities account number (such as L6VQEU00121996). It differs from the customer ID member_id and the internal securities account ID aaid.

Responses

HTTP 200OK
Standard response envelopecodemessagedata
dataobjectdata structure
idstringrequired

Order ID

namestringrequired

Stock short name

symbolstringrequired

Stock code

marketstringrequired

Stock market

currencystringrequired

Stcok currency

sub_qtystringrequired

Subscription quantity

sub_amountstringrequired

Subscription amount

handing_feestringrequired

Subscription fee

withdraw_ablestringrequired

Enable withdraw or not

lot_win_qtystringrequired

Allotment quantity

statusstringrequired

Order status

financing_amountstringrequired

Financing amount

ipo_statusstringrequired

IPO status

methodstringrequired

Subscription method

financing_intereststringrequired

Financing interest

finance_fee_ratestringrequired

Financing rate

ipo_pricestringrequired

IPO issue price

borrow_amountstringrequired

Margin amount

borrow_intereststringrequired

interest rate

total_amountstringrequired

Order total amount

current_amountstringrequired

Order current amount

luck_atstringrequired

Allotment time

ipo_datestringrequired

IPO date

mart_beginintegerrequired

Grey trading start time

mart_endintegerrequired

Grey trading end time

modify_enablestringrequired

Order enable amend or not

borrow_enablestringrequired

Enable Margin

HTTP 400Bad request. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

Whale Docs