A practical guide to public-wallet portfolio tracking in TEMIRIN using configured records, explicit market identity, current controls, and human review.
July 13, 2026 · 4 min read
A useful Polymarket portfolio tracker begins with a precise boundary: one configured public address, one workspace, and a clearly stated observation period. TEMIRIN reads public-wallet data without a private key and stores timestamped snapshots for review. Start by confirming the address and data status, then label every total with its observation time so a later reader knows exactly which public state the page represents.
Keep public-wallet positions, user-entered paper orders, and opportunity price references in separate ledgers. They can point to the same market, but they describe different records and should never be blended into one unexplained balance. This separation makes PnL history easier to reconcile, protects paper-only analysis from being mistaken for wallet activity, and gives exports a stable record type for every row.
Use stable market and outcome identifiers to connect positions across snapshots. Display titles may change, while similarly worded contracts can refer to different dates, thresholds, or resolution rules. Store the market ID, outcome side, position state, available quantity, current value, and source timestamp together. If a record lacks enough identity or valuation context, leave it visibly incomplete instead of assigning it to a convenient market.
Compare snapshots chronologically rather than overwriting the last known state. A new observation can show that a position opened, closed, changed value, or became unavailable through the configured provider. Preserve the earlier snapshot so the history explains what TEMIRIN observed at each point. When a correction is needed, add an attributable note with its author and time rather than rewriting the original public-wallet record.
Use the PnL fields supplied by the stored public-wallet record and state whether a value is realized, unrealized, current, or incomplete. Provider coverage and cost-basis availability can differ by position, so a single precise-looking number may hide missing history. Show the component values and timestamps used in a total, retain an unavailable state where needed, and explain any reconciliation gap in plain language.
Paper-order mark-to-market belongs in the paper ledger. Trigger-to-current price movement belongs with the watchlist-derived opportunity. Public-wallet PnL belongs with the wallet snapshot. Analytics may compare these record types when each series remains labeled, but the comparison should preserve its original assumptions and sample counts. A reviewer should be able to trace every chart value back to the exact stored record that produced it.
Position size alone does not explain portfolio concentration. Group the visible exposure by exact market and category, highlight the largest positions, and keep the public-wallet snapshot time close to the concentration view. When coverage is incomplete, show the limitation before interpreting the percentage. This gives the user a bounded view of what dominates the configured wallet without implying knowledge of other addresses or off-platform activity.
Add current public market context only as a separately timestamped observation. Bid, ask, spread, visible depth, and the latest price can help a reviewer understand why a mark changed, while the preserved trigger price remains attached to the opportunity that first recorded it. If a paper order is created, TEMIRIN checks per-order notional, rolling twenty-four-hour notional, per-market exposure, and portfolio concentration in its own ledger.
Run a consistent review over open positions, closed positions, incomplete rows, and material changes between snapshots. Check market identity, resolution status, observation time, valuation status, concentration, and any linked decision note. Sample several rows back to their source records before trusting an aggregate. The goal is a portfolio history that another authorized workspace member can reproduce from the same stored evidence.
Close the review with a journal note and a bounded export. Include stable record IDs, public-address reference, market and outcome identity, observation time, record type, valuation status, and paper-only labels where relevant. Record exceptions such as stale prices or missing cost basis with an owner for follow-up. Append later findings as new notes so the original portfolio snapshot remains understandable in its historical context.
It displays stored read-only wallet snapshots, positions, recorded PnL context, concentration context, market references, and observation times. Coverage depends on the public records available to the configured connection.
A public snapshot may omit earlier fills, transfers, fees, or enough history to establish full cost basis. TEMIRIN should retain the observed records and mark missing history instead of manufacturing a complete ledger.
The first recorded market price remains the trigger reference. A later synchronized price is displayed with a separate timestamp so the user can distinguish the original opportunity context from the latest stored observation.
Paper orders remain user-created simulations. Their records and mark-to-market context stay separately labeled and are not counted as actual positions, wallet movements, or realized portfolio returns.
