https://api.lbkrs.com/v1/trade/widget/validateRequest body application/json
Security symbol in {Code}.{Market} format, for example 700.HK
Order type:
LO- Limit orderMO- Market orderMOC- Market on closeLIT- Limit if touchedMIT- Market if touchedTSL- Trailing stop limit
LOMOMOCLITMITTSL
Order side:
1- Buy2- Sell
12
Order price. Required when order_type is LO or LIT
Order quantity, for example 100
Time in force:
0- Day1- Good till canceled (GTC)3- Immediate or cancel (IOC)5- Fill or kill (FOK)6- Good till date (GTD);expire_dateis also required
01356
Trigger price. Required when order_type is LIT or MIT
Price offset added to or subtracted from the market price to form the order price after a TSL order triggers. Required for TSL when limit_depth_level is 0 or omitted; ignored otherwise
Trailing amount. For TSL, set exactly one of tailing_amount and tailing_percent
Trailing percentage. For TSL, set exactly one of tailing_amount and tailing_percent
Expiry date in YYYY-MM-DD format. Required when time_in_force is 6
Trading session:
ANY_TIME- Any sessionRTH_ONLY- Regular trading hours onlyOVERNIGHT- Overnight
ANY_TIMERTH_ONLYOVERNIGHT
Order remark, up to 64 characters
Multi-leg option strategy:
0- CoveredCall1- CoveredPut2- VerticalCallSpread3- VerticalPutSpread4- Collar5- Straddle6- Strangle
0123456
Leg symbols of a multi-leg option order. Use only for multi-leg orders; exactly 2 legs are required
Trigger direction. Required for TSL. For LIT and MIT, the service derives it from trigger_price and monitor_price and ignores the value you send
Price used to monitor the trigger condition. Required for LIT, MIT, and TSL
Security type. Optional; when provided, it must match the security type resolved from symbol:
CS- Common stockOPT- OptionWAR- WarrantVA- Virtual assetMLEG- Multi-leg
CSOPTWARVAMLEG
Number of times the trigger condition can fire per minute for LIT, MIT, and TSL. Defaults to 1
Order book level that prices a TSL order after it triggers. Defaults to 0:
0- Market price adjusted bylimit_offset-1to-5- Bid 1 to bid 51to5- Ask 1 to ask 5
Responses
HTTP 200The request succeeded. The response body contains the result of the “Validate Order Card (Hong Kong and Singapore)” operation.codemessagedatadataobjectdata structureNormalized order parameters in the order submission format. POST /v1/trade/widget/validate and POST /v1/trade/us/widget/validate return them; pass them unchanged to the matching pre-order confirmation operation and build the order submission request from them.
Security ID (counter_id), for example ST/US/AAPL or ST/HK/700
Order side:
1- Buy2- Sell
12
Order type, for example LO (limit), MO (market), ELO (enhanced limit), ALO (at-auction limit), AO (at-auction market), ODD (odd lot), LIT (limit if touched), MIT (market if touched), TSLPAMT / TSLPPCT (trailing stop limit by amount / percentage), TSMAMT / TSMPCT (trailing stop market by amount / percentage), or MOC (market on close)
Order price; the limit price for stop-limit orders. Omit it for market orders
Trigger price for conditional orders
Order quantity
Settlement currency, for example USD, HKD, or SGD
Trading session (force_only_rth). US stocks:
0- Any session1- Regular trading hours only4- Overnight
Hong Kong and Singapore stocks:
1- Regular trading hours only2- Regular trading hours plus pre-market and after-hours3- Overnight only4- Options pre-market
Time in force:
0- Day1- Good till canceled (GTC)3- Immediate or cancel (IOC)5- Fill or kill (FOK)6- Good till date (GTD); an expiry time is also required
01356
Trailing amount, used when a trailing order tracks by amount
Trailing percentage, used when a trailing order tracks by percentage
Limit offset for trailing stop limit orders
Monitoring price for trailing orders
Number of triggers within one minute for conditional orders
Order entry identifier used to attribute the order source. Order cards use ai_widget
Single option contract
Child attributes
Security ID of the underlying
Expiry date
Strike price
Option direction:
C- CallP- Put
CP
Contract multiplier: the number of underlying shares per contract
Multi-leg option combination
Child attributes
Combination strategy type
Combination strategy name
Multi-leg combination ID
Combination code for display
Combination name
Legs of the combination
Child attributes
Security ID of the option contract in this leg
Order side:
1- Buy2- Sell
12
Ratio quantity of this leg in the combination
Order quantity of this leg, in contracts
Security type of this leg
Option expiry date
Option direction:
C- CallP- Put
CP
Strike price
Trigger direction of a LIT, MIT, or TSL order
Market price when the order card was validated, for LIT, MIT, and TSL orders. The service fetches it from quotes
Order book level that prices a TSL order after it triggers: 0 uses the market price adjusted by limit_offset, -1 to -5 use bid 1 to bid 5, and 1 to 5 use ask 1 to ask 5
Expiry time as a Unix timestamp in seconds, derived from expire_date. Present only when time_in_force is 6
Localized security name for display
HTTP 400The service rejected the request because a business rule or input validation failed. Review the business codes and correct the request before retrying.Business status code, 0 indicates success
Human-readable result or error message.