Skip to content

Field Reference

OptionsRealTime organizes data into four tables, one for each connected account:

  • System Table: Connection status and system-level monitoring
  • Portfolio Table: Account-level aggregated data, margin, and P&L
  • Security Table: Individual position data for each security
  • Exposure Table: Aggregated data by underlying symbol

Field IDs are the canonical identifiers used across all OptionsRealTime interfaces including Excel RTD functions, future Python API, and any other data access methods.


System-level monitoring fields for connection status and data throughput.

Field IDDisplay NameSourceDescription
ACCOUNT_IDAccount IDIBKRIBKR account identifier (e.g., U1234567 for live, DU1234567 for paper).
ACCOUNT_IDSAccount IDsORTVector of all connected account identifiers for multi-account setups.
BYTES_PER_SEC_PORTFOLIOBytes Per Sec PortfolioORTTransmission rate for portfolio table updates.
BYTES_PER_SEC_POSITIONBytes Per Sec PositionORTTransmission rate for exposure table updates.
BYTES_PER_SEC_SECURITYBytes Per Sec SecurityORTTransmission rate for security table updates.
BYTES_PER_SEC_SYSTEMBytes Per Sec SystemORTTransmission rate for system table updates.
BYTES_PORTFOLIOBytes PortfolioORTSize of most recent portfolio table NATS message in bytes. Instantaneous snapshot.
BYTES_POSITIONBytes PositionORTSize of most recent exposure table NATS message in bytes. Instantaneous snapshot.
BYTES_SECURITYBytes SecurityORTSize of most recent security table NATS message in bytes. Instantaneous snapshot.
BYTES_SYSTEMBytes SystemORTSize of most recent system table NATS message in bytes. Instantaneous snapshot.
CLIENT_IDClient IDORTTWS API client connection ID. Multiple ORT instances connecting to same TWS need unique client IDs.
DURATION_DISCONNECTEDDuration DisconnectedClientSeconds elapsed since last data received. Calculated client-side - each client tracks time since last update.
REQ_CONTRACT_DETAILS_PCTReq Contract Details PctORTStartup progress percentage for contract detail fetching. 0-100.
REQ_MARKET_DATA_PCTReq Market Data PctORTStartup progress percentage for market data subscriptions. 0-100.
SYSTEM_STATUSSystem StatusORTBackend state machine status as integer. States include: REQ_POSITIONS, REQ_CONTRACTS, REQ_MKT_DATA, etc.

Account-level aggregated data including net liquidation, margin, P&L, and portfolio-wide Greeks.

Field IDDisplay NameSourceDescription
ACCOUNT_OR_GROUPAccount Or GroupIBKRAccount identifier or advisor group name.
ACCOUNT_TYPEAccount TypeIBKRAccount classification: Individual, Joint, IRA, LLC, Trust, etc.
ACCRUED_CASHAccrued CashIBKRInterest and dividends accrued but not yet paid.
AVAILABLE_FUNDSAvailable FundsIBKRFunds available to open new positions. Securities: ELV - Initial Margin. Commodities: NLV - Initial Margin. Negative value means cannot open new positions.
BUYING_POWERBuying PowerIBKRMaximum marginable securities value purchasable. Margin accounts: (min(ELV, Prev Day ELV) - Init Margin) × 4 intraday. Cash accounts: min(ELV, Prev Day ELV) - Init Margin.
CASH_BALANCECash BalanceIBKRSettled cash in base currency.
CONID_UNDERLYING_FUT_STKConID Underlying Fut StkORTVector of {conId, symbol} pairs mapping underlying contract IDs to symbols for futures and stocks only.
CONID_UNDERLYING_SYMBOLSConID Underlying SymbolsORTVector of {conId, symbol} pairs mapping underlying contract IDs to symbols.
CONTRACTS_CALLContracts CallORTSum of signed call option positions across portfolio. Positive = long, negative = short.
CONTRACTS_CALL_LONGContracts Call LongORTTotal long call option contracts across portfolio.
CONTRACTS_CALL_SHORTContracts Call ShortORTTotal short call option contracts across portfolio.
CONTRACTS_PUTContracts PutORTSum of signed put option positions across portfolio. Positive = long, negative = short.
CONTRACTS_PUT_LONGContracts Put LongORTTotal long put option contracts across portfolio.
CONTRACTS_PUT_SHORTContracts Put ShortORTTotal short put option contracts across portfolio.
CORPORATE_BOND_VALUECorporate Bond ValueIBKRMarket value of corporate bond positions.
COST_BASISCost BasisORTSum of cost basis across all securities.
CRYPTOCURRENCYCryptocurrencyIBKRMarket value of cryptocurrency positions (TWS v10.10+).
CURRENCYCurrencyIBKRBase currency for account (USD, EUR, etc.).
CUSHIONCushionIBKRMargin cushion ratio: Excess Liquidity / Net Liquidation. Values near 0 indicate margin danger. Healthy range: 0.3-1.0.
DAY_TRADES_REMAININGDay Trades RemainingIBKRPattern day trader count. -1 = unlimited, 0-3 = restricted.
DELTA_DLRSDelta DlrsORTSum of dollar delta across all securities. Portfolio total dollar delta exposure.
DELTA_DLRS_ORTDelta Dlrs ORTORTSum of ORT-calculated dollar delta across all securities.
EQUITY_WITH_LOAN_VALUEEquity With Loan ValueIBKREquity with loan value - basis for margin calculations. Securities (margin): Cash + Stock + Bonds + Funds + European/Asian Options. Securities (cash): Settled Cash. Commodities: Cash + Options - Futures Maintenance Margin. Must exceed Maintenance Margin to avoid liquidation.
EXCESS_LIQUIDITYExcess LiquidityIBKRMargin cushion before liquidation. Securities: ELV - Maintenance Margin. Commodities: NLV - Maintenance Margin. Negative value means margin violation and liquidation is imminent.
EXCHANGE_RATEExchange RateIBKRForeign exchange rate used for currency conversion.
EXPIRATION_DATESExpiration DatesORTVector of unique option expiration dates in portfolio as YYYYMMDD integers.
EXTRINSIC_VALUEExtrinsic ValueORTSum of extrinsic value across all option positions. Time value component.
EXTRINSIC_CALLExtrinsic CallORTSum of extrinsic value for all call option positions.
EXTRINSIC_PUTExtrinsic PutORTSum of extrinsic value for all put option positions.
FULL_AVAILABLE_FUNDSFull Available FundsIBKRAvailable funds calculated with full overnight margin requirements.
FULL_EXCESS_LIQUIDITYFull Excess LiquidityIBKRExcess liquidity calculated with full overnight margin requirements.
FULL_INIT_MARGIN_REQFull Init Margin ReqIBKRInitial margin requirement including overnight calculations.
FULL_MAINT_MARGIN_REQFull Maint Margin ReqIBKRMaintenance margin requirement including overnight calculations.
FUND_VALUEFund ValueIBKRTotal market value of fund positions.
FUTURES_PNLFutures PnLIBKRProfit and loss from futures positions.
FX_CASH_BALANCEFX Cash BalanceIBKRForeign exchange cash balance in non-base currencies.
GROSS_POSITION_VALUEGross Position ValueIBKRSum of absolute values of all positions: abs(Long Stock) + abs(Short Stock) + abs(Long Options) + abs(Short Options) + abs(Long SSF Notional) + abs(Short SSF Notional) + abs(Fund Value).
IN_MONEY_POSITIONIn Money PositionORTSum of in-the-money option contract counts across portfolio.
IN_MONEY_POSITION_CALLIn Money Position CallORTTotal in-the-money call option contracts across portfolio.
IN_MONEY_POSITION_PUTIn Money Position PutORTTotal in-the-money put option contracts across portfolio.
INIT_MARGIN_REQInit Margin ReqIBKRCurrent initial margin requirement.
INSTRUMENT_TYPESInstrument TypesORTVector of instrument types present in portfolio (CALL, PUT, STK, FUT, etc.).
INTRINSIC_VALUEIntrinsic ValueORTSum of intrinsic value across all option positions. In-the-money amount.
INTRINSIC_CALLIntrinsic CallORTSum of intrinsic value for all call option positions.
INTRINSIC_PUTIntrinsic PutORTSum of intrinsic value for all put option positions.
ISSUER_OPTION_VALUEIssuer Option ValueIBKRMarket value of issuer option positions.
LOOKAHEAD_AVAILABLE_FUNDSLookahead Available FundsIBKRProjected available funds at next margin change time. ELV - LookAhead Initial Margin.
LOOKAHEAD_EXCESS_LIQUIDITYLookahead Excess LiquidityIBKRProjected excess liquidity at next margin change time. Securities: ELV - LookAhead Maint. Commodities: NLV - LookAhead Maint.
LOOKAHEAD_INIT_MARGIN_REQLookahead Init Margin ReqIBKRProjected initial margin requirement at next margin change time.
LOOKAHEAD_MAINT_MARGIN_REQLookahead Maint Margin ReqIBKRProjected maintenance margin requirement at next margin change time.
LOOKAHEAD_NEXT_CHANGELookahead Next ChangeIBKRUnix timestamp when margin requirements will next change (e.g., market open/close, expiration). 0 = no scheduled change.
LOOKAHEAD_NEXT_CHANGE_EXCELLookahead Next Change ExcelORTMargin change time as Excel serial date. Format cell as date/time in Excel.
MAINT_MARGIN_REQMaint Margin ReqIBKRCurrent maintenance margin requirement. If ELV drops below this value, margin call triggers.
MONEY_MARKET_FUND_VALUEMoney Market Fund ValueIBKRMarket value of money market fund positions.
MUTUAL_FUND_VALUEMutual Fund ValueIBKRMarket value of mutual fund positions.
NET_DIVIDENDNet DividendIBKRNet dividend value.
NET_LIQNet LiqORTNet liquidation value cached from IBKR updates.
NET_LIQ_BY_CURRENCYNet Liq By CurrencyIBKRNet liquidation value broken out by currency.
NET_LIQ_CALCNet Liq CalcORTReal-time net liquidation estimate. Calculated as NET_LIQ + (current daily P&L - daily P&L at last IBKR net liq update). Provides tick-by-tick estimate between IBKR updates.
NET_LIQ_DELTANet Liq DeltaORTDelta between current daily P&L and P&L when IBKR last sent net liquidation update.
NET_LIQ_PCT_CHANGENet Liq Pct ChangeORTDaily percentage change in net liquidation. 100 × daily P&L / (net liq - daily P&L).
NET_LIQ_READYNet Liq ReadyORTBoolean indicating whether net liquidation data has been received and validated.
NET_LIQ_UPDATE_TIMENet Liq Update TimeIBKRUnix timestamp when IBKR last sent net liquidation update.
NET_LIQ_UPDATE_TIME_EXCELNet Liq Update Time ExcelORTNet liquidation update time as Excel serial date. Format cell as date/time in Excel.
NET_LIQ_VALUENet Liq ValueORTSum of net liquidation values across all securities.
NET_LIQUIDATIONNet LiquidationIBKRTotal account value if all positions were liquidated. Securities: Cash + Stock + Options + Bonds + Funds. Commodities: Cash (including futures P&L) + Options. Crypto: Cash + Cryptocurrency.
NOTIONAL_CALL_LONGNotional Call LongORTSum of notional value for all long call positions.
NOTIONAL_CALL_SHORTNotional Call ShortORTSum of notional value for all short call positions.
NOTIONAL_PUT_LONGNotional Put LongORTSum of notional value for all long put positions.
NOTIONAL_PUT_SHORTNotional Put ShortORTSum of notional value for all short put positions.
OPTION_MARKET_VALUEOption Market ValueIBKRTotal market value of equity option positions.
OUT_MONEY_POSITIONOut Money PositionORTSum of out-of-the-money option contract counts across portfolio.
OUT_MONEY_POSITION_CALLOut Money Position CallORTTotal out-of-the-money call option contracts across portfolio.
OUT_MONEY_POSITION_PUTOut Money Position PutORTTotal out-of-the-money put option contracts across portfolio.
PNLPnLIBKRAccount-level daily profit and loss. Sum of daily P&L across all positions.
PNL_REALIZEDPnL RealizedORTSum of realized P&L across all positions.
PNL_UNREALIZEDPnL UnrealizedORTSum of unrealized P&L across all positions.
POSITION_TYPESPosition TypesORTVector of position directions present in portfolio: combinations of LONG, SHORT, FLAT.
REAL_CURRENCYReal CurrencyIBKRActual currency of returned values.
REALIZED_PNLRealized PnLIBKRRealized profit and loss from account summary.
RHORhoORTSum of rho across all option positions. Portfolio sensitivity to interest rate changes.
STOCK_MARKET_VALUEStock Market ValueIBKRTotal market value of stock positions.
THETAThetaORTSum of IBKR theta across all option positions. Portfolio daily time decay.
THETA2Theta2ORTSum of conservative IBKR theta across all option positions. Uses analytical model theta unless its absolute value exceeds linear theta, in which case linear theta is used.
THETA2_ORTTheta2 ORTORTSum of conservative ORT theta across all option positions. Uses analytical model theta unless its absolute value exceeds linear theta, in which case linear theta is used.
THETA_BUMP2_ORTTheta Bump2 ORTORTSum of conservative bumped theta across all option positions. Uses finite-difference theta unless its absolute value exceeds linear theta, in which case linear theta is used.
THETA_BUMP_ORTTheta Bump ORTORTSum of finite-difference theta across all option positions. Reprices option with one less day to expiration.
THETA_LINEARTheta LinearORTSum of linear theta across all option positions. Simple straight-line time decay: -Extrinsic Value / Days To Expiry.
THETA_ORTTheta ORTORTSum of ORT theta across all option positions using QuantLib models.
TIMETimeIBKRCurrent server time as Unix timestamp (seconds since 1970-01-01 UTC).
TIME_EXCELTime ExcelORTCurrent server time as Excel serial date. Format cell as date/time in Excel.
TOTAL_CASH_BALANCETotal Cash BalanceIBKRCash balance summed across all currencies, converted to base currency.
TOTAL_CASH_VALUETotal Cash ValueIBKRTotal cash including unsettled funds and futures P&L.
TOTAL_NET_LIQ_VALUETotal Net Liq ValueORTCombined net liquidation and total cash value for display.
TREASURY_BILL_VALUETreasury Bill ValueIBKRMarket value of Treasury bill positions.
TREASURY_BOND_VALUETreasury Bond ValueIBKRMarket value of Treasury bond positions.
UNDERLYING_SYMBOLSUnderlying SymbolsORTVector of unique underlying symbols in portfolio (e.g., [“SPY”, “AAPL”, “QQQ”]).
UNREALIZED_PNLUnrealized PnLIBKRUnrealized profit and loss from account summary.
VALUEValueORTSum of IBKR position values across all securities.
VALUE_ORTValue ORTORTSum of ORT-calculated position values across all securities.
VEGAVegaORTSum of IBKR vega across all option positions. Portfolio sensitivity to volatility changes.
VEGA_ORTVega ORTORTSum of ORT vega across all option positions using QuantLib models.
WARRANT_VALUEWarrant ValueIBKRMarket value of warrant positions.

Individual position data for each security. One row per security in the portfolio.

Field IDDisplay NameSourceDescription
ASKAskIBKRCurrent best ask price.
ASK_SIZEAsk SizeIBKRSize available at ask price.
ASK_YIELDAsk YieldIBKRYield at ask price for bonds.
AVG_PRICEAvg PriceIBKRAverage cost per unit. For bonds: avgCost / 10 (IBKR reports bonds in tenths).
BIDBidIBKRCurrent best bid price.
BID_ASKBid AskORTHTML formatted bid/ask with sizes as subscripts.
BID_SIZEBid SizeIBKRSize available at bid price.
BID_YIELDBid YieldIBKRYield at bid price for bonds.
BOND_DESCRIPTIONBond DescriptionORTBond description constructed from trading class and contract ID.
CHANGEChangeORTPrice change from previous close. Last - Close. Only set when both values available.
CHANGE_PCTChange PctORTPercentage price change. 100 × (Last - Close) / Close.
CLOSECloseIBKRPrevious session closing price.
CON_IDConIDIBKRIBKR contract identifier. Globally unique integer.
CONTRACTS_CALLContracts CallORTSigned position if this is a call option, 0 otherwise. Positive = long, negative = short.
CONTRACTS_CALL_LONGContracts Call LongORTPosition value if this is a long call, 0 otherwise.
CONTRACTS_CALL_SHORTContracts Call ShortORTPosition value (negative) if this is a short call, 0 otherwise.
CONTRACTS_PUTContracts PutORTSigned position if this is a put option, 0 otherwise. Positive = long, negative = short.
CONTRACTS_PUT_LONGContracts Put LongORTPosition value if this is a long put, 0 otherwise.
CONTRACTS_PUT_SHORTContracts Put ShortORTPosition value (negative) if this is a short put, 0 otherwise.
COST_BASISCost BasisORTTotal cost basis. Position × average cost.
DELTADeltaIBKRDelta from IBKR option model. Position-weighted: raw delta × position × multiplier.
DELTA_DLRSDelta DlrsORTDollar delta exposure. Options: DELTA × underlying price. Stocks: position × multiplier × price.
DELTA_DLRS_METRICSDelta Dlrs MetricsORTVector of dollar delta values at different price and volatility scenarios. See Metrics Vector Structure section.
DELTA_DLRS_ORTDelta Dlrs ORTORTDollar delta using ORT-calculated delta. DELTA_ORT × underlying price.
DELTA_METRICSDelta MetricsORTVector of delta values at different price and volatility scenarios. See Metrics Vector Structure section.
DELTA_ORTDelta ORTORTDelta calculated by ORT using QuantLib models. Position-weighted.
DIVIDEND_PVDividend PVIBKRPresent value of expected dividends.
DIVIDEND_YIELDDividend YieldORTDividend yield used in option pricing.
EXPIRATION_DATEExpiration DateIBKROption expiration date as YYYYMMDD integer.
DAYS_TO_EXPIRYDays To ExpiryORTCalendar days until option expiration.
EXTRINSIC_VALUEExtrinsic ValueORTExtrinsic value (time value). VALUE - INTRINSIC_VALUE. Decays to zero at expiration.
EXTRINSIC_VALUE_1XExtrinsic Value 1xORTPer-contract extrinsic value. Extrinsic value / (position × multiplier).
EXTRINSIC_CALLExtrinsic CallORTEXTRINSIC_VALUE if this is a call, 0 otherwise.
EXTRINSIC_VAL_METRICSExtrinsic Val MetricsORTVector of extrinsic values at different price and volatility scenarios. See Metrics Vector Structure section.
EXTRINSIC_PUTExtrinsic PutORTEXTRINSIC_VALUE if this is a put, 0 otherwise.
FINANCIAL_INSTRUMENTFinancial InstrumentIBKRFull instrument identifier from local symbol.
FINANCIAL_INSTRUMENT_2Financial Instrument 2ORTSecondary display format for instrument identifier.
GAMMAGammaIBKRGamma from IBKR option model. Position-weighted. Rate of delta change per $1 underlying move.
GAMMA_DLRSGamma DlrsORTDollar gamma. Options: GAMMA × underlying price. Stocks: 0.
GAMMA_DLRS_METRICSGamma Dlrs MetricsORTVector of dollar gamma values at different price and volatility scenarios. See Metrics Vector Structure section.
GAMMA_DLRS_ORTGamma Dlrs ORTORTDollar gamma using ORT-calculated gamma.
GAMMA_METRICSGamma MetricsORTVector of gamma values at different price and volatility scenarios. See Metrics Vector Structure section.
GAMMA_ORTGamma ORTORTGamma calculated by ORT using QuantLib models. Position-weighted.
HIGHHighIBKRSession high price.
IMPLIED_VOLImplied VolIBKRImplied volatility from IBKR option model. Stored as percentage (25.5 = 25.5% IV).
IMPLIED_VOL_ORTImplied Vol ORTORTImplied volatility calculated by ORT. Stored as percentage. Falls back to IMPLIED_VOL on calculation failure.
IN_MONEYIn MoneyORTIn-the-money amount per share. ITM calls: underlying - strike. ITM puts: strike - underlying. 0 for OTM.
IN_MONEY_PCTIn Money PctORTIn-the-money percentage. 100 × IN_MONEY / strike.
IN_MONEY_POSITIONIn Money PositionORTAbsolute position count if option is in-the-money, 0 otherwise.
IN_MONEY_POSITION_CALLIn Money Position CallORTAbsolute position count if this is an in-the-money call, 0 otherwise.
IN_MONEY_POSITION_PUTIn Money Position PutORTAbsolute position count if this is an in-the-money put, 0 otherwise.
IN_OUT_MONEYIn Out MoneyORTSigned moneyness. Positive = ITM (equals IN_MONEY). Negative = OTM (equals -OUT_MONEY).
IN_OUT_MONEY_PCTIn Out Money PctORTSigned moneyness percentage. 100 × IN_OUT_MONEY / strike. Positive for ITM, negative for OTM.
INSTRUMENT_TYPEInstrument TypeORTInstrument type as integer enum: CALL, PUT, STK, FUT, BOND, BILL, CASH, etc.
INTRINSIC_VALUEIntrinsic ValueORTIntrinsic value for entire position. Intrinsic value per contract × position × multiplier.
INTRINSIC_VALUE_1XIntrinsic Value 1xORTPer-contract intrinsic value. ITM calls: underlying - strike. ITM puts: strike - underlying. 0 for OTM.
INTRINSIC_CALLIntrinsic CallORTINTRINSIC_VALUE if this is a call, 0 otherwise.
INTRINSIC_PUTIntrinsic PutORTINTRINSIC_VALUE if this is a put, 0 otherwise.
LASTLastIBKRLast traded price.
LAST_SIZELast SizeIBKRSize of last trade.
LAST_TIMESTAMPLast TimestampIBKRUnix timestamp of last trade.
LAST_TIMESTAMP_EXCELLast Timestamp ExcelORTLast trade timestamp as Excel serial date. Format cell as date/time in Excel.
LAST_YIELDLast YieldIBKRYield at last price for bonds.
LOWLowIBKRSession low price.
MIN_TICKMin TickIBKRMinimum price increment for this security.
MULTIPLIERMultiplierIBKRContract multiplier. 100 for standard equity options.
NET_LIQ_PRICENet Liq PriceORTPrice used for liquidation value. Bid for long positions, ask for short positions.
NET_LIQ_VALUENet Liq ValueORTLiquidation value. Longs: bid × position × multiplier. Shorts: ask × position × multiplier.
NOTIONALNotionalORTNotional value for options. Position × strike × multiplier × price quotation. Represents controlled underlying value.
NOTIONAL_CALLNotional CallORTNOTIONAL if this is a call, 0 otherwise.
NOTIONAL_CALL_LONGNotional Call LongORTNOTIONAL if this is a long call, 0 otherwise.
NOTIONAL_CALL_SHORTNotional Call ShortORTNOTIONAL if this is a short call, 0 otherwise.
NOTIONAL_PUTNotional PutORTNOTIONAL if this is a put, 0 otherwise.
NOTIONAL_PUT_LONGNotional Put LongORTNOTIONAL if this is a long put, 0 otherwise.
NOTIONAL_PUT_SHORTNotional Put ShortORTNOTIONAL if this is a short put, 0 otherwise.
OPENOpenIBKRSession opening price.
OUT_MONEYOut MoneyORTOut-of-the-money amount per share. OTM calls: strike - underlying. OTM puts: underlying - strike. 0 for ITM.
OUT_MONEY_PCTOut Money PctORTOut-of-the-money percentage. 100 × OUT_MONEY / strike.
OUT_MONEY_POSITIONOut Money PositionORTAbsolute position count if option is out-of-the-money, 0 otherwise.
OUT_MONEY_POSITION_CALLOut Money Position CallORTAbsolute position count if this is an out-of-the-money call, 0 otherwise.
OUT_MONEY_POSITION_PUTOut Money Position PutORTAbsolute position count if this is an out-of-the-money put, 0 otherwise.
PNLPnLIBKRDaily profit and loss for this position. 0 if position is 0.
PNL_CALLPnL CallORTPNL if this is a call, 0 otherwise.
PNL_CALL_LONGPnL Call LongORTPNL if this is a long call, 0 otherwise.
PNL_CALL_SHORTPnL Call ShortORTPNL if this is a short call, 0 otherwise.
PNL_METRICSPnL MetricsORTVector of P&L values at different price and volatility scenarios. See Metrics Vector Structure section.
PNL_PREV_CLOSEPnL Prev CloseORTP&L change from previous close. Options: NPV change from underlying move. Stocks/bonds: same as daily P&L.
PNL_PREV_CLOSE_DELTAPnL Prev Close DeltaORTDelta approximation of P&L from previous close. DELTA (IBKR) × underlying change. First-order estimate.
PNL_PREV_CLOSE_DELTA_ORTPnL Prev Close Delta ORTORTDelta approximation using ORT delta. DELTA_ORT × underlying change.
PNL_PUTPnL PutORTPNL if this is a put, 0 otherwise.
PNL_PUT_LONGPnL Put LongORTPNL if this is a long put, 0 otherwise.
PNL_PUT_SHORTPnL Put ShortORTPNL if this is a short put, 0 otherwise.
PNL_REALIZEDPnL RealizedIBKRRealized profit and loss for this position.
PNL_UNDERLYINGPnL UnderlyingORTPNL if this is an underlying (stock/future), 0 otherwise.
PNL_UNDERLYING_LONGPnL Underlying LongORTPNL if this is a long underlying position, 0 otherwise.
PNL_UNDERLYING_SHORTPnL Underlying ShortORTPNL if this is a short underlying position, 0 otherwise.
PNL_UNREALIZEDPnL UnrealizedIBKRUnrealized profit and loss for this position.
PNL_UNREALIZED_METRICSPnL Unrealized MetricsORTVector of unrealized P&L values at different price and volatility scenarios. See Metrics Vector Structure section.
POSITIONPositionIBKRSigned position quantity. Positive = long, negative = short.
POSITION_DETAILPosition DetailORTFormatted position description: “LONG X instrument” or “SHRT X instrument” or “0 instrument”.
POSITION_TYPEPosition TypeORTPosition direction as integer enum. LONG (position > 0), SHORT (position < 0), FLAT (position == 0).
PRICE_QUOTEPrice QuoteIBKRPrice quotation multiplier. 1 / priceMagnifier. Handles non-standard price quotation.
REVALUATIONRevaluationORTBack-calculated price from IBKR value. VALUE / (position × multiplier), rounded to minimum tick. Shows implied price from IBKR’s position value.
RHORhoORTRho calculated by ORT using QuantLib models. Position-weighted. Sensitivity to interest rate changes.
RISK_FREE_RATERisk Free RateORTRisk-free interest rate used in ORT option pricing calculations.
ROW_INDEXRow IndexORTIncrementing counter for table row ordering.
SECURITY_TYPESecurity TypeIBKRSecurity type as integer enum: STK, OPT, FUT, FOP, BOND, BILL, CASH, IND.
STRIKEStrikeIBKROption strike price.
SYMBOLSymbolIBKRLocal symbol. Options: “SPY 250117C00600000”. Stocks: “AAPL”.
THETAThetaIBKRTheta from IBKR option model. Position-weighted. Daily time decay. Negative for long options.
THETA2Theta2ORTConservative IBKR theta. Uses analytical model theta unless its absolute value exceeds linear theta, in which case linear theta is used.
THETA2_ORTTheta2 ORTORTConservative ORT theta. Uses analytical model theta unless its absolute value exceeds linear theta, in which case linear theta is used.
THETA_BUMP2_ORTTheta Bump2 ORTORTConservative bumped theta. Uses finite-difference theta unless its absolute value exceeds linear theta, in which case linear theta is used.
THETA_BUMP_ORTTheta Bump ORTORTFinite-difference theta. Reprices option with one less day to expiration and calculates daily decay.
THETA_CALLTheta CallORTTHETA value if this is a call, 0 otherwise.
THETA_LINEARTheta LinearORTLinear time decay. -Extrinsic Value / Days To Expiry. Simple straight-line assumption.
THETA_METRICSTheta MetricsORTVector of theta values at different price and volatility scenarios. See Metrics Vector Structure section.
THETA_ORTTheta ORTORTTheta calculated by ORT using QuantLib models. Position-weighted.
THETA_PUTTheta PutORTTHETA value if this is a put, 0 otherwise.
TIME_VALUE_PCTTime Value PctORTAnnualized yield from extrinsic value. 100 × ((1 + extrinsic/strike/DTE)^365 - 1). This is a return calculation, not the same as extrinsic value.
UNDERLYINGUnderlyingORTUnderlying symbol. For derivatives: the underlying’s symbol. For stocks: same as SYMBOL.
UNDERLYING_1Underlying 1ORTFormatted underlying display: “symbol price”.
UNDERLYING_2Underlying 2ORTFormatted underlying display: “symbol price change changePct”.
UNDERLYING_ASKUnderlying AskORTAsk price of the underlying security.
UNDERLYING_ASK_SIZEUnderlying Ask SizeORTAsk size of the underlying security.
UNDERLYING_BIDUnderlying BidORTBid price of the underlying security.
UNDERLYING_BID_ASKUnderlying Bid AskORTHTML formatted bid/ask for underlying security.
UNDERLYING_BID_SIZEUnderlying Bid SizeORTBid size of the underlying security.
UNDERLYING_CHANGEUnderlying ChangeORTPrice change of the underlying security from previous close.
UNDERLYING_CHANGE_PCTUnderlying Change PctORTPercentage price change of the underlying security.
UNDERLYING_CON_IDUnderlying ConIDIBKRContract ID of the underlying security. For underlyings, equals CON_ID.
UNDERLYING_LASTUnderlying LastORTLast price of the underlying security.
UNDERLYING_LAST_SIZEUnderlying Last SizeORTLast trade size of the underlying security.
UNDERLYING_LONGUnderlying LongORTPosition value if this is a long underlying position, 0 otherwise.
UNDERLYING_QUOTEUnderlying QuoteORTHTML formatted quote for underlying: “change^last_size^changePct”.
UNDERLYING_SHORTUnderlying ShortORTPosition value (negative) if this is a short underlying position, 0 otherwise.
IS_UNDERLYINGIs UnderlyingORTBoolean. True if this row IS an underlying (STK, FUT, BOND, BILL, CASH), false for derivatives (OPT, FOP).
VALUEValueIBKRPosition value from IBKR. 0 if IBKR returns invalid value.
VALUE_CALLValue CallORTVALUE if this is a call, 0 otherwise.
VALUE_CALL_LONGValue Call LongORTVALUE if this is a long call, 0 otherwise.
VALUE_CALL_SHORTValue Call ShortORTVALUE if this is a short call, 0 otherwise.
VALUE_METRICSValue MetricsORTVector of position values at different price and volatility scenarios. See Metrics Vector Structure section.
VALUE_ORTValue ORTORTORT-calculated position value. Options: NPV × position × multiplier from QuantLib. Stocks: mid-price based.
VALUE_PUTValue PutORTVALUE if this is a put, 0 otherwise.
VALUE_PUT_LONGValue Put LongORTVALUE if this is a long put, 0 otherwise.
VALUE_PUT_SHORTValue Put ShortORTVALUE if this is a short put, 0 otherwise.
VALUE_UNDERLYINGValue UnderlyingORTVALUE if this is an underlying position, 0 otherwise.
VALUE_UNDERLYING_LONGValue Underlying LongORTVALUE if this is a long underlying position, 0 otherwise.
VALUE_UNDERLYING_SHORTValue Underlying ShortORTVALUE if this is a short underlying position, 0 otherwise.
VEGAVegaIBKRVega from IBKR option model. Position-weighted. Sensitivity to 1% IV change.
VEGA_METRICSVega MetricsORTVector of vega values at different price and volatility scenarios. See Metrics Vector Structure section.
VEGA_ORTVega ORTORTVega calculated by ORT using QuantLib models. Position-weighted.
VOLUMEVolumeIBKRTrading volume.

Aggregated position data by underlying symbol. Each row represents all positions (options and stock) for one underlying.

Field IDDisplay NameSourceDescription
ASKAskIBKRAsk price of the underlying security.
ASK_SIZEAsk SizeIBKRAsk size of the underlying security.
BIDBidIBKRBid price of the underlying security.
BID_ASKBid AskORTHTML formatted bid/ask for underlying security.
BID_SIZEBid SizeIBKRBid size of the underlying security.
CHANGEChangeORTPrice change of underlying from previous close.
CHANGE_PCTChange PctORTPercentage price change of underlying.
CON_IDConIDIBKRContract ID of the underlying security.
CONTRACTS_CALLContracts CallORTSum of signed call positions for this underlying. Positive = long, negative = short.
CONTRACTS_CALL_LONGContracts Call LongORTTotal long call contracts for this underlying.
CONTRACTS_CALL_SHORTContracts Call ShortORTTotal short call contracts for this underlying.
CONTRACTS_PUTContracts PutORTSum of signed put positions for this underlying. Positive = long, negative = short.
CONTRACTS_PUT_LONGContracts Put LongORTTotal long put contracts for this underlying.
CONTRACTS_PUT_SHORTContracts Put ShortORTTotal short put contracts for this underlying.
COST_BASISCost BasisORTSum of cost basis across all positions for this underlying.
DELTADeltaORTSum of IBKR delta across all positions for this underlying. Net delta exposure.
DELTA_DLRSDelta DlrsORTSum of dollar delta across all positions for this underlying.
DELTA_DLRS_METRICSDelta Dlrs MetricsORTSum of dollar delta metric vectors across all positions for this underlying. See Metrics Vector Structure section.
DELTA_DLRS_ORTDelta Dlrs ORTORTSum of ORT dollar delta across all positions for this underlying.
DELTA_METRICSDelta MetricsORTSum of delta metric vectors across all positions for this underlying. See Metrics Vector Structure section.
DELTA_ORTDelta ORTORTSum of ORT delta across all positions for this underlying.
EXTRINSIC_VALUEExtrinsic ValueORTSum of extrinsic value across all option positions for this underlying.
EXTRINSIC_CALLExtrinsic CallORTSum of call extrinsic value for this underlying.
EXTRINSIC_VAL_METRICSExtrinsic Val MetricsORTSum of extrinsic value metric vectors for this underlying. See Metrics Vector Structure section.
EXTRINSIC_PUTExtrinsic PutORTSum of put extrinsic value for this underlying.
GAMMAGammaORTSum of IBKR gamma across all positions for this underlying.
GAMMA_DLRSGamma DlrsORTSum of dollar gamma across all positions for this underlying.
GAMMA_DLRS_METRICSGamma Dlrs MetricsORTSum of dollar gamma metric vectors for this underlying. See Metrics Vector Structure section.
GAMMA_DLRS_ORTGamma Dlrs ORTORTSum of ORT dollar gamma across all positions for this underlying.
GAMMA_METRICSGamma MetricsORTSum of gamma metric vectors for this underlying. See Metrics Vector Structure section.
GAMMA_ORTGamma ORTORTSum of ORT gamma across all positions for this underlying.
IN_MONEY_POSITIONIn Money PositionORTSum of in-the-money option contracts for this underlying.
IN_MONEY_POSITION_CALLIn Money Position CallORTTotal in-the-money call contracts for this underlying.
IN_MONEY_POSITION_PUTIn Money Position PutORTTotal in-the-money put contracts for this underlying.
INTRINSIC_VALUEIntrinsic ValueORTSum of intrinsic value across all option positions for this underlying.
INTRINSIC_CALLIntrinsic CallORTSum of call intrinsic value for this underlying.
INTRINSIC_PUTIntrinsic PutORTSum of put intrinsic value for this underlying.
LASTLastIBKRLast price of the underlying security.
MIN_TICKMin TickIBKRMinimum tick size of the underlying security.
NET_LIQ_VALUENet Liq ValueORTSum of liquidation values across all positions for this underlying.
NOTIONAL_CALLNotional CallORTSum of call notional values for this underlying.
NOTIONAL_CALL_LONGNotional Call LongORTSum of long call notional values for this underlying.
NOTIONAL_CALL_SHORTNotional Call ShortORTSum of short call notional values for this underlying.
NOTIONAL_PUTNotional PutORTSum of put notional values for this underlying.
NOTIONAL_PUT_LONGNotional Put LongORTSum of long put notional values for this underlying.
NOTIONAL_PUT_SHORTNotional Put ShortORTSum of short put notional values for this underlying.
OUT_MONEY_POSITIONOut Money PositionORTSum of out-of-the-money option contracts for this underlying.
OUT_MONEY_POSITION_CALLOut Money Position CallORTTotal out-of-the-money call contracts for this underlying.
OUT_MONEY_POSITION_PUTOut Money Position PutORTTotal out-of-the-money put contracts for this underlying.
PNLPnLORTSum of daily P&L across all positions for this underlying.
PNL_CALLPnL CallORTSum of call P&L for this underlying.
PNL_METRICSPnL MetricsORTSum of P&L metric vectors for this underlying. See Metrics Vector Structure section.
PNL_PREV_CLOSEPnL Prev CloseORTSum of P&L from previous close across all positions for this underlying.
PNL_PREV_CLOSE_DELTAPnL Prev Close DeltaORTSum of delta approximation P&L from previous close.
PNL_PREV_CLOSE_DELTA_ORTPnL Prev Close Delta ORTORTSum of ORT delta approximation P&L from previous close.
PNL_PUTPnL PutORTSum of put P&L for this underlying.
PNL_REALIZEDPnL RealizedORTSum of realized P&L across all positions for this underlying.
PNL_UNREALIZEDPnL UnrealizedORTSum of unrealized P&L across all positions for this underlying.
PNL_UNREALIZED_METRICSPnL Unrealized MetricsORTSum of unrealized P&L metric vectors for this underlying. See Metrics Vector Structure section.
RHORhoORTSum of ORT rho across all positions for this underlying.
ROW_INDEXRow IndexORTIncrementing counter for table row ordering.
SECURITY_TYPESecurity TypeIBKRType of underlying security: STK, FUT, IND, etc.
STRIP_CON_IDSStrip ConIDsORTVector of contract IDs for all options on this underlying.
THETAThetaORTSum of IBKR theta across all positions for this underlying.
THETA2Theta2ORTSum of conservative IBKR theta across all positions for this underlying. Uses analytical model theta unless its absolute value exceeds linear theta, in which case linear theta is used.
THETA2_ORTTheta2 ORTORTSum of conservative ORT theta across all positions for this underlying. Uses analytical model theta unless its absolute value exceeds linear theta, in which case linear theta is used.
THETA_BUMP2_ORTTheta Bump2 ORTORTSum of conservative bumped theta across all positions for this underlying. Uses finite-difference theta unless its absolute value exceeds linear theta, in which case linear theta is used.
THETA_BUMP_ORTTheta Bump ORTORTSum of finite-difference theta across all positions for this underlying.
THETA_CALLTheta CallORTSum of call theta for this underlying.
THETA_LINEARTheta LinearORTSum of linear theta across all positions for this underlying.
THETA_METRICSTheta MetricsORTSum of theta metric vectors for this underlying. See Metrics Vector Structure section.
THETA_ORTTheta ORTORTSum of ORT theta across all positions for this underlying.
THETA_PUTTheta PutORTSum of put theta for this underlying.
UNDERLYINGUnderlyingORTUnderlying symbol.
UNDERLYING_1Underlying 1ORTFormatted display: “symbol price”.
UNDERLYING_2Underlying 2ORTFormatted display: “symbol price change changePct”.
UNDERLYING_BID_ASKUnderlying Bid AskORTHTML formatted bid/ask for underlying.
UNDERLYING_QUOTEUnderlying QuoteORTHTML formatted quote for underlying.
VALUEValueORTSum of IBKR values across all positions for this underlying.
VALUE_METRICSValue MetricsORTSum of value metric vectors for this underlying. See Metrics Vector Structure section.
VALUE_ORTValue ORTORTSum of ORT values across all positions for this underlying.
VEGAVegaORTSum of IBKR vega across all positions for this underlying.
VEGA_METRICSVega MetricsORTSum of vega metric vectors for this underlying. See Metrics Vector Structure section.
VEGA_ORTVega ORTORTSum of ORT vega across all positions for this underlying.

All fields ending in _METRICS contain 45-element vectors representing scenario analysis across different underlying prices and implied volatilities. The 45 elements are organized as a 5×9 grid:

5 IV Scenarios (rows):

  • MKT: Current market implied volatility
  • IV10: Market IV + 10%
  • IV25: Market IV + 25%
  • IV50: Market IV + 50%
  • IV75: Market IV + 75%

9 Price Move Scenarios (columns):

  • -20%: Underlying down 20%
  • -10%: Underlying down 10%
  • -5%: Underlying down 5%
  • -1%: Underlying down 1%
  • 0%: Current underlying price
  • +1%: Underlying up 1%
  • +5%: Underlying up 5%
  • +10%: Underlying up 10%
  • +20%: Underlying up 20%

Elements are indexed starting at 0. The layout is row-major order (all price moves for first IV scenario, then all price moves for second IV scenario, etc.).

Excel Access: Excel functions ort_security_metric and ort_exposure_metric accept IV and move labels directly rather than numeric indices. See Excel Function Reference for details.

ElementIV ScenarioPrice MoveDescription
0MKT-20%Market IV, underlying down 20%
1MKT-10%Market IV, underlying down 10%
2MKT-5%Market IV, underlying down 5%
3MKT-1%Market IV, underlying down 1%
4MKT0%Market IV, current underlying price
5MKT+1%Market IV, underlying up 1%
6MKT+5%Market IV, underlying up 5%
7MKT+10%Market IV, underlying up 10%
8MKT+20%Market IV, underlying up 20%
9IV10-20%Market IV + 10%, underlying down 20%
10IV10-10%Market IV + 10%, underlying down 10%
11IV10-5%Market IV + 10%, underlying down 5%
12IV10-1%Market IV + 10%, underlying down 1%
13IV100%Market IV + 10%, current underlying price
14IV10+1%Market IV + 10%, underlying up 1%
15IV10+5%Market IV + 10%, underlying up 5%
16IV10+10%Market IV + 10%, underlying up 10%
17IV10+20%Market IV + 10%, underlying up 20%
18IV25-20%Market IV + 25%, underlying down 20%
19IV25-10%Market IV + 25%, underlying down 10%
20IV25-5%Market IV + 25%, underlying down 5%
21IV25-1%Market IV + 25%, underlying down 1%
22IV250%Market IV + 25%, current underlying price
23IV25+1%Market IV + 25%, underlying up 1%
24IV25+5%Market IV + 25%, underlying up 5%
25IV25+10%Market IV + 25%, underlying up 10%
26IV25+20%Market IV + 25%, underlying up 20%
27IV50-20%Market IV + 50%, underlying down 20%
28IV50-10%Market IV + 50%, underlying down 10%
29IV50-5%Market IV + 50%, underlying down 5%
30IV50-1%Market IV + 50%, underlying down 1%
31IV500%Market IV + 50%, current underlying price
32IV50+1%Market IV + 50%, underlying up 1%
33IV50+5%Market IV + 50%, underlying up 5%
34IV50+10%Market IV + 50%, underlying up 10%
35IV50+20%Market IV + 50%, underlying up 20%
36IV75-20%Market IV + 75%, underlying down 20%
37IV75-10%Market IV + 75%, underlying down 10%
38IV75-5%Market IV + 75%, underlying down 5%
39IV75-1%Market IV + 75%, underlying down 1%
40IV750%Market IV + 75%, current underlying price
41IV75+1%Market IV + 75%, underlying up 1%
42IV75+5%Market IV + 75%, underlying up 5%
43IV75+10%Market IV + 75%, underlying up 10%
44IV75+20%Market IV + 75%, underlying up 20%

The following field names support metrics vectors:

  • DELTA_METRICS - Delta at each scenario
  • DELTA_DLRS_METRICS - Dollar delta at each scenario
  • EXTRINSIC_VAL_METRICS - Extrinsic value at each scenario
  • GAMMA_METRICS - Gamma at each scenario
  • GAMMA_DLRS_METRICS - Dollar gamma at each scenario
  • PNL_METRICS - Profit/loss at each scenario
  • PNL_UNREALIZED_METRICS - Unrealized P&L at each scenario
  • THETA_METRICS - Theta at each scenario
  • VALUE_METRICS - Position value at each scenario
  • VEGA_METRICS - Vega at each scenario