PolyLab PolyLab Docs Independent analyzer for Polymarket
Documentation is in progress. Every page in this section describes the current implementation and may change as PolyLab evolves.
Using the Scanner

Market Details and Holders

In Progress Last updated 2026-03-10

How to read the current market row and detail view, including holder tables, aliases, and PnL-sign counts.

Current Implementation

This page is intentionally explicit and implementation-first. If the product or upstream APIs change, the current behavior described here can change with them.

Market row

Each scanner row is an outcome-level record, not a market-level aggregate. That row includes:

  • market question
  • outcome name
  • current price
  • spread
  • APR
  • volume
  • liquidity
  • expiration
  • category

When you sort by price, spread, APR, volume, or liquidity, you are sorting outcome rows directly.

Detail panel

The detail panel is where the raw identifiers become useful:

  • market_id
  • condition_id
  • Polymarket url
  • event_slug
  • category
  • start and end dates
  • implied odds

The detail panel is the right place to verify whether you are looking at the correct event and the correct side.

Holder tables

The public holder endpoint returns a list of holder rows for a specific condition:

  • wallet_address
  • position_size
  • outcome_index
  • total_pnl
  • alias
  • wallet_tag

The frontend groups those rows into YES and NO views by outcome_index.

What aliases mean

Aliases come from the holders API payload when present. They are not guaranteed to exist, and an empty alias should be treated as missing metadata rather than a negative signal.

What wallet_tag means

PolyLab currently recognizes a known system / rewards wallet and marks it with wallet_tag = SYSTEM. That label is operational metadata, not a claim that every system-tagged wallet is informative for trading decisions.

What holder counts do and do not mean

What they mean

Counts such as yes_profitable_count or no_losing_count are simple descriptive counts over the sampled holder rows joined with wallet PnL signs.

What they do not mean

  • They do not show every holder in the market.
  • They do not prove intent.
  • They do not measure position age.
  • They do not know whether a wallet hedged elsewhere.
  • They do not tell you whether a profitable wallet is profitable because of this market.

Known display limits

  • Holders are sampled from the current holders endpoint, not reconstructed from complete trading history.
  • Current holder fetching is capped to top holders per outcome; see Holders and Wallet PnL Source.
  • Large position size and positive tracked PnL are different concepts and should not be merged in your interpretation.