Skip to content
HK IPO

Edit HK IPO App Info

Edits and saves the subscription display copy configuration for a Hong Kong IPO security.

Request parameters

  • Required: counter_id (security ID)
  • Optional: tags, subscription_method, buying_power, financing_interest, cut_off_time, financing_estimate, notice
  • See each field description for its format, value range, and business meaning.

Business notes

The configuration is saved by counter_id, overwriting existing copy; only the fields provided take effect.

Risk warning

This operation updates the subscription copy shown to customers. Verify the target security and the copy content before calling.

Result

On success, the Hong Kong subscription copy configuration is saved; data.result indicates whether it succeeded.

POSThttps://b-api.lbkrs.com/v2/ipo/subscription/appinfo

Authorization

AuthorizationstringheaderRequired

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

Permission

ipo.subscription_manage

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

Request body application/json

counter_idstringrequired

Counter ID. This field is required. Format is {type}/{market}/{code}, for example, stock ST/HK/700 or ST/US/AAPL, and option OP/US/AAPL270319C320000.

tagsobject

Tags.

Child attributes
zh_cnarray<string>

Simplified Chinese.

zh_hkarray<string>

Traditional Chinese.

enarray<string>

English.

subscription_methodobject

Subscription Method.

Child attributes
zh_cnstring

Simplified Chinese.

zh_hkstring

Traditional Chinese.

enstring

English.

buying_powerobject

Buying Power.

Child attributes
zh_cnstring

Simplified Chinese.

zh_hkstring

Traditional Chinese.

enstring

English.

financing_interestobject

Financing Interest.

Child attributes
zh_cnstring

Simplified Chinese.

zh_hkstring

Traditional Chinese.

enstring

English.

cut_off_timeobject

Cut-off Time.

Child attributes
zh_cnstring

Simplified Chinese.

zh_hkstring

Traditional Chinese.

enstring

English.

financing_estimateobject

Financing Estimate.

Child attributes
zh_cnstring

Simplified Chinese.

zh_hkstring

Traditional Chinese.

enstring

English.

noticeobject

Notice.

Child attributes
zh_cnstring

Simplified Chinese.

zh_hkstring

Traditional Chinese.

enstring

English.

Responses

HTTP 200The request was processed successfully. data.result indicates whether the save succeeded.
Standard response envelopecodemessagedata
dataobjectdata structure
resultboolean

Result.

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