https://api.lbkrs.com/v1/trade/us/widget/validateRequest body application/json
Security symbol in {Code}.{Market} format. For a stock or single-leg option order, use the traded symbol, for example AAPL.US or TSLA260613C350000.US. For a multi-leg order, use the underlying stock, for example TSLA.US; it provides market and currency context only and does not count as a leg
Order type:
LO- Limit orderMO- Market orderSO_LIT- Limit if touchedSO_MIT- Market if touched
Order side:
1- Buy2- Sell
12
Order price, for example 388.5. Required when order_type is LO or SO_LIT; not used for MO or SO_MIT
Order quantity, for example 100
Time in force:
0- Day1- Good till canceled (GTC)6- Good till date (GTD);expire_dateis also required
016
Trigger price, for example 388.5. Required when order_type is SO_LIT or SO_MIT; not used for LO or MO
Limit offset amount. Required for trailing stop limit orders (TSLPAMT and TSLPPCT)
Trailing amount. Required for TSLPAMT
Trailing percentage. Required for TSLPPCT
Expiry date in YYYY-MM-DD format. Required when time_in_force is 6
Trading session:
0- Any session (ANY_TIME)1- Regular trading hours only (RTH_ONLY)4- Overnight (OVERNIGHT)
014
Order remark, up to 64 characters
Multi-leg option strategy. Required when legs is not empty:
0- CoveredCall1- CoveredPut4- Collar5- Straddle6- Strangle
01456
Leg symbols of a multi-leg option order; exactly 2 legs are required. Leave it empty for stock orders and single-leg option orders. Option symbols use the {Underlying}{YYMMDD}{C/P}{strike × 1000, 8 digits}.{Market} format, for example TSLA260613C350000.US. For a strategy that involves stock (CoveredCall, CoveredPut, or Collar), include the stock symbol as a leg, for example ["TSLA.US", "TSLA260613C350000.US"]
Responses
HTTP 200The request succeeded. The response body contains the result of the “Validate Order Card (US)” 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.