Skip to content
Option Strategies

Get Default Option for a Trading Opportunity

Checks whether the current account can use an option trading opportunity for the underlying stock and opportunity type, and returns the recommended default option contract. Use it to prefill the strategy preview when the Client opens an option trading opportunity from a position. The opportunity type and position direction determine the strategy: 1 (protection) maps to Protective Put for a long position and Protective Call for a short position; 2 (income) maps to Covered Call for a long position and Covered Put for a short position. When the account does not meet the conditions, the request fails; show the returned message to the Client and do not open the strategy page.

GEThttps://api.lbkrs.com/v1/orders/opportunity/info

Parameters

underlying_counter_idstringqueryRequired

Underlying stock security ID (counter_id), for example ST/US/AAPL

opportunity_typeintegerqueryRequired

Opportunity type:

  • 1 - Protection (hedge the price risk of the position)
  • 2 - Income (sell options to collect premium)

12

positionstringqueryRequired

Direction of the stock position: pass LONG when the position quantity is greater than 0; otherwise pass SHORT

LONGSHORT

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get Default Option for a Trading Opportunity” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
counter_idstring

Security ID (counter_id) of the recommended default option contract

contract_multiplierstring

Contract multiplier: the number of underlying shares per contract

strike_pricestring

Strike price

expire_datestring

Expiration date

Whale Docs