Skip to content
Longport WhaleLongport Whale
Market Data

Query Option Strategy Guide Results

Query the specific option contracts recommended by the option strategy guide, based on conditions set by the user such as investment objective, price trend, investment style, target price, and expiration date. The response includes each contract's latest price, price change, win probability, implied volatility, and maximum profit/loss.

POSThttps://api.lbkrs.com/calc/op/guide/search

Request body application/json

counter_idstringrequired

Underlying stock counter_id

expire_dateintegerrequired

Expiration date, in YYYYMMDD format; see the expire_date[].value returned by GET /calc/op/guide/config for valid values

pricestringrequired

Target price

expectationintegerrequired

Investment objective:

  • 1 - Trend Profit
  • 2 - Steady Profit

12

tendencyintegerrequired

Price trend:

  • 1 - Up
  • 2 - Down

12

styleintegerrequired

Investment style:

  • 1 - Conservative
  • 2 - Moderate
  • 3 - Aggressive

123

sortintegerrequired

Sort order; see the sort[].value returned by GET /calc/op/guide/config for valid values (observed values include 0 for price ascending and 3 for win probability descending)

offsetintegerrequired

Pagination offset

limitintegerrequired

Number of records per page; if omitted or set to 0, total is still returned correctly but items is an empty list

Responses

HTTP 200The request succeeded. The response body contains the result of the “Query Option Strategy Guide Results” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
itemsarray<object>

Option strategy match result list

Child attributes
counter_idstring

Option contract counter_id

namestring

Contract name

strategyinteger

Strategy type:

  • 1 - Buy Call
  • 2 - Sell Put
  • 3 - Sell Call
  • 4 - Buy Put; see the strategy[] returned by GET /calc/op/guide/config for details

1234

last_donestring

Latest price of this option contract

chgstring

Price change percentage

probabilitystring

Win probability

ivstring

Implied volatility

max_profitstring

Maximum profit; may be +∞, indicating no theoretical upper bound

max_lossstring

Maximum loss; may be -∞, indicating no theoretical lower bound

totalinteger

Total count

HTTP 400The service rejected the request because a business rule or input validation failed. Review the business codes and correct the request before retrying.
codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

Whale Docs