Skip to content
Jorli CLI

Defined-risk options

Jorli Agent 2.5 supports explicit, same-expiry defined-risk option structures. Naked and ratio short options are disabled. Every leg must be written into immutable schema v3 with its broker instrument, strike, CE/PE type, BUY/SELL side, lots, lot size, tick size, freeze quantity, premium, expiry, and settlement mode.

Terminal window
jorli options analyze nifty-call-spread --broker dhan --spot 25120 --volatility 14.5 --rate 6.5
jorli options stage nifty-call-spread --broker dhan --spot 25120
jorli options groups

Analysis calculates entry cash flow, expiry payoff points, break-evens, maximum profit/loss, and Black–Scholes price, implied volatility, delta, gamma, daily theta, and vega. Dhan can supply a normalized broker option chain when underlyingSecurityId and the Dhan underlying optionChainSegment (IDX_I, NSE_EQ, or BSE_EQ) are configured; its official chain response includes IV and delta/theta/gamma/vega. Kite uses configured volatility because its CLI has no option-chain endpoint. Both brokers must return a successful multi-order margin estimate; missing, excessive, or insufficient margin blocks staging.

Coordinated-fill actions

Section titled “Coordinated-fill actions”
Terminal window
jorli options transition <group> submit-protection
jorli options transition <group> fill --leg 0 --filled 65 --order <broker-order-id>
jorli options transition <group> submit-risk
jorli options transition <group> fill --leg 1 --filled 65 --order <broker-order-id>
jorli options transition <group> begin-exit
jorli options transition <group> exit-fill --leg 1 --order <broker-exit-order-id>
jorli options transition <group> exit-fill --leg 0 --order <broker-exit-order-id>

Protective long legs must fill completely before short risk legs can be submitted. Exits close short legs before releasing the protection. fail --leg N --reason ... pauses the group and requires broker reconciliation and unwind. Transitions persist in SQLite and are audited, so a restart cannot silently reset coordination state.

fill and exit-fill never trust the supplied quantity alone: Jorli rereads broker orders and trades and requires the exact instrument, side, order ID, and confirmed quantity before advancing.

For a risk-leg adjustment, begin-adjustment first closes every short leg while keeping protective longs filled. Only after all short exits are confirmed does the group return to ProtectionFilled, where a reviewed submit-risk can re-enter the immutable risk legs.

Stock options are treated as physically settled. New entries are blocked from E-4 through expiry, using the strategy’s exchange-holiday calendar, and the schema must request exit at least four trading days before expiry. Broker contract specifications and margin are time-sensitive—refresh them before accepting a strategy version.

Primary references: Dhan option chain, Dhan multi-order margin, Kite basket margins, and Zerodha physical-settlement policy.

The dashboard shows payoff/Greeks analysis and the persisted leg timeline. It does not bypass terminal approval, broker authentication, reconciliation, or the guarded CLI mutation boundary.