A practical guide to public-wallet realized and unrealized PnL context in TEMIRIN using configured records, explicit market identity, current controls, and human review.
August 3, 2026 · 4 min read
Realized and unrealized Polymarket PnL answer different accounting questions. A realized value belongs to a supported closed-position record with dependable proceeds and cost-basis fields. An unrealized value depends on an open position, a declared valuation convention, and a time-stamped market observation. Keeping those categories separate prevents a changing quote from being reported as a completed result and prevents a closed outcome from drifting with later market data.
Write the report definition before calculating totals. State which public address is observed, which position statuses are included, what cutoff time applies, how fees or missing basis are treated, and which fields the provider actually returned. If a row lacks the inputs required by that definition, mark it incomplete. Zero is a valid amount only when the record supports zero; it is not a safe substitute for an unknown cost or unavailable mark.
Begin each reporting run with the configured public-wallet address, provider observation time, market status, and a coverage note. Join each position through stable market and outcome identifiers rather than display titles, because similar questions can describe different contracts and titles can change. Verify whether the market is open, closed, resolved, void, or unavailable before assigning its value to an accounting bucket.
Reconcile a sample of positions against the public venue view and retain the reason for every difference. A provider may omit a transfer, expose an incomplete cost basis, update a resolution state late, or report a position after the visible market page changes. Append the next wallet snapshot rather than rewriting the earlier one. The historical report should continue to reference the exact observation that a reviewer used at the time.
Concentration summaries also need a named denominator. A percentage of visible portfolio value, open notional, or supported cost basis can each be useful, but they are not interchangeable. If part of the public snapshot is incomplete, show the affected denominator and explain the gap. The configured address cannot establish the owner’s full capital, other addresses, external hedges, transfers in flight, or private obligations.
Choose one valuation cutoff and show the observation time beside every open-position mark. The public bid, ask, last price, or another supported field can produce different answers, especially in a thin market. Name the field used and apply the convention consistently within the report. When a quote is stale or unavailable, leave the position unmarked or disclose the fallback; do not manufacture precision from an unrelated market or an earlier screenshot.
The preserved trigger price belongs to the research timeline, not the wallet accounting ledger. It records when a watchlist-derived review record first captured the market. A current price belongs to a later observation, and an open-position mark belongs to the reporting convention. Presenting all three can explain timing, but each label must retain its own timestamp and purpose so a reader can reconstruct the calculation without mistaking research context for cost basis.
A TEMIRIN paper order is a user-entered simulation with its own direction, paper price, notional, and creation time. Later paper mark-to-market movement should use a stated convention and remain separate from public-wallet realized or unrealized totals. The paper record may include per-order, rolling twenty-four-hour, per-market exposure, and portfolio-concentration results, but those checks describe the simulation record rather than an external wallet position.
Workspace policy can explain the conditions surrounding a review without changing wallet accounting. A stake cap, source or category state, maximum-stake override, confidence setting, free-capital percentage, price-move guard, or kill switch belongs beside the relevant decision. Preserve the applicable values and blocked reason there. Do not retroactively blend policy state into historical PnL or imply that a passing paper review changed funds outside TEMIRIN.
Trace one realized row, one unrealized row, one incomplete row, and one paper row from their stored fields through the exported totals. Confirm address, market and outcome IDs, position status, signs, timestamps, valuation convention, category labels, and missing-data treatment. Recalculate the values independently. If a row cannot be rebuilt, leave it unresolved and fix the rule for later reports instead of editing the historical evidence to make the total agree.
Review changes between consecutive snapshots as data events, not automatic explanations. A movement may reflect price, quantity, resolution, provider coverage, or a corrected field. Add an attributable note when the cause is known and preserve uncertainty when it is not. A trustworthy PnL report is valuable because another reviewer can reproduce its scope and limitations, not because it compresses every record into one deceptively clean number.
Realized values describe supported closed-position results, while unrealized values depend on an open position and a time-stamped mark. Each requires its own field definitions and coverage notes.
Keep the affected value incomplete, show the wallet snapshot time, and record why it cannot be reconciled. Do not substitute zero or an estimated basis merely to produce a total.
They should remain separate ledgers. Paper orders are simulated workspace records, while public-wallet values come from read-only external position data with different accounting and coverage rules.
