Start Here
Documentation
Public documentation for the current PolyLab implementation, including scanner usage, upstream data sources, pipeline behavior, and derived metrics.
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.
Documentation
PolyLab is a Polymarket market scanner built around periodic snapshots, derived metrics, and holder-based enrichment. This documentation is intentionally implementation-first: it explains the system that exists today, not a future idealized version.
Start Here
- Getting Started explains the first useful scanner workflow and the quickest way to get signal out of the app.
- How PolyLab Works gives the big-picture flow from Polymarket upstream APIs into the public scanner.
- Workflows covers concrete scanning patterns such as Safe Haven, Sniper / Last Min, Coinflip, and Newsmaker.
Using the Scanner
- Filters and Sorting documents the exact query semantics behind include/exclude tags, expiry windows, price, spread, APR, and smart-money dominance filters.
- Market Details and Holders explains the market row, detail panel, and the YES / NO holder tables.
Understanding the Data
- Core Metrics defines price, implied probability, spread, volume, liquidity, expiration, category, and implied odds.
- APR Methodology documents the exact APR formula used in the code and when the value is intentionally
null. - Smart Money Methodology documents the current counts-based holder logic, the PnL-sign rules, and the known limitations.
- Freshness and Limitations documents refresh cadence, snapshot behavior, and why numbers can diverge from live Polymarket surfaces.
Data Sources
- Markets and Events Source covers the Gamma endpoints, request parameters, and the field enrichment flow.
- Holders and Wallet PnL Source covers the holders and wallet PnL APIs, alias capture, and the current top-holder cap.
Pipeline
- Refresh, Storage, and Snapshots explains the hourly scrape cycle, 6-hour smart-money enrichment, table roles, and snapshot replacement rules.
Reference
- Upstream to PolyLab Field Map maps raw upstream fields to PolyLab storage and display fields.
- Scanner Query and Filter Contract documents the public query parameters and exact semantics behind them.
- Public API Contract documents the public endpoints that the scanner calls today.
- FAQ answers the practical questions users repeatedly ask about data, limitations, and interpretation.
Appendix
- Access Model explains how the public access positioning works today.
- Storage and Runtime Reference documents the SQLite tables, refresh scheduler, and runtime shaping behind the app.