IB.reqPnL

Back to ib_async.ib.IB

reqPnL(self, account: str, modelCode: str = '') -> ib_async.objects.PnL

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

Explicit policy override after evidence-backed documentation review.

Related API navigation

• Calls: Client.getReqId
• Calls: Client.reqPnL
• Cancel operation: IB.cancelPnL
• Protocol mapping: EClient.reqPnL
• Response callback: EWrapper.pnl
• Returns: PnL
• 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)

Start a subscription for profit and loss events.

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

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

Args: account: Subscribe to this account. modelCode: If specified, filter for this account model.