IB.reqPnLSingle

Back to ib_async.ib.IB

reqPnLSingle(self, account: str, modelCode: str, conId: int) -> ib_async.objects.PnLSingle

Completeness: fully-documented · Canonical ID: ib_async.ib.IB.reqPnLSingle

Explicit policy override after evidence-backed documentation review.

Related API navigation

• Calls: Client.getReqId
• Calls: Client.reqPnLSingle
• Cancel operation: IB.cancelPnLSingle
• Protocol mapping: EClient.reqPnLSingle
• Response callback: EWrapper.pnlSingle
• Returns: PnLSingle
• Error reference: TWS message codes (applicability is request-dependent).

Sources and provenance

• ib-async-repository-2-1-0 (library-source; retrieved 2026-07-15T03:42:42Z)
• ib-async-repository-2-1-0 (library-source; retrieved 2026-07-15T03:42:42Z)
• ib-async-repository-2-1-0 (library-source; retrieved 2026-07-15T03:42:42Z)
• ibkr-campus-tws-api (official-current; retrieved 2026-07-14T19:13:54.602937Z)
• ibkr-campus-tws-api (official-current; retrieved 2026-07-14T19:13:54.602937Z)

Start a subscription for profit and loss events for single positions.

Returns a .PnLSingle object that is kept live updated. The result can also be queried from .pnlSingle.

https://interactivebrokers.github.io/tws-api/pnl.html

Args: account: Subscribe to this account. modelCode: Filter for this account model. conId: Filter for this contract ID.