# PolyLab > PolyLab is an independent Polymarket analytics platform, strategy scanner, and data intelligence engine. It scans prediction markets, tracks wallet-level Smart Money positioning, and calculates risk/yield metrics (APR, CLOB spreads, liquidity depth) to help traders and researchers identify edge and market dislocations. - Website: https://www.polylab.app - Documentation: https://www.polylab.app/docs - Live Scanner: https://www.polylab.app/app - Live Markets Markdown Feed: https://www.polylab.app/markets.md - Public API: https://api.polylab.app/api/markets - LLM Full Digest: https://www.polylab.app/llms-full.txt ## Key Concepts & Metrics - **Smart Money Flow & Ratings**: PolyLab samples the top 20 holders per outcome (YES/NO) from Polymarket's on-chain data and analyzes their lifetime realized historical profit/loss (P/L). Wallets with > $0 lifetime P/L are classified as profitable traders. A side is marked dominant when >= 12 of the top 20 holders on that side are historically profitable. - **Annualized Percentage Rate (APR)**: Annualized hold-to-maturity yield calculated as `((1.0 - best_ask) / best_ask) * (365.25 / days_to_resolution) * 100%`. Helps traders compare yield opportunities across prediction markets and fixed-income benchmarks. - **Spread & Liquidity Depth**: Difference between best ask and best bid (`best_ask - best_bid`) on Polymarket's Central Limit Order Book (CLOB), measuring transaction cost, market efficiency, and liquidity slippage. - **Strategy Playbooks**: Pre-configured scanner presets for different risk profiles: - *Safe Haven*: High confidence (>80% probability), tight bid-ask spread (<4%), positive annualized return. - *Smart Money Flow*: Markets where top profitable traders are clustered overwhelmingly on one side. - *Longshot / Asymmetric Alpha*: Low probability (<20%), low price entry with high liquidity and asymmetric upside. - *Yield Farmer*: High APR (>15%) on short-duration markets nearing resolution. ## Documentation Index - [Documentation](https://www.polylab.app/docs): Read the public PolyLab documentation for scanner workflows, data sources, pipeline behavior, and current metric methodology. - [Getting Started](https://www.polylab.app/docs/getting-started): Learn the first useful PolyLab workflow, what the scanner shows, and how to avoid the most common interpretation mistakes. - [How PolyLab Works](https://www.polylab.app/docs/how-polylab-works): Understand the current PolyLab pipeline from upstream market APIs through snapshots, enrichment, derived metrics, and public scanner output. - [Workflows](https://www.polylab.app/docs/workflows): Explore practical PolyLab scanning workflows based on current presets, filters, and sorting behavior in the public app. - [How to Screen Polymarket Markets by Price, Spread, Liquidity, and Expiry](https://www.polylab.app/docs/scanner/filters-and-sorting): The exact filter and sort semantics for screening Polymarket outcomes by price, spread, liquidity, volume, expiry, and smart money counts, including the underlying query parameters. - [Market Details and Holders](https://www.polylab.app/docs/scanner/market-details-and-holders): Understand the current PolyLab market detail surface, holder rows, aliases, and the limits of the YES/NO holder tables. - [AI Chat](https://www.polylab.app/docs/ai-chat): Understand how the current PolyLab AI chat works, including filter mapping, tag selection, market previews, confirmation tokens, and safety boundaries. - [Polymarket Metrics Explained: Price, Spread, Liquidity, and Implied Odds](https://www.polylab.app/docs/metrics/core-metrics): What price, implied probability, implied odds, spread, volume, liquidity, and expiration mean on Polymarket, and which values are raw upstream fields versus locally derived ones. - [How to Calculate APR on a Polymarket Position](https://www.polylab.app/docs/methodology/apr): The exact formula for annualized return on a Polymarket outcome, when APR cannot be computed, and why short-dated markets show misleadingly large numbers. - [How to Track Smart Money Wallets on Polymarket](https://www.polylab.app/docs/methodology/smart-money): How wallet-level smart money tracking on Polymarket actually works, the exact profit-and-loss counting rules PolyLab applies, and the sampling limits that constrain what the counts can tell you. - [How Often Polymarket Market and Smart Money Data Refreshes](https://www.polylab.app/docs/data/freshness-and-limitations): How current Polymarket data in PolyLab actually is, why a scanner snapshot can differ from the live Polymarket interface, and when those gaps are largest. - [Markets and Events Source](https://www.polylab.app/docs/sources/markets-and-events): Learn how PolyLab uses the Gamma markets and events APIs, which parameters it sends, and how upstream fields become scanner rows. - [Holders and Wallet PnL Source](https://www.polylab.app/docs/sources/holders-and-wallet-pnl): Learn how PolyLab fetches holders and wallet PnL, how aliases are captured, and why the current smart-money sample is intentionally limited. - [Refresh, Storage, and Snapshots](https://www.polylab.app/docs/pipeline/refresh-storage-and-snapshots): Understand the PolyLab refresh scheduler, storage tables, snapshot replacement process, and smart-money enrichment cadence. - [Upstream to PolyLab Field Map](https://www.polylab.app/docs/reference/upstream-field-map): Use this reference to map upstream Polymarket fields into the PolyLab database and scanner display fields. - [Scanner Query and Filter Contract](https://www.polylab.app/docs/reference/scanner-query-contract): Read the exact current query contract for the PolyLab scanner API, including filters, sorting, and smart-money count parameters. - [Polymarket Data API: Public Endpoints and Response Fields](https://www.polylab.app/docs/reference/public-api-contract): JSON endpoints for Polymarket market, tag, and holder data, with the response fields each one returns and the query contract they follow. - [FAQ](https://www.polylab.app/docs/faq): Read practical FAQ answers about PolyLab data freshness, methodology, smart-money interpretation, and scanner limitations. - [Access Model](https://www.polylab.app/docs/appendix/access-model): Read the public PolyLab access-model notes and how they relate to the scanner and documentation surface. - [Storage and Runtime Reference](https://www.polylab.app/docs/appendix/storage-and-runtime): Read the appendix reference for current PolyLab runtime jobs, storage tables, and snapshot assembly details. ## Public API Endpoints - `GET https://api.polylab.app/api/markets`: Query active Polymarket prediction markets with filtering by price, spread, APR, liquidity, and smart money. - `GET https://api.polylab.app/api/markets/{id}/holders`: Get top YES/NO holders with PnL statistics for a specific market. - `GET https://api.polylab.app/api/tags`: List all active category tags and their associated market counts. - `GET https://api.polylab.app/api/status`: Check service status and the timestamp of the latest data snapshot. ## Extended LLM Context - [Full Documentation & Methodology Digest](https://www.polylab.app/llms-full.txt): Comprehensive concatenated technical documentation and methodology for deep context ingestion.