Class Position

A multiplier-aware position tracker with weighted-average-cost PnL.

PnL is computed in the quote asset per token. Robinhood's Chainlink feeds are total-return (already multiplier-adjusted), so comparing average cost per token to the current per-token price is corporate-action correct without re-applying uiMultiplier — a reinvested dividend shows up as a price move, captured in unrealized PnL. The multiplier is used only to report share-equivalent quantity.

Index

Constructors

Properties

Accessors

averageCost quantity realized shareEquivalent

Methods

record snapshot unrealized

Constructors

constructor

new Position(options?: { multiplier?: bigint }): Position
Parameters
- options: { multiplier?: bigint } = {}
Returns Position
- Defined in src/strategy/position.ts:48

Properties

multiplier

multiplier: bigint

1e18-scaled ERC-8056 multiplier for share-equivalent reporting.

Accessors

averageCost

get averageCost(): number
Weighted-average cost per token.

Returns number
- Defined in src/strategy/position.ts:77

quantity

get quantity(): number
Current token quantity.

Returns number
- Defined in src/strategy/position.ts:72

realized

get realized(): number
Realized PnL banked so far.

Returns number
- Defined in src/strategy/position.ts:82

shareEquivalent

get shareEquivalent(): number
Share-equivalent quantity given the current multiplier.

Returns number
- Defined in src/strategy/position.ts:87

Methods

record

record(fill: Fill): void
Apply a fill, updating average cost (buys) or banking realized PnL (sells).
Parameters
- fill: Fill
Returns void
- Defined in src/strategy/position.ts:53

snapshot

snapshot(markPrice: number): PnlSnapshot
Full PnL snapshot at markPrice.
Parameters
- markPrice: number
Returns PnlSnapshot
- Defined in src/strategy/position.ts:97

unrealized

unrealized(markPrice: number): number
Unrealized PnL at markPrice.
Parameters
- markPrice: number
Returns number
- Defined in src/strategy/position.ts:92