Skip to content
Structured Product Trading

Submit Structured Product Subscription Order

Creates a structured product subscription order for the current account. After success, the order enters processing; rely on the order status from GET /v1/wms/orders/info for the final result. With financing (pay_mode=1), the part exceeding available cash is paid with financing.

Before calling it, complete in order: the eligibility check POST /v1/wms/client/check, the pre-order check GET /v1/wms/orders/check (for complex products, the Client must also confirm the complex product declaration), amount validation against GET /v1/wms/orders/data_info, and the Client's acceptance of the agreements on the confirmation page.

Results:

  • data.error_type is 4: the Client has not completed the derivatives knowledge assessment and no order was created. Complete the assessment, record it through POST /v1/record/questionnaire, and submit again.
  • data.order_id is valid (not empty and not 0): open the order details.
  • Request failure: show message and let the Client decide whether to submit again.

Idempotency is not confirmed, so prevent duplicate submissions while a request is in flight. On a timeout or unknown result, query GET /v1/wms/orders/list to check whether an order was created instead of retrying directly.

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

POSThttps://api.lbkrs.com/v2/wms/orders/submit

Request body application/json

counter_idstringrequired

Structured product code

quantitystringrequired

Subscription amount (notional). Must be a positive multiple of denomination

client_pricestringrequired

Client subscription price. Pass product_details.client_price from GET /v1/wms/orders/data_info

instructionstringrequired

Order instruction. Pass Buy for a subscription

order_validity_typestringrequired

Order validity type. Pass Day

order_validity_datestring

Order validity end date. Not needed for Day

pay_modeintegerrequired

Payment method:

  • 0 - Cash
  • 1 - Financing (when the amount payable exceeds available cash and the product supports financing)
Values
0
1
order_price_typesarray<object>required

Price type for each underlying. Pass an empty array when the product has no selectable price types

Child attributes
underlying_counter_idstringrequired

Underlying security code

price_typestringrequired

Price type chosen for the underlying

pricestring

Price. Required when price_type is Limit; pass an empty string otherwise

idea_idstring

Product idea ID

quote_idstring

Quote ID from the product details

Responses

HTTP 200The request succeeded. The response body contains the result of the “Submit Structured Product Subscription Order” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
order_idstring

ID of the new order. Empty or 0 means no order was created

error_typeinteger

4 means the Client has not completed the derivatives knowledge assessment and no order was created

Whale Docs