pnl.model

anonymous ok

Model position P&L

Black-Scholes P&L for a 1–8 leg option position: P&L grid now and at expiration, per-leg and net Greeks, break-evens, max profit/loss and probability of profit. Missing prices, IVs and spot are marked from the live chain.

Free. Anonymous and Free callers get 15-minute delayed data capped at 50 rows.

Input

FieldTypeDescription
legs*object[]
underlying_pricenumberSpot; defaults to the live price
ivnumberDecimal IV applied to every leg; defaults to each leg’s chain IV
ratenumberRisk-free rate, decimalDefault 0.045.
datestringValuation date; defaults to today
price_range_pctnumberGrid half-width as a fraction of spotDefault 0.2.
pointsintegerGrid price countDefault 41.

* required

Output

Returned under data; every response also carries meta with freshness, as_of and truncated.

FieldTypeDescription
symbol*string
as_of*stringCalendar date, YYYY-MM-DD
underlying_price*number
legs*object[]
net_debit*numberDollars; negative = net credit
greeks*objectPosition-level: Σ qty × 100 × Greek
breakevens*number[]
max_profit*number | nullnull when unbounded
max_loss*number | nullnull when unbounded; negative number otherwise
pop*number | nullProbability the position is profitable at the nearest expiration, 0–1
grid*object[]
setup_url*string

* required

Example request

curl -X POST "https://impliedoptions.com/api/v1/tools/pnl.model" \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "args": {
      "legs": [
        {
          "occ": "SPY260918C00620000",
          "qty": 1
        },
        {
          "occ": "SPY260918C00640000",
          "qty": -1
        }
      ]
    }
  }'

Rendered result: /analysis?setup=ticker%3ASPY%7Cpositions%3A%2BSPY260918C620%400.00%2C-SPY260918C640%400.00%7Cexp%3A2026-09-18

Run

Anonymous: 100 runs/day, delayed.
pnl.modelModel position P&LFree

JSON

Spot; defaults to the live price

Decimal IV applied to every leg; defaults to each leg’s chain IV

Risk-free rate, decimal

Valuation date; defaults to today

Grid half-width as a fraction of spot

Grid price count