GET
/trade-optimizer?symbol={symbol}&target_date={target_date}&target_stock_price={target_stock_price}
OPTIONS
Trade Optimizer

Example URI

Live

https://api.livevol.com/v1/live/trade-optimizer?symbol=A&target_date=2022-01-21&target_stock_price=100.71

Delayed

https://api.livevol.com/v1/delayed/trade-optimizer?symbol=A&target_date=2022-01-21&target_stock_price=100.71

Request Information

URI Parameters

Name Description Type Additional information
symbol

Symbol

string

Required

target_date

Target Date

string

Required

DateTime in yyyy-MM-dd format. (i.e. 2021-06-11)

target_stock_price

Target Stock Price

decimal number

Required

Range: inclusive between 0 and 1.79769313486232E+308

Response Information

Resource Description

Collection of TradeOptimizerResult

Name Description Type Additional information SIP Provider
symbol

Stock symbol

string

None

None

target_date

Date used to evaluate strategy payoff. Must be valid option expiry.

string

None

None

target_stock_price

Target stock price

decimal number

None

None

strategy

Strategy evaluated

string

Covered Call, Long Spread (C/P), Short Spread (C/P), Naked Long (C/P), Naked Short (C/P), Long Stock, Short Stock

None

root

Underlying root

string

None

None

expiry

Expiration date

string

Value is not applicable for Long/Short Stock strategy

None

strike1

Strike of first leg

decimal number

None

None

strike2

Strike of second leg

decimal number

None

None

strike3

Strike of third leg

decimal number

None

None

strike4

Strike of fourth leg

decimal number

None

None

type

C (Call), P (Put), or S (Stock)

string

None

None

current_price

Current price of option strategy or stock

decimal number

None

None

future_price

Future price of option strategy or stock

decimal number

None

None

profit

Profit represented as (Future Price - Current Price) * 100

decimal number

None

None

regt_margin

Reg T Margin amount

decimal number

None

None

return

Returns at target, expressed as a decimal. Represented as profit / regt_margin

decimal number

None

None

prob_itm

Probability of option strategy falling ITM

decimal number

For stocks, this value is 0.

None

annualized_return

Annualized Return, expressed as a decimal

decimal number

None

None

prob_of_profit

Probability that strategy is profitable on target date

decimal number

None

None

prob_of_tgt_price

Probability that target price is met or exceeded on target date

decimal number

None

None

price1

Price of strike1

decimal number

None

None

price2

Price of strike2

decimal number

None

None

price3

Price of strike3

decimal number

None

None

price4

Price of strike4

decimal number

None

None

Response Formats

application/json, text/json

Sample:
[
  {
    "symbol": "AAPL",
    "target_date": "5/6/2018 12:00:00 AM",
    "target_stock_price": 200.0,
    "strategy": "Covered Call",
    "root": "AAPL",
    "expiry": "6/15/2018 12:00:00 AM",
    "strike1": 250.0,
    "strike2": 0.0,
    "strike3": 0.0,
    "strike4": 0.0,
    "type": "c",
    "current_price": 174.07,
    "future_price": 199.9651,
    "profit": 25.8951,
    "regt_margin": 174.07,
    "return": 0.1488,
    "prob_itm": 0.0013,
    "annualized_return": 0.0,
    "prob_of_profit": 0.0,
    "prob_of_tgt_price": 0.0,
    "price1": 0.0,
    "price2": 0.0,
    "price3": 0.0,
    "price4": 0.0
  },
  {
    "symbol": "AAPL",
    "target_date": "5/6/2018 12:00:00 AM",
    "target_stock_price": 200.0,
    "strategy": "Naked Long",
    "root": "AAPL",
    "expiry": "6/15/2018 12:00:00 AM",
    "strike1": 210.0,
    "strike2": 0.0,
    "strike3": 0.0,
    "strike4": 0.0,
    "type": "c",
    "current_price": 0.25,
    "future_price": 3.3935,
    "profit": 3.1435,
    "regt_margin": 0.25,
    "return": 12.5741,
    "prob_itm": 0.0563,
    "annualized_return": 0.0,
    "prob_of_profit": 0.0,
    "prob_of_tgt_price": 0.0,
    "price1": 0.0,
    "price2": 0.0,
    "price3": 0.0,
    "price4": 0.0
  }
]

application/xml, text/xml

Sample:
<trade_optimizer_results xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <trade_optimizer_result>
    <annualized_return>0</annualized_return>
    <current_price>174.07</current_price>
    <expiry>6/15/2018 12:00:00 AM</expiry>
    <future_price>199.9651</future_price>
    <price1>0</price1>
    <price2>0</price2>
    <price3>0</price3>
    <price4>0</price4>
    <prob_itm>0.0013</prob_itm>
    <prob_of_profit>0</prob_of_profit>
    <prob_of_tgt_price>0</prob_of_tgt_price>
    <profit>25.8951</profit>
    <regt_margin>174.07</regt_margin>
    <return>0.1488</return>
    <root>AAPL</root>
    <strategy>Covered Call</strategy>
    <strike1>250</strike1>
    <strike2>0</strike2>
    <strike3>0</strike3>
    <strike4>0</strike4>
    <symbol>AAPL</symbol>
    <target_date>5/6/2018 12:00:00 AM</target_date>
    <target_stock_price>200</target_stock_price>
    <type>c</type>
  </trade_optimizer_result>
  <trade_optimizer_result>
    <annualized_return>0</annualized_return>
    <current_price>0.25</current_price>
    <expiry>6/15/2018 12:00:00 AM</expiry>
    <future_price>3.3935</future_price>
    <price1>0</price1>
    <price2>0</price2>
    <price3>0</price3>
    <price4>0</price4>
    <prob_itm>0.0563</prob_itm>
    <prob_of_profit>0</prob_of_profit>
    <prob_of_tgt_price>0</prob_of_tgt_price>
    <profit>3.1435</profit>
    <regt_margin>0.25</regt_margin>
    <return>12.5741</return>
    <root>AAPL</root>
    <strategy>Naked Long</strategy>
    <strike1>210</strike1>
    <strike2>0</strike2>
    <strike3>0</strike3>
    <strike4>0</strike4>
    <symbol>AAPL</symbol>
    <target_date>5/6/2018 12:00:00 AM</target_date>
    <target_stock_price>200</target_stock_price>
    <type>c</type>
  </trade_optimizer_result>
</trade_optimizer_results>