01 · Overview
What is polymarket-pnl?
polymarket-pnl is an open-source local CLI that aggregates Polymarket-reported PnL and position values into wallet summaries, category breakdowns and CSV/JSON exports. It is not an independent reconstruction of every transfer and fee. Source completeness and upstream accounting definitions constrain the results; it does not execute trades or produce an official financial statement.
Reconcile wallet activity with two public fills and their on-chain receipts
02 · Best for
Who is polymarket-pnl best for?
Best for
Developers and analysts who want a local, scriptable wallet report.
Not ideal for
Users who need a hosted dashboard, execution or an official financial statement.
Venue-reported aggregation, not an independently reconstructed full ledger. Fee, reward and history coverage remain source-dependent.
03 · Access & execution
How do access and execution work?
Scope-aware product facts
What to look for
Surfaces
Access modes
Execution modes
Pricing offers
Data capabilities
04 · Data provenance
Data provenance
Current coverage: PartialA transparent record of which official sources were checked and when.
05 · Public footprint
Public footprint
Current public signals from official platform sources, shown with their observation dates.
A transparent record of which official sources were checked and when.
06 · Sources & review
How was polymarket-pnl reviewed?
Documentation strength: PartialA transparent record of which official sources were checked and when.
Official product sources were checked for documented identity, scope, access, pricing and limitations. This is not a security audit, performance test or endorsement.


