PolyLab PolyLab Docs Independent analyzer for Polymarket
Using the Scanner

Market Details and Holders

Last updated 2026-03-10

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

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.